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 tiene 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 libros de jugadas no admiten el envío de un SMS de compañero de llamada desde la ruta del intent de bienvenida predeterminado en el flujo de inicio predeterminado, pero puedes habilitar la opción de SMS de compañero de llamada en los flujos estándar.
Idiomas admitidos
Los playbooks admiten los mismos idiomas que los modelos de Gemini.
Compatibilidad con regiones
Las guías se admiten en las siguientes regiones:
globalasia-south1asia-southeast1asia-northeast1australia-southeast1eu(multirregión)europe-west1europe-west2europe-west3northamerica-northeast1us(multirregión)us-central1us-east1us-west1
Datos de la guía
Un playbook se compone de los siguientes datos:
- Nombre de la guía: Es un nombre conciso en lenguaje natural que ayuda a los desarrolladores y al LLM a comprender qué tareas controla la guía.
- Objetivos: descripción general de lo que debe lograr la guía
- Instrucciones: Definen los pasos del proceso que se deben seguir para lograr el objetivo.
- Ejemplos: Convocatorias de muestra que son ejemplos de instrucciones de pocas tomas 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, debes seleccionar el tipo 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 composicionales, en las que cada etapa se comunica a través de parámetros de entrada y salida.
A continuación, se muestra un libro de jugadas de tareas (llamante) que llama a otro libro de jugadas de tareas (llamado):
- El emisor inicia el llamado.
- El llamador proporciona los parámetros de entrada necesarios al llamado.
- El llamador procesa esta información, realiza su función designada y muestra los parámetros de salida.
- El llamador recibe parámetros del llamado.
Cualquier guía de tareas o rutinas 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 rutinas
Las guías de rutinas son un nuevo tipo de guía. Se usan para modelar las etapas de conversación secuenciales, en las que cada etapa es completa e independiente. Pueden llamar a las guías de tareas para descomponer tareas más grandes en subtareas más pequeñas, y pueden realizar la transición a otras guías o flujos de rutina.
A continuación, se muestra una guía de rutina (A), una transición a otra guía de rutina (B) y una transición a un flujo (C):
- La rutina de la guía de procedimientos A puede leer los parámetros de sesión cuando se inicia y escribirlos justo antes de salir.
- La rutina de la guía A finaliza y se transfiere a la rutina de la guía B.
- La rutina de la guía de secuencias B puede leer los parámetros de sesión cuando se inicia y escribirlos justo antes de salir.
- La rutina del libro de jugadas B sale y realiza la transición al flujo C.
- El flujo C puede leer y escribir parámetros de sesión.
Si una guía de rutinas no realiza la transición a otra guía o flujo de rutinas, la sesión volverá al último flujo activo o finalizará si no hay uno.
Las rutinas de Playbook tienen el siguiente comportamiento de administración de parámetros:
- Cuando se ingresa una rutina de jugada, a sus parámetros de entrada se les asignan valores equivalentes a los parámetros de sesión con el mismo nombre.
- Cuando se cierra una rutina de Playbook, genera valores para sus parámetros de salida y los asigna a los parámetros de sesión con el mismo nombre.
Guía de acción predeterminada
Cuando creas un agente generativo con la consola de agentes conversacionales, se crea automáticamente una Guía de estrategias generativas predeterminada.
El plan de acción predeterminado es el punto de partida de las conversaciones, por lo que tiene algunas distinciones importantes de otros planes de acción:
- La guía de respuestas 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.
Importa y exporta libros de jugadas
Una vez que hayas creado playbooks con la consola de agentes conversacionales, podrás exportarlos para usarlos en otro agente. Para exportar una guía, sigue estos pasos:
- Navega a la lista de playbooks.
- Haz clic en el botón de exportación del libro de jugadas que deseas exportar.
- Selecciona las opciones de exportación.
- Haz clic en Exportar.
Para importar una guía que exportaste anteriormente, sigue estos pasos:
- Navega a la lista de playbooks.
- Haz clic en Importar.
- Selecciona las opciones de importación.
- Haz clic en Importar.