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 para garantizar que tenga la información que necesita 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 guiones no admiten el envío de un SMS de acompañante de llamadas desde la ruta de intención de bienvenida predeterminada en el flujo de inicio predeterminado, pero puedes habilitar la opción de SMS de acompañante de llamadas en los flujos estándar.
- Los Playbooks no admiten la entrada de DTMF desde sistemas telefónicos.
Idiomas admitidos
Consulta la columna Playbooks en la referencia de idioma.
Los idiomas marcados para los playbooks se probaron para garantizar su calidad con los modelos gemini-2.5-flash.
Cuando uses idiomas distintos del inglés, ten en cuenta lo siguiente:
- En la mayoría de los casos, usa inglés para las instrucciones del manual. En ciertos idiomas y casos de uso, puedes obtener respuestas ligeramente mejores si también proporcionas instrucciones en el idioma de destino.
- Declara tu compatibilidad con el idioma en las instrucciones del manual, 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 el playbook en los siguientes lugares:
Selecciona el modelo de LLM a nivel del agente.
- En la consola de Agentes conversacionales, selecciona un modelo por su nombre visible en la lista de modelos disponibles en Configuración del agente -> IA generativa -> Playbook.
- 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 Conversational Agents, selecciona un modelo por su nombre visible en la lista cuando pruebes un playbook.
- Especifica el nombre del modelo en el campo DetectIntentRequest.query_params.llm_model_settings.model si estás probando el agente con la API (consulta DetectIntentRequest).
| Nombre del modelo | Especificaciones del modelo | Etapa de lanzamiento |
|---|---|---|
| gemini-2.5-flash | Gemini 2.5 Flash | DG |
| gemini-2.5-flash-lite | Gemini 2.5 Flash Lite | DG |
| gemini-3.1-flash-lite | Gemini 3.1 Flash Lite | DG |
Compatibilidad con regiones
Las guías se admiten en las siguientes regiones:
globalasia-south1asia-southeast1asia-southeast2asia-northeast1australia-southeast1eu(multirregión)europe-west1europe-west2europe-west3europe-west4europe-west6northamerica-northeast1us(multirregión)us-central1us-east1us-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: Son los pasos del proceso que el agente debe seguir para lograr el objetivo.
- Ejemplos: Son conversaciones de ejemplo que son ejemplos de instrucciones con varios ejemplos eficaces para el LLM.
- Parámetros: Son variables que almacenan información sobre una conversación, como la entrada del usuario, la información del sistema del usuario y los resultados de las acciones.
Instrucción para el LLM
En cada turno de conversación, Dialogflow CX usa los datos de la guía de tiempo de diseño y los datos de conversación del tiempo de ejecución para crear una instrucción de 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 son 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, debes seleccionar el tipo de guía que deseas: guía de tareas o guía de rutinas.
Guías de tareas
Las guías de tareas son el tipo original de guía. Puedes usarlos para desglosar tareas complejas en subtareas más pequeñas y reutilizables, y modelar etapas de conversación compositivas, en las que cada etapa se comunica a través de parámetros de entrada y salida.
Una guía de tarea (llamador) llama a otra guía de tarea (destinatario):
- El llamador inicia al destinatario.
- El llamador proporciona los parámetros de entrada necesarios al llamado.
- El receptor procesa esta información, realiza su función designada y devuelve parámetros de salida.
- La entidad que llama recibe parámetros de la entidad llamada.
Cualquier guía de rutina o de 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.
En la siguiente imagen, se muestra una guía de rutina (A) que pasa a otra guía de rutina (B) y, luego, a un flujo (C):
- 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.
- La guía de rutina A sale y realiza la transición a la guía de rutina B.
- La guía de rutina B puede leer los parámetros de sesión cuando se inicia y escribir parámetros de sesión justo antes de salir.
- La guía de rutina B sale y pasa al flujo C.
- El flujo C puede leer y escribir parámetros de sesión.
Si un libro de jugadas de rutina no pasa a otro libro de jugadas o flujo de rutina, la sesión vuelve al último flujo activo o finaliza si no hay ninguno.
Las guías de rutina tienen el siguiente comportamiento de administración de parámetros:
- Cuando se ingresa a una guía de rutina, sus parámetros de entrada reciben valores equivalentes a los parámetros de sesión con el mismo nombre.
- Cuando una guía de rutina finaliza, genera valores para sus parámetros de salida y los asigna a los parámetros de sesión con el mismo nombre.
Comparación de los tipos de guías
| Categoría | Guía de tareas | Guía de rutina |
|---|---|---|
| Latencia | Cada vez que una guía de tareas llama a otra guía de tareas, se realiza una llamada al LLM. En el caso de una cadena larga de guiones de tareas en un turno conversacional, esto puede aumentar la latencia. | Cada rutina de la serie de transiciones se produce en 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 tareas llama a otra guía de tareas, se deben volver a generar los valores de los parámetros. Si hay una cadena larga de manuales de tareas, esta regeneración puede provocar una 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 tareas no interactúan bien con los parámetros de sesión y, en cambio, requieren que se definan 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 tareas tiene una relación principal/secundaria 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, Dialogflow 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
Sigue estos pasos para crear una guía:
- Selecciona el ícono de la guía en el menú de navegación de la consola.
- Haz clic en el botón Create (Crear).
- Selecciona el tipo de guía Rutina o Tarea.
- Proporciona datos de la guía.
Usa la generación por IA para crear una guía
Cuando creas una guía, se abre un panel de IA generativa. Esto te permite generar datos de la guía.
Importa y exporta guías
Después de crear guías con la consola de Agentes conversacionales, puedes exportarlas para usarlas en otro agente.
Para exportar una guía, sigue estos pasos:
- Ve a la lista de guías.
- Haz clic en el botón de exportación del manual que quieras exportar.
- Selecciona las opciones de exportación.
- Haz clic en Exportar.
Para importar una guía que exportaste anteriormente, sigue estos pasos:
- Ve a la lista de guías.
- Haz clic en Importar.
- Selecciona las opciones de importación.
- Haz clic en Importar.