This is the multi-page printable view of this section.
Click here to print.
Return to the regular view of this page.
TV LLM Conversational None UC
TV LLM Conversational None UC
Global Use Case developed by Aura Platform Team that informs users of the platform’s available actions, ensuring correct invocation for proper system understanding.
Introduction
The video LLM Conversational None use case is a global experience designed and developed by Aura Global Team that provides Telefónica customers guidance on gaining knowledge of available platform actions and how to perform them correctly.
Find additional information in the following documents:
Specifications
Request-response model
The TV LLM Conversational None UC is adapted to both request-response V1 and to its normalized model V3.
Available channels
The TV LLM Conversational None UC can be enabled in any channel in both v1 and v3 and TV-related payloads.
Use case development
The TV LLM Conversational None UC includes the following components:
Understanding features
- Intent:
intent.conversational.none
Use case logic
Once Aura recognizes the user’s utterance, the UC is resolved via:
1 - Dialog configuration
Configuration of the generic-ai-dialog for TV LLM Conversational None UC
How the generic-ai-dialog must be configured for this use case
Specific configuration
The TV LLM Conversational None UC is triggered by the generic-ai-dialog-v1 for channelData v1 or generic-ai-dialog-v3 for channelData v3.
For this use case, the required specific configuration is set below:
Example v1:
{
"name": "generic-ai",
"dialogs": [
{
"id": "generic-ai-dialog-v1",
"onlyIn": [
"set-top-box"
],
"triggerConditions": [
{
"intent": "intent.conversational.none",
"settings": {
"locales": {
"error": [
"tv.error.fpaOrCognitive"
]
}
}
}
]
}
]
}
Example v3:
{
"channelDataVersion": "v3",
"id": "generic-ai-dialog-v3",
"onlyIn": [
"set-top-box",
"global-video-platform"
],
"triggerConditions": [
{
"intent": "intent.conversational.none",
"settings": {
"locales": {
"error": [
"core:flc.answer.error"
]
}
}
}
]
}
2 - AI configuration by OB
AI configuration by OB
The following information applies to both Spain and Brazil; there will not be separate blocks for each OB.
Introduction
LLMs UCs are configured and located within the aura-config-provision repository. See the TV LLM Conversational None Preset (notice that in the url, the field [ob] needs to be replaced by [es] or [br])
LLM use cases have been designed to provide a fallback mechanism for user requests that are not currently understood, i.e. return a ‘None’ intent, or when no content is found in the video platform related to it, offering a second chance for classification and response generation.
Intent
The Conversational None Use Case has different invocation points:
- From triage: when the LLM fails to map the user’s input to any known intent often due to ambiguous, incomplete or broad queries (“Uno hacia abajo”, “Sintoniza el canal”, “Cambia cómo suena”).
- From failures or KOs occurring in other supported use cases.
Once the user’s input is classified as intent.conversational.none, the request is routed to the Conversational None Agent, an LLM-based conversational module designed to handle unclassified or unsupported queries with the goal of guiding the user toward valid flows or supported actions within the platform by suggesting possible next steps or rephrasing options.
The conversation is considered complete once the LLM returns a response to the user. Subsequent user inputs will be reprocessed through the full recognition pipeline, including both deterministic and LLM-based intent classifiers.
In the output format, the LLM returns a structured JSON response based on predefined Use Cases configured within the field use_cases in the preset (in args). These Use Cases follow a structured format that includes three fields separated by a pipe (|):
- NAME (mandatory): The name of the Use Case.
- DESCRIPTION (optional): A short explanation or instruction. This field may be empty.
- EXAMPLE (mandatory): A representative user utterance for that Use Case.
Sample extract from use case information:
| NAME |
DESCRIPTION |
EXAMPLE |
| abrir una sección |
Para abrir una sección es necesario mencionar el nombre de la sección que deseas consultar. Algunas son: Deportes, Cine o Series. |
Abrir la sección Deportes |
| Desativar o som |
|
Silencie a TV |
Based on this information and according to matching criteria with the user’s request, the LLM constructs its output response by returning two fields:
- “speak”: intended for voice output to be spoken by the system.
- “text”: displayed on screen as visual feedback within the Video Platform interface.
The content of these fields varies depending on the type of match between user’s input and the predefined Use Cases:
- Single Use Case Match:
- If the Use Case has a description:
- “speak”: this field references the name of the Use Case related to the request, describes its invocation process and includes a relevant example.
- “text”: this field mirrors the example used in “speak”.
- If the Use Case has no description:
- “speak”: this field mentions the name of the Use Case linked to the request and the corresponding example.
- “text”: this field mirrors the example used in “speak”.
- Multiple Use Cases Match:
- “speak”: this field mentions the ambiguity and shows two likely Use Cases with examples.
- “text”: this field includes the same two examples.
- No match:
- “speak”: this field explains the uncertainty and suggests two random valid Use Cases with examples.
- “text”: this field repeats only the examples pertaining to the Use Cases shown in “speak”.
This conditional behavior ensures that the assistant gives relevant, helpful responses tailored to the context of the user’s request.
Examples in Castilian Spanish:
| Type of match |
Input |
Output |
| “Single Use Case no description” |
“Pon la peli desde el principio” |
{{"name": "llm_conversational_none", "arguments": {{ "speak": "Parece que quieres poner un contenido desde el principio. Por ejemplo, prueba a decir Pon Titanic desde el principio.", "text": "Pon Titanic desde el principio"}}}} |
| “Single Use Case with description” |
“Pon cualquier canal” |
{{"name": "llm_conversational_none", "arguments": {{ "speak": "Parece que quieres cambiar de canal. Para cambiar de canal es necesario mencionar el nombre del canal que quieres sintonizar o indicar el número de dial asociado a ese canal. Por ejemplo, prueba a decir Pon el canal Antena 3.", "text": "Pon el canal Antena 3"}}}} |
| “Multiple Use Cases” |
“Volumen” |
{{"name": "llm_conversational_none", "arguments": {{ "speak": "Creo que quieres ejecutar alguna acción relacionada con el volumen. Podría ser bajar el volumen o subir el volumen. Por ejemplo, prueba a decir Baja un poco el volumen o Sube un poco el volumen", "text": "Baja un poco el volumen, Sube un poco el volumen"}}}} |
| “No match” |
“Cántame una canción” |
{{"name": "llm_conversational_none", "arguments": {{ "speak": "No tengo claro a qué te refieres pero sí que puedo cambiar de canal o abrir una sección. Por ejemplo, prueba a decir Pon el canal Antena 3 o Abrir la sección Deportes", "text": "Pon el canal Antena 3, Abrir la sección Deportes"}}}} |
Examples in Brazilian Portuguese:
| Type of match |
Input |
Output |
| “Single Use Case no description” |
“Coloque o filme desde o começo” |
{{"name": "llm_conversational_none", "arguments": {{ "speak": "Parece que você quer colocar um conteúdo desde o começo. Por exemplo, tente dizer Começar desde o início.", "text": "Começar desde o início"}}}} |
| “Single Use Case with description” |
“Coloque qualquer canal |
{{"name": "llm_conversational_none", "arguments": {{ "speak": "Parece que você quer mudar de canal. Para mudar de canal é necessário mencionar o nome do canal que deseja sintonizar. Por exemplo, tente dizer Mudar para o SBT.", "text": "Mudar para o SBT"}}}} |
| “Multiple Use Cases” |
“Volume” |
{{"name": "llm_conversational_none", "arguments": {{ "speak": "Creo que você quer executar alguma ação relacionada ao volume. Pode ser abaixar o volume ou subir o volume. Por exemplo, tente dizer Abaixe o volume ou Suba o volume", "text": "Abaixe o volume, Suba o volume"}}}} |
| “No match” |
“Canta-me uma canção” |
{{"name": "llm_conversational_none", "arguments": {{ "speak": "Não tenho certeza do que você está se referindo mas eu posso mudar de canal ou abrir uma seção. Por exemplo, tente dizer Mudar para o SBT ou Abra Filmes", "text": "Mudar para o SBT, Abra Filmes"}}}} |