Guías

Una guía es el elemento básico de los agentes generativos. Un agente generativo suele tener muchas guías, y cada una de ellas se define para gestionar tareas específicas. Los datos de la guía 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 delegar la gestión de la conversación en un flujo u otra guía para gestionar las subtareas.

Limitaciones

Se aplican las siguientes limitaciones:

• Los agentes que usan guiones no admiten el envío de un SMS de acompañante de llamada desde la ruta de la intención de bienvenida predeterminada en el flujo de inicio predeterminado, pero puedes habilitar la opción de SMS de acompañante de llamada en los flujos estándar.
• Los Playbooks no admiten la entrada DTMF de sistemas telefónicos.

Idiomas disponibles

Consulta la columna Playbooks en la referencia de idiomas. Los idiomas marcados para las guías se han probado para comprobar su calidad con los modelos gemini-2.0-flash y gemini-1.5-flash-002.

Si usas idiomas distintos del inglés:

• En la mayoría de los casos, usa el inglés para las instrucciones de las guías. En algunos idiomas y casos prácticos, es posible que obtengas respuestas ligeramente mejores si también proporcionas instrucciones en el idioma de destino.
• Indica los idiomas que admites en las instrucciones de la guía. Por ejemplo: "Responde siempre en francés".
• Define tus ejemplos en el idioma de destino.

Modelos admitidos

Puedes seleccionar el modelo LLM que se usa en el cuaderno de estrategias en los siguientes lugares:

• Selecciona el modelo LLM a nivel de agente.

  • En la consola de agentes conversacionales, vaya a Configuración del agente -> IA generativa -> Guía y seleccione 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).

• Anulación de la selección de modelos a nivel de solicitud.

  • En el simulador de la consola del agente conversacional, selecciona el modelo por nombre visible en el menú desplegable al probar un libro de jugadas.
  • 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).

Asistencia por región

Las guías se admiten en las siguientes regiones:

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

Datos de la guía

Un manual se compone de los siguientes datos:

• Nombre del manual de estrategia: un nombre conciso en lenguaje natural que ayuda a los desarrolladores y al LLM a entender qué tareas gestiona el manual de estrategia.
• Objetivos: descripción general de lo que debe conseguir la guía
• Instrucciones: define los pasos que se deben seguir para alcanzar el objetivo.
• Ejemplos: conversaciones de ejemplo que son ejemplos de peticiones con pocos ejemplos 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.

Petición de LLM

En cada turno de conversación, Conversational Agents (Dialogflow CX) usa los datos de la guía de diseño y los datos de la conversación en tiempo de ejecución para crear una petición de LLM dentro de los límites de tokens. El contenido de esta petición se resume de la siguiente manera, donde los encabezados tienen fines ilustrativos y no forman parte necesariamente de la petició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 que quieres: guía de tareas o guía de rutinas.

Guías de tareas

Los manuales de tareas son el tipo de manual original. Se usan para dividir tareas complejas en subtareas más pequeñas y reutilizables. Se usan para modelar las fases de conversación de composición, en las que cada fase 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. La persona que llama proporciona los parámetros de entrada necesarios a la persona a la que llama.
3. El receptor procesa esta información, realiza la función designada y devuelve los parámetros de salida.
4. La persona que llama recibe parámetros de la persona a la que llama.

Cualquier rutina o manual de tareas puede llamar a otro manual de tareas, pero un manual de tareas no puede llamar a otro manual de rutinas.

Guías de rutinas

Las guías de rutinas son un nuevo tipo de guía. Se usan para modelar fases de conversación secuenciales, donde cada fase es completa e independiente. Pueden llamar a guías de tareas para descomponer tareas más grandes en subtareas más pequeñas y pueden pasar a otras guías o flujos de trabajo rutinarios.

A continuación, se muestra un manual de procedimientos de rutina (A), que pasa a otro manual de procedimientos de rutina (B) y, después, a un flujo (C):

1. El manual de jugadas de la rutina A puede leer los parámetros de sesión cuando se inicia y escribir los parámetros de sesión justo antes de salir.
2. El manual de procedimientos de la rutina A finaliza y pasa al manual de procedimientos de la rutina B.
3. El manual de instrucciones de la rutina B puede leer los parámetros de sesión cuando se inicia y escribir los parámetros de sesión justo antes de salir.
4. El manual de respuestas B de la rutina se cierra y pasa 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 de rutinas u otro flujo, la sesión volverá al último flujo activo o finalizará si no hay ninguno.

Las guías de rutinas tienen el siguiente comportamiento de gestión de parámetros:

• Cuando se introduce un cuaderno de estrategias de rutina, se asignan valores a sus parámetros de entrada que son equivalentes a los parámetros de sesión con el mismo nombre.
• Cuando se cierra un cuaderno de estrategias de rutina, 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

Guía de estilos predeterminada

Cuando creas un agente generativo con la consola 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 diferencias importantes con respecto a otras guías:

• El manual predeterminado no recibe un resumen de las conversaciones anteriores.
• La guía predeterminada no puede definir ni recibir parámetros de entrada.

Crear una guía

Para crear una guía:

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

Usar la generación con IA para crear una guía

Cuando creas un manual de estrategias, se abre un panel de IA generativa. Puedes usarlo para generar datos de guías.

Importar y exportar manuales

Una vez que hayas creado guías con la consola Conversational Agents, podrás exportarlas para usarlas en otro agente. Para exportar un manual de estrategias:

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

Para importar una guía que hayas exportado previamente, sigue estos pasos:

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