Agentes

Un agente de Dialogflow CX es un agente virtual que controla las conversaciones simultáneas con tus usuarios finales. Es un módulo de comprensión del lenguaje natural que comprende los matices del lenguaje humano. Dialogflow CX traduce el texto o el audio del usuario final durante una conversación a datos estructurados que tus apps y servicios pueden comprender. Un agente de Dialogflow CX se crea y diseña a fin de manejar los tipos de conversaciones requeridas para tu sistema.

Un agente de Dialogflow CX es similar a un agente humano de un centro de llamadas. Lo entrenas para que se encargue de las situaciones de conversación esperadas; el entrenamiento no tiene que ser demasiado explícito.

Crea un agente

Nota: Puedes crear varios agentes de Dialogflow CX para un proyecto de Google Cloud.

Para crear un agente, haz lo siguiente:

Console

1. Abre la consola de Dialogflow CX.
2. Crea o elige un proyecto.
3. Haz clic en Create agent.
4. Selecciona Generar automáticamente para crear un agente de almacén de datos o selecciona Crea tu propio para crear otros tipos de agentes.
5. Completa el formulario de configuración básica del agente.
   1. Puedes elegir cualquier nombre visible.
   2. Selecciona tu ubicación preferida. Si deseas cambiar la configuración de ubicación avanzada, haz clic en el botón Editar.
   3. Selecciona tu zona horaria preferida.
   4. Selecciona el idioma predeterminado para tu agente. No puedes cambiar el idioma predeterminado para un agente una vez que se crea.
6. Haz clic en Guardar.

API

Si aún no configuraste la configuración de ubicación para tu proyecto, debes hacerlo con la consola antes de crear agentes con la API. No puedes configurar los parámetros de ubicación con la API.

Para crear un agente, consulta el método create para el tipo Agent. Ir a la referencia de la API de agente

Selecciona un protocolo y una versión para la Referencia del agente:

Protocolo	V3	V3beta1
REST	Recurso del agente	Recurso del agente
RPC	Interfaz del agente	Interfaz del agente
C++	AgentsClient	No disponible
C#	AgentsClient	No disponible
Go	AgentsClient	No disponible
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	No disponible	No disponible
Python	AgentsClient	AgentsClient
Ruby	No disponible	No disponible

Cerrar

Datos del agente

Los agentes de Dialogflow CX sirven como contenedores de nivel superior para la configuración y los datos de los agentes virtuales. Los siguientes datos están asociados con los agentes:

• Intents
• Tipos de entidad
• Webhooks
• Flows
• Pages
• Grupos de rutas

Para obtener más información sobre cómo se aplican los datos en diferentes niveles, consulta los niveles de aplicación de datos.

Puntos finales inteligentes

Speech-to-Text (STT) es una API que convierte audio en texto con aprendizaje automático, lo que te permite integrar el reconocimiento de voz en tus aplicaciones. Los modelos de STT admitidos incluyen cualquier modelo de formato largo (por ejemplo, phone_call). Solo se admite el idioma en-US.

Nota: Si usas un modelo corto, esto habilita la segmentación de extremos de voz en la nube.

Si el extremo inteligente está habilitado para el agente, puedes personalizar su comportamiento para un parámetro numérico configurando el Tiempo de espera para especificar el tiempo adicional. Luego, Dialogflow CX esperará a que el usuario proporcione información adicional.

El tiempo de espera es un período de gracia que te permite agregar algo a la transcripción de STT antes de que se active el tiempo de espera del habla. Dialogflow CX usa heurísticas para especificar qué tiempo de espera se debe elegir según la transcripción. Por ejemplo, puede elegir un tiempo de espera muy corto si la intención coincidió correctamente. Si no se encontró una coincidencia con la intención, puede aumentar el tiempo de espera para permitirte decir algo más y volver a intentar la coincidencia de intención.

Estas son otras funciones de la STT:

• Endpointing más rápido: El análisis en tiempo real usa la transmisión de transcripción de audio para distinguir entre una pausa natural y la finalización de una expresión mientras el flujo de STT permanece abierto. Si el usuario terminó de hablar, Dialogflow CX finaliza la transmisión antes para entregar una respuesta más rápida.
• Comentarios conversacionales naturales: Si el usuario hace una pausa a mitad de la expresión, Dialogflow CX puede extender de forma dinámica el tiempo de espera del STT para evitar interrupciones prematuras o insertar indicadores naturales de canal secundario (p.ej., "mm hmm", "ajá") para confirmar que el agente virtual sigue escuchando.

Exporta y restablece un agente

Advertencia: A partir del 15 de agosto de 2025, ya no exportaremos credenciales de valores sin procesar para las herramientas de OpenAPI ni los Webhooks. Debes migrar para almacenar tus credenciales en Secret Manager. Para obtener instrucciones, consulta la documentación de Webhook y Tool.

Puedes exportar un agente a un archivo y restablecerlo con ese archivo.

Una exportación del agente incluye todos los datos del agente, excepto los siguientes:

• Versiones de flujos: Solo se exportan los flujos de borrador a un archivo.
• Entornos: Los entornos personalizados no se exportan a un archivo.

Si restableces un agente, se reemplazan todos los datos del agente de destino (incluidas todas las versiones de flujo), excepto los siguientes:

• Entornos: Todos los entornos personalizados permanecen sin cambios en el agente de destino. Las versiones de flujo a las que hacen referencia los entornos personalizados en el agente de destino seguirán existiendo mientras existan los entornos asociados. Sin embargo, estas versiones obsoletas del flujo no se muestran ni se pueden seleccionar para el agente.
• Apps de Vertex AI Agents: La asociación a una app de Vertex AI Agents permanece sin cambios en el agente de destino (es decir, el valor de engine en GenAppBuilderSettings). Esto significa que los agentes de almacén de datos solo se pueden restablecer en otros agentes de almacén de datos existentes, ya que el agente resultante también debe tener una asociación con una app de Vertex AI Agents.

• Almacenes de datos de los agentes de Vertex AI: Todas las referencias a los almacenes de datos se reemplazarán en el agente de destino, según las siguientes reglas:

  • Si el agente de destino no está asociado a una app, no es posible restablecer un agente con referencias al almacén de datos. Si intentas hacerlo, se mostrará un mensaje de error. Para solucionar este problema, puedes crear un nuevo agente de almacén de datos desde cero. (También puedes convertir tu agente existente en un agente de almacén de datos agregándole un controlador de estado de almacén de datos. En este caso, se te guiará para que agregues una app asociada a tu agente.
  • Si el agente de destino está asociado a una app, todas las referencias del almacén de datos se actualizarán tras el restablecimiento: se actualizarán su ID de proyecto y su ubicación de Google Cloud para que coincidan con la app del agente de destino. El ID de la colección y el ID del almacén de datos no cambiarán. Esto significa que debes agregar almacenes de datos para todos los IDs con tipos coincidentes en la app del agente de destino antes de la operación de restablecimiento.

  Ejemplo: Si el agente fuente hace referencia a un almacén de datos llamado projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1 y la app del agente de destino se llama projects/321/locations/us-east1/collections/default_collections/engines/app123, la referencia al almacén de datos resultante en el agente de destino será la siguiente: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1

Nota: En la API y en el contenido de los datos exportados, una app de Vertex AI Agents se denomina motor de GenAppBuilder. Por ejemplo, en un paquete JSON exportado, puedes encontrar el nombre del motor en el archivo agent.json, en la clave genAppBuilderSettings.engine.

Cuando exportes, podrás seleccionar el formato del archivo de exportación. Si usas el control de versiones de código fuente para los datos de tu agente, debes exportar en formato JSON. Cuando restableces un agente, Dialogflow CX determina automáticamente el formato del archivo.

Sigue estos pasos para exportar o restablecer un agente:

Console

1. Abre la consola de Dialogflow CX.
2. Elige el proyecto para el agente.
3. Selecciona la opción de menú para un agente de la lista.
4. Haz clic en el botón Exportar o Restablecer.
5. Sigue las instrucciones para finalizar.

Nota: Para restablecer un agente de almacén de datos, asegúrate de que el agente de destino se haya creado como un agente de almacén de datos.

API

Consulta los métodos export y restore para el tipo Agent. Ir a la referencia de la API de agente

Selecciona un protocolo y una versión para la Referencia del agente:

Protocolo	V3	V3beta1
REST	Recurso del agente	Recurso del agente
RPC	Interfaz del agente	Interfaz del agente
C++	AgentsClient	No disponible
C#	AgentsClient	No disponible
Go	AgentsClient	No disponible
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	No disponible	No disponible
Python	AgentsClient	AgentsClient
Ruby	No disponible	No disponible

Cerrar

Si el tamaño del agente excede el límite máximo, usa la opción de Cloud Storage para la exportación y el restablecimiento del agente.

Si usas GitHub, consulta también la guía de exportación y restauración de GitHub.

Borra un agente

Precaución: La acción de borrar un agente no se puede deshacer. Exporta el agente para tener una copia de seguridad si es necesario.

Para borrar un agente, necesitas una función que proporcione acceso completo o acceso de edición. Para obtener más información, consulta la Guía de control de acceso.

Para borrar un agente, sigue estos pasos:

Console

1. Abre la consola de Dialogflow CX.
2. Elige el proyecto para el agente.
3. Selecciona la opción de menú para un agente de la lista.
4. Haz clic en el botón .
5. Confirma la eliminación en el cuadro de diálogo.

API

Consulta el método delete para el tipo Agent. Ir a la referencia de la API de agente

Selecciona un protocolo y una versión para la Referencia del agente:

Protocolo	V3	V3beta1
REST	Recurso del agente	Recurso del agente
RPC	Interfaz del agente	Interfaz del agente
C++	AgentsClient	No disponible
C#	AgentsClient	No disponible
Go	AgentsClient	No disponible
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	No disponible	No disponible
Python	AgentsClient	AgentsClient
Ruby	No disponible	No disponible

Cerrar

Si borras tu proyecto, se borrarán de inmediato todos los agentes y datos de Dialogflow CX asociados con él.