Guías

Una guía es el componente básico de los agentes generativos. Por lo general, un agente generativo tiene muchas guías, en las que cada una se define para administrar 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 guiones no admiten el envío de un SMS de acompañante de llamadas desde la ruta del intent de bienvenida predeterminado 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 idiomas. Los idiomas marcados para los playbooks se probaron en cuanto a calidad con los modelos gemini-2.0-flash y gemini-1.5-flash-002.

Cuando uses idiomas distintos del inglés, debes definir tus ejemplos en el idioma de destino y dejar las instrucciones en inglés. En el caso de ciertos idiomas y casos de uso, es posible que obtengas respuestas ligeramente mejores si también proporcionas instrucciones 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 configuración del agente de la consola de agentes conversacionales -> IA generativa -> Playbook, 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 un playbook.
  • Especifica el nombre del modelo en el campo DetectIntentRequest.query_params.llm_model_settings.model si estás probando el agente a través de la API (consulta DetectIntentRequest).

Nombre del modelo	Especificación del modelo	Etapa de lanzamiento
gemini-2.0-flash-001	Gemini 2.0 Flash	DG
gemini-2.0-flash-lite-001	Gemini 2.0 Flash Lite	Versión preliminar pública
gemini-2.5-flash	Gemini 2.5 Flash	Versión preliminar pública
gemini-1.5-flash-001	Gemini 1.5 Flash	Heredada
gemini-1.5-flash-002	Gemini 1.5 Flash	Heredada

Compatibilidad con regiones

Las guías se admiten en 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

Un manual 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: Descripción general de lo que debe lograr la guía
• Instrucciones: Define los pasos del proceso que se deben seguir para lograr el objetivo.
• Ejemplos: Son ejemplos de conversaciones que son instrucciones con pocos 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.

Tipos de guías

Cuando creas una guía, seleccionas 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. 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 un manual de tareas (llamador) que llama a otro manual de tareas (llamado):

1. La persona que llama inicia la llamada.
2. El llamador proporciona los parámetros de entrada necesarios al llamado.
3. El receptor procesa esta información, realiza su función designada y devuelve parámetros de salida.
4. La entidad que llama recibe parámetros de la entidad llamada.

Cualquier guía de rutinas o tareas puede llamar a otra guía de tareas, pero una guía de tareas no puede llamar a otra guía de rutinas.

Guías de rutina

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

A continuación, se muestra un manual de estrategias de rutina (A), la transición a otro manual de estrategias de rutina (B) y la transición a un flujo (C):

1. El guion de la 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 hace la transición a la guía de rutinas B.
3. El guion de la rutina B puede leer los parámetros de sesión cuando se inicia y escribir parámetros de sesión justo antes de salir.
4. La rutina B sale y realiza la transición al flujo C.
5. El flujo C puede leer y escribir parámetros de sesión.

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

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

• Cuando se ingresa un guion 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 finaliza una rutina, genera valores para sus parámetros de salida y los asigna a los parámetros de sesión con el mismo nombre.

Guía predeterminada

Cuando creas un agente generativo con la consola de Conversational Agents, 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:

• El playbook predeterminado 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, sigue estos pasos:

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 del manual.

Usa la generación por 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.

Importa y exporta guías

Una vez que hayas creado los playbooks con la consola de agentes conversacionales, puedes exportarlos para usarlos en otro agente. Para exportar una guía, sigue estos pasos:

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

Para importar una guía que exportaste anteriormente, sigue estos pasos:

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.