Solución de problemas

Filtra el contenido de este documento por etiqueta de tipo de agente:

Cualquier agente conversacional (Dialogflow CX) Dialogflow ES

Filtra el contenido de este documento por etiqueta de categoría:

Cualquier API Console Auth Project Integration NLU Regex Speech-to-Text Text-to-Speech Runtime IA generativa

Habilita Cloud Logging para tu agente

Activa Cloud Logging para tu agente. Esto es esencial para capturar datos y diagnosticar problemas en conversaciones reales.

Cómo recopilar IDs de conversación

Cuando se produzca un comportamiento inesperado, recopila los IDs de conversación de Dialogflow. Estos IDs, que se encuentran en el historial de conversaciones, proporcionan una forma de rastrear la ruta de ejecución de una conversación y examinar interacciones específicas.

Se rechazó el permiso para la llamada a la API

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX), Dialogflow ES
Etiquetas de categoría: API, autenticación

Problema

Se recibió una respuesta PERMISSION_DENIED para la llamada a la API.

Solución

Asegúrate de haber configurado correctamente la autenticación y los roles (Agentes conversacionales (Dialogflow CX), Dialogflow ES). En particular, comprueba si completaste estos pasos:

• Creaste una cuenta de servicio y no la borraste por accidente.
• Proporcionaste a la cuenta de servicio una función que otorga permiso para llamar al método deseado.
• Descargaste el archivo de claves privadas de la cuenta de servicio.
• Configuraste la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en el archivo de claves privadas.

La llamada a la API menciona un proyecto desconocido

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX), Dialogflow ES
Etiquetas de categoría: API, proyecto

Problema

Aparece un error Dialogflow API has not been used in project 32555940559 para la llamada a la API.

Solución

Comprueba si completaste estos pasos:

• Configuraste la variable de entorno GOOGLE_APPLICATION_CREDENTIALS (consulta PERMISSION_DENIED).
• Proporcionaste el ID del proyecto correcto a la llamada a la API.

Se obtiene un error de credenciales de autenticación no válido para la llamada a la API

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX), Dialogflow ES
Etiquetas de categoría: API, autenticación

Problema

Se recibió una respuesta Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential. para la llamada a la API.

Solución

Esto puede deberse a la creación manual de credenciales con tu biblioteca cliente mientras se especifica una región no predeterminada. Consulta una de las siguientes secciones para obtener orientación:

• Selecciona una región con la API (agentes conversacionales (Dialogflow CX))
• Selecciona una región con la API (Dialogflow ES)

La respuesta de la llamada a la API solicita un cambio a un host diferente.

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX), Dialogflow ES
Etiquetas de categoría: API, autenticación

Problema

Se recibió una respuesta Please switch to 'REGION-dialogflow.googleapis.com' to access resources located in 'REGION' para la llamada a la API, en la que REGION es un ID de región específico.

Solución

Esto sucede cuando especificas la región en la solicitud, pero no el extremo. Consulta una de las siguientes secciones para obtener orientación:

• Selecciona una región con la API (agentes conversacionales (Dialogflow CX))
• Selecciona una región con la API (Dialogflow ES)

Faltan campos en la respuesta de la llamada a la API

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX), Dialogflow ES
Etiquetas de categoría: API

Problema

Faltan algunos campos en la respuesta de la API.

Solución

Si esperas un valor numérico para un campo específico en la respuesta de la API, es posible que el campo no esté presente en la respuesta si el valor que se muestra es 0.

Para obtener más información sobre el comportamiento de los valores predeterminados (incluidos los valores no numéricos), consulta los siguientes recursos:

• Protocol Buffers (agentes conversacionales (Dialogflow CX))
• Búferes de protocolo (Dialogflow ES)

No se puede borrar el proyecto debido a una retención

Etiquetas de tipo de agente: Dialogflow ES
Etiquetas de categoría: Proyecto

Problema

Cuando intentas borrar un proyecto de Google Cloud, recibes una notificación que indica que no se puede borrar porque tiene retenciones y una de ellas está relacionada con Dialogflow ES.

Solución

1. Asegúrate de que ya no necesites el agente de Dialogflow ES asociado con el proyecto. Si recibes una notificación que indica que el agente no existe, significa que ya se borró.

   Consola de Dialogflow ES

   Abre https://dialogflow.cloud.google.com/#/agent/project-id/intents.

   Ten en cuenta que este vínculo difiere del vínculo que aparece en el diálogo de eliminación del proyecto de Google Cloud.

   API de Dialogflow

   Usa el método search del tipo agent.

2. Obtén el nombre de la retención.

   gcloud

   Usa el comando gcloud alpha resource-manager liens list, como se describe en la documentación sobre Crea una lista de retenciones de un proyecto.

   Explorador de API

   Usa el panel Probar esta API en la página Método: liens.list:

   • Completa el campo parent, como se indica en la descripción del parámetro.
   • Haz clic en Ejecutar.

3. Borra la retención.

   gcloud

   Usa el comando gcloud alpha resource-manager liens delete LIEN_NAME, como se describe en la documentación sobre Quita las retenciones de un proyecto.

   Explorador de API

   Usa el panel Probar esta API en la página Método: liens.delete:

   • Completa el campo name con el nombre de la retención que obtuviste en el paso 2.
   • Haz clic en Ejecutar.

4. Cierra el proyecto.

El webhook de Dialogflow CX falla con el error de vencimiento superado

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX)
Etiquetas de categoría: Tiempo de ejecución

Problema

Es posible que un webhook al que se le llamó desde Dialogflow CX falle con este mensaje de error:

Webhook call failed. Error: DEADLINE_EXCEEDED

Esto puede suceder porque la llamada al webhook supera el límite de tiempo de espera. Estos son algunos motivos por los que la llamada al webhook supera el límite de tiempo de espera:

1. Se intenta activar un intent inexistente.

2. Un problema de inicio en frío con el backend del webhook (por ejemplo, Cloud Functions).

3. El webhook llama a otros servicios, lo que aumenta el tiempo de respuesta.

4. No hay conexión entre el agente y el backend del webhook (por ejemplo, un balanceador de cargas mal configurado).

5. Política de la organización que impide que se ejecuten el tráfico de entrada o los métodos de Dialogflow.

Solución alternativa

De forma predeterminada, un webhook tiene un límite de tiempo de espera de 5 segundos. Puedes aumentar el límite de tiempo de espera del webhook cuando creas o editas el recurso de webhook, lo que le brindaría más tiempo para responder.

Console no pudo configurar un proyecto

Etiquetas de tipo de agente: Dialogflow ES
Etiquetas de categoría: Console, Project

Problema

Aparece un error Failed to set up GCP project cuando se crea un agente con la consola.

Solución

Es posible que no tengas permiso para crear proyectos de Google Cloud. Comprueba si puedes crear un proyecto de Google Cloud directamente desde la consola de Google Cloud. Si no puedes crear un proyecto, sigue las recomendaciones que se proporcionan en el mensaje de error.

Referencia del parámetro de sesión que se muestra en la respuesta

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX)
Etiquetas de categoría: Consola

Problema

Las respuestas que muestra Dialogflow incluyen las referencias de los parámetros en lugar de los valores de los parámetros. Por ejemplo:
Hello, $session.params.customer_name

Los parámetros no se resolverán y se mostrará la referencia del parámetro si no se encuentra en la sesión actual o si no se usa según su tipo.

Solución

Este problema puede aparecer debido a que el parámetro que se usa no se incluyó en la conversación, tiene un error tipográfico o tiene un tipo diferente al que se usa.

Console no pudo crear el agente cuando no se habilitó la API

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX)
Etiquetas de categoría: Consola

Problema

Aparece un error Dialogflow API has not been enabled for the project. Code: FAILED_PRECONDITION cuando se crea un agente con la consola.

Solución

Sigue los pasos de configuración para habilitar la API de Dialogflow.

Cuando se intenta acceder a la consola desde la cuenta de la organización, se recibe un error de servicio.

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX), Dialogflow ES
Etiquetas de categorías: Consola

Problema

Aparece un error You don't have access to this service cuando se intenta acceder a la consola desde la cuenta de tu organización.

Solución

Comunícate con el administrador del sistema de tu organización y verifica que la configuración de tu organización proporcione acceso a la consola.

Si la configuración de tu organización debería permitir el acceso y migraste tu cuenta desde otra organización, es posible que Google la haya marcado como restringida. Es probable que este sea el problema si otros usuarios de tu organización pueden acceder a la consola, pero tú no. Comunícate con el equipo de asistencia para obtener ayuda.

No se puede exportar el agente en formato JSON porque falta el flujo

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX)
Etiquetas de categoría: Consola

Problema

La exportación del agente como bytes sin procesar se completa correctamente, pero la exportación del agente en formato JSON falla con un mensaje de error similar al siguiente:

Flow 'projects/PROJECT_ID/locations/LOCATION_ID/agents/AGENT_ID/flows/FLOW_ID' does not exist
in the agent

Este problema puede deberse a un caso de prueba que hace referencia a un flujo que se borró.

Solución

Para resolver este problema, explora los casos de prueba que no se usan para confirmar si el flujo al que se hace referencia en el mensaje de error se usa en algún caso de prueba. Luego, borra los casos de prueba confirmados.

Conectividad telefónica de puerta de enlace

Etiquetas de tipo de agente: Dialogflow ES
Etiquetas de categoría: Integración

Problema

Cuando se utiliza la puerta de enlace telefónica, se obtiene una señal concurrida o la llamada se cae.

Solución

Existen cuotas y límites para esta función. Si recibes una señal de ocupado o la llamada se interrumpe, puede que hayas excedido tu cuota.

Se produce un error RESOURCE_EXHAUSTED cuando se intenta crear un número de teléfono nuevo.

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX), Dialogflow ES
Etiquetas de categoría: Integración

Problema

Cuando se intenta crear un número de teléfono nuevo en Agentes conversacionales (Dialogflow CX), Dialogflow ES o Agent Assist, se muestra un error RESOURCE_EXHAUSTED.

Solución

Este error significa que superaste el límite de números de teléfono por proyecto. Para crear un número de teléfono nuevo, borra los números de teléfono sin usar asociados con tu proyecto hasta que estés por debajo del límite.

Si creaste números de teléfono en la Puerta de enlace telefónica de agentes de conversación (Dialogflow CX) o la Puerta de enlace telefónica de Dialogflow ES, puedes borrarlos en la consola. Ten en cuenta que borrar el agente sin borrar el número de teléfono no borra el número de teléfono asociado con él.

Como alternativa, puedes usar la API siguiendo estos pasos.

Paso 1: Identifica todos los números de teléfono asociados con tu proyecto

Para identificar los números de teléfono asociados con tu proyecto, usa el método de API projects.phoneNumbers/list o projects.locations.phoneNumbers.list para todas las regiones en las que hayas creado números de teléfono.

• Para la región global, usa el siguiente comando:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/global/phoneNumbers
  

• Para otras regiones, debes especificar la región en dos lugares:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://REGION_ID-dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/REGION_ID/phoneNumbers
  

Paso 2. Identifica los agentes asociados con los perfiles de conversación (opcional)

Obtener el ID del agente de agentes conversacionales (Dialogflow CX) asociado con el número de teléfono a través del perfil de conversación podría ayudarte a identificar si el agente aún está en uso y si el número de teléfono aún es necesario. Para ello, usa el método de la API projects.conversationProfiles/get. Puedes encontrar los IDs de perfil de conversación en las respuestas a los comandos que ejecutaste en el paso 1.

• Para la región global, usa el siguiente comando:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/global/conversationProfiles/CONVERSATION_PROFILE_ID
  

• Para otras regiones, especifica la región en dos lugares:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://REGION_ID-dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/REGION_ID/conversationProfiles/CONVERSATION_PROFILE_ID
  

Puedes encontrar el agente por su ID en la consola de agentes conversacionales (Dialogflow CX) con la opción Search en la página View all agents.

En el caso de Dialogflow ES, un proyecto solo se puede asociar con un máximo de cinco agentes, y un agente de Dialogflow ES se puede asociar con un número de teléfono. Por lo tanto, puedes abrir el agente en la consola de Dialogflow ES a través de https://dialogflow.cloud.google.com/#/editAgent/PROJECT_ID/intents.

Si no se encuentra ningún agente, puedes borrar el número de teléfono si estás seguro de que ya no es necesario.

Paso 3. Borra los números de teléfono que no se usen

Para borrar los números de teléfono que ya no sean necesarios, usa el método de API projects.phoneNumbers/delete o projects.locations.phoneNumbers.delete. Puedes encontrar los IDs de los números de teléfono en la respuesta a los comandos que ejecutaste en el paso 1.

• Para la región global, usa el siguiente comando:

  curl -X DELETE \
      -H "Authorization: Bearer "$(gcloud auth print-access-token) \
      -H "X-Goog-User-Project: PROJECT_ID" \
      -H "Content-Type: application/json; charset=utf-8" \
      https://dialogflow.googleapis.com/v2beta1/PHONE_NUMBER_ID
  

• Para otras regiones, especifica la región:

  curl -X DELETE \
      -H "Authorization: Bearer "$(gcloud auth print-access-token) \
      -H "X-Goog-User-Project: PROJECT_ID" \
      -H "Content-Type: application/json; charset=utf-8" \
      https://REGION_ID-dialogflow.googleapis.com/v2beta1/PHONE_NUMBER_ID
  

No hay respuesta de Dialogflow CX Messenger

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX)
Etiquetas de categoría: Integración

Problema

No hay respuesta del agente para las interacciones de Dialogflow CX Messenger.

Solución

Si no ves ninguna respuesta de Dialogflow CX Messenger, asegúrate de que la facturación esté habilitada en el proyecto y que la API de Dialogflow esté habilitada en el proyecto. Consulta las instrucciones de configuración.

El valor del parámetro coincide, pero no es un sinónimo de entidad

Etiquetas de tipos de agentes: Agentes conversacionales (Dialogflow CX), Dialogflow ES
Etiquetas de categorías: NLU

Problema

Caso general: Se extrae un valor de parámetro durante el tiempo de ejecución, aunque la entidad correspondiente al parámetro no contenga el valor coincidente como sinónimo.

Un caso más específico: Después de borrar un sinónimo de una entidad y volver a entrenar al agente, este sinónimo aún se extrae como un valor de parámetro para esta entidad.

Solución

1. Usa la opción search para verificar si el valor coincidente puede estar presente en el agente como una entidad implícita (Agentes conversacionales (Dialogflow CX), Dialogflow ES). Busca todos los intents que tengan anotaciones con este parámetro y esta entidad.

2. Para corregir las anotaciones, asegúrate de que ninguna de ellas se aplique al texto que representa el valor coincidente no deseado.

3. Prueba el agente durante el tiempo de ejecución para verificar si se resolvió el problema.

4. Si el problema persiste, asegúrate de que las opciones Expansión automática y Coincidencia aproximada no estén marcadas en la configuración avanzada de la entidad y vuelve a probar el agente.

El bot por voz omite algunas respuestas

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX)
Etiquetas de categoría: Texto a voz

Problema

En el caso de un agente diseñado para texto y voz, el bot de voz no lee algunas de las respuestas.

Solución

Si se define al menos una respuesta de texto de audio de salida para un turno de conversación en particular, asegúrate de que la opción de texto de audio de salida esté presente de forma coherente en todas las respuestas de entrega y webhook del agente en todos los pasos de este turno de conversación.

Las etiquetas SSML no se aplican

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX), Dialogflow ES
Etiquetas de categorías: Texto a voz

Problema

Las etiquetas SSML se definen en la entrega del agente, pero el bot de voz lee el texto sintetizado sin efectos SSML.

Solución

Asegúrate de que haya un solo par <speak></speak> por tarjeta de respuesta en la consola de Dialogflow o por objeto de mensaje de respuesta si las respuestas se proporcionan a través de la API o el webhook.

El agente de voz pronuncia cero como la letra O.

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX)
Etiquetas de categoría: Texto a voz

Problema

En el caso de un agente diseñado para la voz, este lee los ceros como la letra O en lugar de cero.

Solución

1. Cambia Agent says para usar la opción de diálogo de texto de audio de salida.
2. Marca la casilla de verificación SSML.
3. Une tu texto con una etiqueta SSML:

     <speak>
       <say-as interpret-as='verbatim'>YOUR_TEXT</say-as>
     </speak>

4. Guardar.

Por ejemplo, los ceros de los números de tarjetas de crédito se escribirán como ceros.

      <speak>
        <say-as interpret-as='verbatim'>5177 7702 8500 4578</say-as>
      </speak>
   

Pronunciación sintetizada inesperada

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX), Dialogflow ES
Etiquetas de categorías: Texto a voz

Problema

La pronunciación sintetizada de las respuestas de los agentes (por ejemplo, nombres propios, acrónimos) no es la esperada.

Solución

Para garantizar pronunciaciones particulares de palabras que no son de uso general, usa la etiqueta say-as o phoneme de SSML en las respuestas de los agentes.

Se alcanzaron los pasos de ejecución máximos permitidos de la máquina de estados

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX)
Etiquetas de categoría: Tiempo de ejecución

Problema

Se recibió el siguiente mensaje de error en la consola de agentes conversacionales (Dialogflow CX) o en los registros cuando se enviaron solicitudes de tiempo de ejecución al agente:

You have reached the maximum allowed state machine execution steps. You may consider simplifying your agent/flow design. Current execution steps are: [<array_of_objects>]

El array en el mensaje de error contiene una lista de pasos de ejecución para la solicitud. Es posible que la lista no esté completa si la cantidad de pasos es demasiado grande.

Solución

Por lo general, este mensaje de error indica que la cantidad de transiciones para un solo turno de conversación es demasiado grande. Un ejemplo común es la transición a la misma página, que crea un bucle infinito.

Para solucionar el problema, haz lo siguiente:

1. Copia el array JSON del mensaje de error.
2. (Opcional) Dale formato al array copiado como JSON con formato para mejorar la legibilidad. Si el mensaje de error se trunca, busca el último objeto "Step", borra el objeto de paso incompleto y la coma anterior, y agrega un corchete de cierre del array antes de validar y mejorar el JSON.
3. Observa los valores "TriggeredTransitionRouteId" y "TargetPage" de cada paso. En el caso del bucle infinito, los campos "TriggeredTransitionRouteId" y "TargetPage" tienen valores repetidos para la mayoría de los pasos.
4. Modifica el diseño de tu agente para quitar las transiciones de bucle infinito o reducir la cantidad de transiciones para un solo turno de conversación.

La concordancia de expresión regular es demasiado amplia.

Etiquetas de tipos de agentes: Agentes conversacionales (Dialogflow CX), Dialogflow ES
Etiquetas de categorías: Regex

Problema

Se recibió un error Regular expression match is too broad cuando se creó una entidad de regexp (Agentes de conversación (Dialogflow CX), Dialogflow ES).

Solución

Considera el siguiente enfoque:

• Usa ^ y $ en la expresión regular para indicar el comienzo y el final del texto, respectivamente.
• Usa la entidad regexp con un parámetro obligatorio (Agentes de conversación (Dialogflow CX), Dialogflow ES).
• Define las instrucciones de los parámetros obligatorios para pedirle al usuario final que proporcione solo el valor de la entidad sin ninguna palabra circundante.

Texto no alfanumérico no deseado insertado por el reconocimiento de voz

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX), Dialogflow ES
Etiquetas de categorías: Texto a voz

Problema

Cuando se intenta hacer coincidir caracteres alfanuméricos, el reconocedor de voz inserta caracteres no alfanuméricos no deseados (espacios, guiones, etcétera), lo que hace que no se encuentre la entidad.

Solución

1. Si usas entidades del sistema para hacer coincidir números, considera usar entidades de regexp (Agentes conversacionales (Dialogflow CX), Dialogflow ES) en su lugar.
2. Sigue todas las recomendaciones de la sección Reconocimiento de voz alfanumérico impreciso por entidades de regex.
3. Para hacer coincidir números a través de integraciones de telefonía, considera una opción de DTMF además del reconocimiento de voz.

Transcripciones vacías para entradas de voz

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX), Dialogflow ES
Etiquetas de categorías: Texto a voz

Problema

Las respuestas de Dialogflow para entradas de voz muestran transcripciones vacías. Las solicitudes se manejan como si no hubiera ninguna entrada o coincidencia.

Solución

Escucha la grabación de audio para confirmar que contenga voz.

Asegúrate de que la adaptación de voz esté habilitada en la configuración del agente (Agentes conversacionales (Dialogflow CX), Dialogflow ES).

Si habilitar la adaptación de voz no ayuda, experimenta con los siguientes modelos de voz en una configuración que no sea de producción y usa el que genere los mejores resultados:

• latest_short
• phone_call
• command_and_search

Para idiomas distintos del inglés, busca los modelos de voz compatibles en la documentación sobre los idiomas compatibles con la función de texto a voz.

La forma de especificar un modelo de voz depende de cómo configures las interacciones con Dialogflow.

• Para las solicitudes a la API, proporciona el nombre del modelo en el campo model en InputAudioConfig (Agentes conversacionales (Dialogflow CX), Dialogflow ES).

• Si usas la puerta de enlace telefónica (Agentes conversacionales (Dialogflow CX), Dialogflow ES), puedes actualizar el modelo de voz en el perfil de conversación que creó Dialogflow cuando habilitaste la integración:

  1. Recupera el ID del perfil de conversación:

     • Usa el método conversationProfiles.list para recuperar todos los perfiles de conversación vinculados a tu proyecto.
     • Busca el perfil de conversación que deseas actualizar y copia el valor del campo name.

     En la puerta de enlace telefónica de Dialogflow CX, el nombre visible del perfil de conversación se puede encontrar en la configuración de integración. En el caso de Dialogflow ES Phone Gateway, el nombre visible del perfil de conversación corresponde al nombre del agente en el que se habilitó la integración.

     Si tienes varios perfiles de conversación con el mismo nombre visible, verifica el ID del agente en el campo automatedAgentConfig de la respuesta del método conversationProfiles.list.

  2. Usa el método de la API conversationProfiles.patch para actualizar el campo model en SpeechToTextConfig.

• Para las integraciones de Contact Center AI, consulta a tu integrador de telefonía cómo actualizar el modelo de voz para la integración o para solicitudes individuales.

Pantalla en blanco con el error "El tamaño del archivo supera los 2 MB" cuando se comparan versiones de agentes

Etiquetas de tipo de agente: Agentes conversacionales (Dialogflow CX)
Etiquetas de categoría: Consola

Problema

Cuando intentas comparar dos versiones diferentes del agente, la pantalla se queda en blanco con el siguiente mensaje de error:

File size exceeds 2MB

Este problema se debe a que uno de los archivos supera los 2 MB de tamaño.

Solución

Para comparar versiones de agentes en las que uno de los archivos supera los 2 MB de tamaño, se recomienda usar el método de la API compareVersion.

Reconocimiento de voz alfanumérico impreciso por entidades de regex

Etiquetas de tipos de agentes: Agentes conversacionales (Dialogflow CX), Dialogflow ES
Etiquetas de categorías: Texto a voz, regex

Problema

Se recibieron transcripciones imprecisas para entradas de voz de alfanuméricos diseñados para coincidir con una entidad de regexp (Agentes conversacionales (Dialogflow CX), Dialogflow ES).

Solución

1. Asegúrate de que la adaptación de voz esté habilitada en la configuración del agente (Agentes conversacionales (Dialogflow CX), Dialogflow ES).
2. Asegúrate de que, al menos, una entrada de entidad cumpla con todos los requisitos de entrada de regex (Agentes de conversación (Dialogflow CX), Dialogflow ES).
3. Para patrones específicos, usa las expresiones regulares más específicas. Por ejemplo, para un valor alfanumérico que comienza con dos letras seguidas de cinco dígitos, usa [a-zA-Z]{2}\d{5} en lugar de [a-zA-Z0-9]{7}.
4. Asegúrate de que tu entidad de regexp permita hacer coincidir caracteres no alfanuméricos (espacios, guiones, etcétera) que el identificador de voz pueda insertar. Para cumplir con el requisito 2 de esta lista, crea varias entradas de entidad: una para satisfacer el requisito 2 de esta lista y otra para los caracteres no alfanuméricos. Por ejemplo, para hacer coincidir cinco dígitos y permitir caracteres no alfanuméricos, haz lo siguiente:

    \d{5}
    (\d[^a-zA-Z0-9]*){5}
   

5. Asegúrate de que tu agente siga el requisito de definición de parámetros (Agentes conversacionales (Dialogflow CX), Dialogflow ES).

   Ejemplo de agentes conversacionales (Dialogflow CX)

   

   Ejemplo para Dialogflow ES

   
6. Asegúrate de que tu agente siga el requisito de anotación de frases de entrenamiento (Agentes conversacionales (Dialogflow CX), Dialogflow ES).

   Ejemplo para Dialogflow ES

   
7. Asegúrate de que tus pruebas sigan los lineamientos de pruebas (Agentes de conversación (Dialogflow CX), Dialogflow ES).
8. Para quitar los caracteres que no sean alfanuméricos que pudo haber insertado el reconocedor de voz, usa lo siguiente:
   • Para agentes conversacionales (Dialogflow CX): función del sistema SUBSTITUTE o webhook
   • Para Dialogflow ES: webhook
9. Consulta las limitaciones de adaptación de la voz (Agentes de conversación (Dialogflow CX), Dialogflow ES).

Cómo diseñar para conversaciones controladas

Compila tu agente con rutas de conversación claramente definidas. Asegúrate de que el agente pueda solicitar la información necesaria para cumplir con los requisitos del usuario. Evita un alcance de conversación demasiado amplio, ya que puede generar un comportamiento impredecible.

Cómo analizar registros

Las entradas y salidas de los libros de jugadas, las herramientas y los almacenes de datos se capturan en los registros. Usa los IDs de conversación recopilados para seguir la cadena de llamadas y determinar dónde falló la ejecución.

Experimenta con las instrucciones

Si un conjunto específico de instrucciones no funciona como se espera, intenta reformularlo. Como alternativa, puedes usar Gemini para generar instrucciones (metainstrucciones). Este enfoque iterativo puede ayudarte a encontrar la frase óptima para tu caso de uso.

Proporciona información completa al equipo de asistencia

Cuando abras un caso de ayuda con la Asistencia de Cloud, incluye los IDs de conversación y los registros relevantes recopilados durante la investigación. Esta información es fundamental para depurar problemas de manera eficiente.