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
Consulta la columna Guías de implementación en la referencia de idiomas.
Los idiomas marcados para los libros de jugadas se probaron en cuanto a la 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 algunos idiomas y casos de uso, es posible que obtengas respuestas ligeramente mejores si, además, proporcionas instrucciones en el idioma de destino.
Compatibilidad con modelos
Puedes seleccionar el modelo de LLM que se usa en la guía de instrucciones 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 -> Guía de referencia, 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 de respuestas.
- 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 | Nombre visible del modelo | Especificaciones del modelo | Etapa de lanzamiento | Región disponible |
|---|---|---|---|---|
| gemini-pro | gemini-1.0-pro-001 | Gemini 1.0 Pro | DG | Todas las regiones de la guía de implementación |
| gemini-1.5-flash | gemini-1.5-flash-001 | Gemini 1.5 Flash | DG | Todas las regiones de la guía de implementación |
| gemini-1.5-flash-002 | gemini-1.5-flash-002 | Gemini 1.5 flash 002 | Versión preliminar pública | Todas las regiones de la guía de implementación |
| gemini-2.0-flash-001 | gemini-2.0-flash-001 | Gemini 2.0 Flash | Versión preliminar pública | En regiones multirregionales de la UE, EE.UU. y regiones individuales compatibles con Vertex AI |
Las fechas de baja de los modelos están alineadas con las de Vertex AI. Consulta Versiones de modelos para obtener más información.
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 Playbook 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.
La guía predeterminada es el punto de partida de las conversaciones, por lo que tiene algunas distinciones importantes de otras guías:
- 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.