Algunos productos y funciones están en proceso de cambio de nombre. Las funciones de guía generativa y flujos también se están migrando a una sola consola consolidada.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Ejemplos de guías

Cada guía debe tener uno o más ejemplos. Estos ejemplos son conversaciones de muestra entre un usuario final y la guía, incluidos los diálogos y las acciones que realiza el agente. Estos son, en efecto, ejemplos de instrucciones con varios ejemplos para el LLM.

La consola proporciona una interfaz para que ingreses acciones.

Agentes multilingües

Si quieres que tu agente controle varios idiomas, tus ejemplos deben usar cada uno de ellos.

Resumen de entrada y salida de ejemplo

Además de los parámetros de entrada y salida, las guías admiten recibir un resumen de entrada y emitir un resumen de salida para intercambiar información con otras guías. Los resúmenes son útiles para pasar información contextual abstracta entre guías, mientras que los parámetros son más útiles para pasar campos estructurados y bien definidos entre guías. Los parámetros son la única forma de intercambiar datos entre flujos y guías.

Agrega resúmenes de entrada relevantes a los ejemplos para condicionar la guía para que ajuste sus acciones en función de los resúmenes de entrada en el tiempo de ejecución. Agrega resúmenes de salida que incluyan detalles relevantes y precisos sobre la conversación de ejemplo para mostrarle a la guía qué detalles son importantes para resumir.

Estado de ejemplo

En un momento determinado de la conversación, una guía estará en uno de los siguientes estados:

OK: La guía logró su objetivo correctamente y el control ahora se transferirá a la guía superior.
CANCELLED: El usuario decidió no continuar con el objetivo asignado a la guía. El control ahora se transferirá a la guía superior. Si la guía superior es un flujo de CX, se detectará el intent de la entrada del usuario antes de que se ejecute el flujo.
FAILED: La guía no puede continuar con el objetivo debido a algún error (p.ej., la herramienta muestra un error 500). La sesión finalizará con el estado de falla. Se agregará un mensaje EndInteraction a la respuesta.
ESCALATED: La guía decidió que no puede lograr el objetivo y necesita escalar la situación a un humano. La sesión finalizará con el estado de escalamiento. Se agregará un mensaje EndInteraction a la respuesta.
PENDING: La conversación aún continúa dentro de la guía.

El ejemplo de nivel superior y sus invocaciones de guía deben indicarse con un estado que corresponda a la guía a la que hacen referencia.

Estrategia de selección

El parámetro de configuración de la estrategia de selección controla si se incluye un ejemplo en la instrucción de la guía enviada al LLM. Las siguientes opciones están disponibles:

Seleccionar dinámicamente: El ejemplo se incluye de forma condicional, según su relevancia para el contexto de la conversación actual. El ejemplo puede omitirse si la instrucción se acerca al límite de tokens.
Seleccionar siempre: El ejemplo siempre se incluye, independientemente del contexto de la conversación. El ejemplo puede omitirse si la instrucción se acerca al límite de tokens.
No seleccionar nunca: El ejemplo nunca se incluye en la instrucción. El ejemplo no tendrá ningún efecto en el rendimiento de la guía. Este parámetro de configuración es útil para excluir temporalmente un ejemplo para realizar pruebas.

Agregar acción

Un ejemplo proporcionado en una guía consta de una serie de acciones. Estas acciones pueden variar en sus combinaciones, pero principalmente representan la interacción entre el usuario y la guía, junto con las acciones que se realizan en el medio para cumplir con la consulta o los requisitos del usuario.

Existen dos formas de agregar acciones a un ejemplo:

Para agregar una acción de forma manual, haz clic en el botón + en la parte inferior del panel derecho o en el botón Agregar acción cuando mantengas el puntero sobre las acciones existentes. Puedes usar estas opciones cuando creas un ejemplo nuevo haciendo clic en la opción + Ejemplo o cuando editas un ejemplo existente.
Para generar acciones automáticamente en función de las instrucciones de la guía existentes, ingresa una entrada del usuario en el campo Ingresar entrada del usuario en la parte inferior del panel derecho. Puedes usar esta opción cuando creas o editas un ejemplo. También puedes usar esta opción cuando pruebas tu guía en el tiempo de ejecución en el panel Vista previa de la guía a la derecha. Para guardar acciones en un ejemplo desde el panel Vista previa de la guía , haz clic en Guardar ejemplo después de seleccionar la invocación de la guía de la lista de invocaciones a la izquierda del panel Vista previa de la guía.

Asegúrate de verificar la exactitud de las acciones generadas automáticamente y editarlas si es necesario. Esto es especialmente importante para las guías con pocos o ningún ejemplo.

La guía admite los siguientes tipos de acciones:

Respuesta de la guía

La respuesta de la guía a la consulta del usuario.

Entrada del usuario

La consulta del usuario

Uso de herramientas

Es una herramienta invocación para obtener información adicional necesaria para cumplir con la consulta del usuario. Esta acción debe especificar los siguientes detalles:

Herramienta: Es el nombre de la herramienta que se debe invocar.
Acción: Es el nombre de la operación para la herramienta OpenAPI que se debe invocar. Para las herramientas de almacén de datos y las herramientas de función, el nombre de la acción es el mismo que el nombre de la herramienta.
Entrada de la herramienta: Son las entradas que se incluirán en la llamada a la herramienta. Por lo general, se derivan de los turnos de conversación anteriores con el usuario.

Para las herramientas de Open API, requestBody se requiere JSON para los tipos de métodos POST, PUT y PATCH.

Ejemplo de entrada requestBody `requestBody` de la herramienta de Open API para la acción createPet:
```
{
  "id": 1,
  "name": "Luna"
}
```
Para la herramienta de almacén de datos, el ejemplo requestBody en el que se requiere la consulta y otros campos son opcionales.
```
{
  "query": "Where is my nearest store?",
  "filter": "country: ANY(\"United States\")",
  "userMetadata": {
    "userCity": "San Francisco",
  },
  "fallback": "We don't have any stores in your area."
}
```
Salida de la herramienta: Es la respuesta de la invocación de la herramienta. Es una respuesta JSON válida de la herramienta a la entrada determinada. Para las herramientas de Open API, también puede ser un error de cadena (por ejemplo, "404 No encontrado").

Ejemplo de salida de la herramienta de Open API para la acción listPets:
```
{
  "pets": [
    {
      "id": 1,
      "name": "Luna"
    },
    {
      "id": 2,
      "name": "Charlie"
    }]
}
```
Ejemplo de salida de la herramienta de almacén de datos:
```
{
  "answer": "Here's the address to your nearest store ...",
  "snippets": [
    {
      "title": "San Francisco Downtown",
      "uri": "https://www.example.com/San_Francisco_Downtown",
      "text": "Address for San Francisco Downtown .."
    }
  ]
}
```

Para garantizar que la guía sea a prueba de fallas, también incluye ejemplos de cómo debe responder la guía cuando falla la invocación de la herramienta. La falla de invocación de la herramienta de Open API se puede representar como una cadena de error ("404 no encontrado") en el resultado de la herramienta. Para las herramientas de almacén de datos , se puede usar la entrada fallback para especificar cómo responder si no hay una respuesta resumida.

Si quieres que tu herramienta de almacén de datos incluya el URI en la respuesta de la guía, agrega ejemplos que contengan el URI con el que quieres que responda la guía. Si este URI proviene de la herramienta de almacén de datos, la salida de la herramienta de almacén de datos debe contener un URI que coincida con el URI en la respuesta de la guía. Ten en cuenta que fallback no se puede usar en esta situación porque inhabilitará la capacidad de la guía del LLM para reformular la respuesta de la herramienta de almacén de datos para incluir URIs en la respuesta de la guía.

Los ejemplos que contienen acciones de uso de herramientas pueden ser bastante detallados y contribuir a un mayor consumo del límite de tokens de entrada. Para garantizar el uso eficiente de los tokens, asegúrate de que las salidas de las herramientas sean concisas y contengan información relevante para los objetivos de la guía. Para las herramientas de almacén de datos, considera quitar fragmentos de los ejemplos, ya que pueden contribuir a un alto consumo de tokens de entrada.

Invocación de la guía

Esta acción se usa cuando la guía debe invocar otra guía de tareas para cumplir con la consulta del usuario. Esta acción debe especificar los siguientes detalles:

Guía: Es el nombre de la guía que se invocará.
Resumen de entrada de la invocación de la guía: Es un resumen de las partes relevantes de la conversación anterior que son útiles para la guía que se invoca.
Parámetros de entrada: Parámetros de entrada que se pasarán a la guía.
Resumen de salida de la invocación de la guía: Es un resumen de lo que debe generar la guía cuando se complete su objetivo.
Parámetros de salida: Parámetros de salida generados por la guía cuando se completa su objetivo.

Transición de la guía

Una acción de transición de la guía es una acción terminal (no debe ir seguida de otras acciones) que indica que la guía de rutina decidió salir y pasar a una guía de rutina de destino. Ten en cuenta que, como esta acción indica que la guía sale, agrega los parámetros de salida de la guía a la salida de la guía del ejemplo.

Invocación del flujo

Esta acción se usa cuando la guía de tareas debe invocar un flujo. Esta acción debe especificar los siguientes detalles:

Flujo: Es el nombre del flujo que se invocará.
Parámetros de entrada del flujo: Son los parámetros de entrada que se pasarán al flujo.
Parámetros de retorno del flujo: Parámetros de salida que se muestran desde el flujo.

Transición del flujo

Una acción de transición del flujo es una acción terminal (no debe ir seguida de otras acciones) que indica que la guía de rutina decidió salir y pasar a un flujo de destino. Ten en cuenta que, como esta acción indica que la guía sale, agrega los parámetros de salida de la guía a la salida de la guía del ejemplo.

Acciones condicionales de la guía

Parámetros de la guía