Guías

Nota: La función Guía se excluye del ANS de Dialogflow CX.

Una guía es el componente básico de los agentes generativos. Por lo general, un agente generativo tiene muchas guías, y cada una se define para realizar tareas específicas. Los datos de las guías se proporcionan al LLM, por lo que tienen la información que necesitan para responder preguntas y ejecutar tareas. Cada guía puede proporcionar información, enviar consultas a servicios externos, o diferir el procesamiento de la conversación a un flujo o a otra guía para procesar subtareas.

Limitaciones

Se aplica la siguiente limitación:

• Los agentes que usan guías no admiten el envío de un SMS complementario de llamada desde la ruta del intent de bienvenida predeterminado en el flujo de inicio predeterminado, pero puedes habilitar la opción de SMS complementario de llamada en flujos estándar.
• Las guías no admiten la entrada de DTMF de sistemas telefónicos.

Idiomas admitidos

Consulta la columna Guías en la referencia de idiomas. Los idiomas marcados para las guías se probaron para garantizar la calidad con los modelos gemini-2.0-flash.

Cuando usas idiomas distintos del inglés, haz lo siguiente:

• En la mayoría de los casos, usa inglés para las instrucciones de la guía. Para ciertos idiomas y casos de uso, es posible que obtengas respuestas un poco mejores si también proporcionas instrucciones en el idioma de destino.
• Declara la compatibilidad con el idioma en las instrucciones de la guía. Por ejemplo: "Siempre responde en francés".
• Define tus ejemplos en el idioma de destino.

Compatibilidad con modelos

Puedes seleccionar el modelo de LLM que se usa en la guía en los siguientes lugares:

• Selecciona el modelo de LLM a nivel del agente.

  • En la consola de agentes conversacionales en Configuración del agente -> IA generativa -> Guía, selecciona el modelo por nombre visible en el menú desplegable de todos los modelos disponibles.
  • Especifica el nombre del modelo en el campo GenerativeSettings.llm_model_settings.model si usas la API para actualizar la configuración del agente (consulta GenerativeSettings).

• Anula la selección del modelo a nivel de la solicitud.

  • En el simulador de la consola de agentes conversacionales, selecciona el modelo por nombre visible en el menú desplegable cuando pruebes una guía.
  • Especifica el nombre del modelo en el campo DetectIntentRequest.query_params.llm_model_settings.model si pruebas el agente a través de la API (consulta DetectIntentRequest).

Nombre del modelo	Especificación del modelo	Etapa de lanzamiento
gemini-2.5-flash	Gemini 2.5 flash	GA
gemini-2.5-flash-lite	Gemini 2.5 flash lite	GA
gemini-2.0-flash-001	Gemini 2.0 flash	GA
gemini-2.0-flash-lite-001	Gemini 2.0 flash lite	GA

Compatibilidad con regiones

Las guías son compatibles con las siguientes regiones:

• global
• asia-south1
• asia-southeast1
• asia-southeast2
• asia-northeast1
• australia-southeast1
• eu (multirregión)
• europe-west1
• europe-west2
• europe-west3
• europe-west4
• europe-west6
• northamerica-northeast1
• us (multirregión)
• us-central1
• us-east1
• us-west1

Datos de la guía

Una guía se compone de los siguientes datos:

• Nombre de la guía: Un nombre conciso en lenguaje natural que ayuda a los desarrolladores y al LLM a comprender qué tareas maneja la guía.
• Objetivos: Una descripción general de lo que debería lograr la guía.
• Instrucciones: Define los pasos del proceso que se deben seguir para lograr el objetivo.
• Ejemplos: conversaciones de ejemplo que son ejemplos de instrucciones con varios ejemplos eficaces para el LLM.
• Parámetros: Se usan para almacenar información sobre una conversación, como la entrada del usuario, la información del sistema del usuario, los resultados de las acciones, etcétera.

Instrucción para el LLM

Para cada turno conversacional, Dialogflow CX usa los datos de la guía en tiempo de diseño y los datos de conversación en tiempo de ejecución para crear una instrucción para el LLM dentro de los límites de tokens. El contenido de esta instrucción se resume de la siguiente manera, en la que los encabezados tienen fines ilustrativos y no necesariamente forman parte de la instrucción.

# INTERNAL_SYSTEM_PROMPT
<you cannot see or edit this>

# INTERNAL_SYSTEM_EXAMPLES
<you cannot see or edit this>

# AVAILABLE_TOOLS_TO_CURRENT_PLAYBOOK
<tool names and schemas, for example...>

## Tool: my_datastore
   description: blah
   input: blah
   output: blah

## Tool: some_other_custom_tool
   description: blah
   input: blah
   output: blah

# PLAYBOOK
<verbatim Goal and Instructions that you provide in the console>

# PLAYBOOK_EXAMPLES
<as many Examples for the current Playbook as can fit in the prompt>

## Example 1

## Example 2
..
..
..
## Example N (up to the input token limit)

# CURRENT_CONVERSATION
<the conversation up to this point w/ some caveats...>

* Caveat 1: If there was a transition from Playbook A -> Playbook B, the
  Conversation that happened in Playbook A is summarized and provided as context
* Caveat 2: If there was a transition from Flow A -> Playbook A, the
  Conversation that happened prior to the entry of Playbook A is summarized and
  provided to the Playbook

Tipos de guías

Cuando creas una guía, seleccionas el tipo de guía que deseas: guía de tarea o guía de rutina.

Guías de tarea

Las guías de tarea son el tipo de guía original. Se usan para desglosar tareas complejas en subtareas más pequeñas y reutilizables. Se usan para modelar etapas de conversación compositivas , en las que cada etapa se comunica a través de parámetros de entrada y salida.

A continuación, se muestra una guía de tarea (llamador) que llama a otra guía de tarea (destinatario):

1. El llamador inicia el destinatario.
2. El llamador proporciona los parámetros de entrada necesarios al destinatario.
3. El destinatario procesa esta información, realiza su función designada y muestra parámetros de salida.
4. El llamador recibe parámetros del destinatario.

Cualquier guía de rutina o tarea puede llamar a otra guía de tarea, pero una guía de tarea no puede llamar a otra guía de rutina.

Guías de rutina

Las guías de rutina son un nuevo tipo de guía. Se usan para modelar etapas de conversación secuenciales , en las que cada etapa está completa y es independiente. Pueden llamar a guías de tarea para descomponer tareas más grandes en subtareas más pequeñas y pueden hacer la transición a otros flujos o guías de rutina.

A continuación, se muestra una guía de rutina (A) que pasa a otra guía de rutina (B) y, luego, a un flujo (C):

1. La guía de rutina A puede leer parámetros de sesión cuando se inicia y escribir parámetros de sesión justo antes de salir.
2. La guía de rutina A sale y pasa a la guía de rutina B.
3. La guía de rutina B puede leer parámetros de sesión cuando se inicia y escribir parámetros de sesión justo antes de salir.
4. La guía de rutina B sale y pasa al flujo C.
5. El flujo C puede leer y escribir parámetros de sesión.

Si una guía de rutina no pasa a otra guía de rutina o flujo, la sesión volverá al último flujo activo o finalizará si no hay uno.

Las guías de rutina tienen el siguiente comportamiento de administración de parámetros:

• Cuando se ingresa una guía de rutina, sus parámetros de entrada se asignan a valores que son equivalentes a los parámetros de sesión con el mismo nombre.
• Cuando una guía de rutina sale, genera valores para sus parámetros de salida y los asigna a parámetros de sesión con el mismo nombre.

Comparar tipos de guías

Categoría	Guía de tarea	Guía de rutina
Latencia	Cada vez que una guía de tarea llama a otra guía de tarea, hay una llamada al LLM. Para una cadena larga de guías de tarea en un turno conversacional, esto puede aumentar la latencia.	Cada guía de rutina en una serie de transiciones ocurre dentro de un solo turno conversacional, por lo que solo hay una llamada al LLM y una latencia mejorada.
Regeneración de parámetros	Cuando una guía de tarea llama a otra guía de tarea, se deben regenerar los valores de los parámetros. Si hay una cadena larga de guías de tarea, esta regeneración puede provocar la pérdida de contexto.	Las guías de rutina usan el almacenamiento de sesión para los parámetros, lo que crea un contexto más confiable.
Integración de parámetros de sesión	Las guías de tarea no interactúan bien con los parámetros de sesión y, en cambio, requieren que se definan los parámetros de entrada y de devolución.	Las guías de rutina interactúan bien con los parámetros de sesión.
Reutilización	Dado que cada guía de tarea tiene una relación superior/secundario fija, las tareas están estrechamente vinculadas.	Las guías de rutina se pueden definir de forma independiente entre sí.

Guía predeterminada

Cuando creas un agente generativo con la consola de agentes conversacionales, se crea automáticamente una guía generativa predeterminada.

La guía predeterminada es el punto de partida de las conversaciones, por lo que tiene algunas distinciones importantes con respecto a otras guías:

• La guía predeterminada no recibe un resumen de los turnos de conversación anteriores.
• La guía predeterminada no puede definir ni recibir parámetros de entrada.

Crear una guía

Para crear una guía, haz lo siguiente:

1. Haz clic en el ícono de la guía en la navegación de la izquierda de la consola.
2. Haz clic en el botón Crear nuevo.
3. Selecciona el tipo de guía Rutina o Tarea.
4. Proporciona datos de la guía.

Usa la generación de IA para crear una guía

Cuando creas una guía, se abre un panel de IA generativa. Puedes usarlo para generar datos de la guía.

Importar y exportar guías

Una vez que hayas creado guías con la consola de agentes conversacionales, podrás exportarlas para usarlas en otro agente. Para exportar una guía, haz lo siguiente:

1. Navega a la lista de guías.
2. Haz clic en el botón de exportación de la guía que deseas exportar.
3. Selecciona las opciones de exportación.
4. Haz clic en Exportar.

Para importar una guía que exportaste anteriormente, haz lo siguiente:

1. Navega a la lista de guías.
2. Haz clic en Importar.
3. Selecciona las opciones de importación.
4. Haz clic en Importar.