Preguntas frecuentes sobre la API Conversational Analytics

¿Puede la API Conversational Analytics modificar o eliminar mis datos?

La API Conversational Analytics se ha diseñado con medidas de protección para evitar que se alteren o eliminen tus datos.

A continuación se explica cómo se gestiona la seguridad de los datos en diferentes fuentes de datos:

  • BigQuery la API bloquea las instrucciones del lenguaje de definición de datos (DDL) y del lenguaje de manipulación de datos (DML). En concreto, el sistema realiza una prueba con el código SQL generado y solo permite consultas de tipo SELECT.
  • Looker: la API interactúa con Looker mediante métodos como run_inline_query, que se limitan a operaciones de lectura, como selecciones, filtros y límites. Estos métodos no admiten operaciones de DDL ni de DML, y no incluyen operaciones de eliminación o de eliminación.
  • Looker Studio (para archivos CSV y Hojas de cálculo de Google): Looker Studio usa un formato estructurado para definir y obtener datos de visualizaciones e informes. Las consultas que se ejecuten con este método serán de solo lectura y no admitirán mutaciones de datos.

La API Conversational Analytics está diseñada para ser de solo lectura en estas fuentes de datos.

¿Cómo gestiono los errores de autenticación y de permisos?

Estos son algunos de los errores de autenticación y permisos más habituales que puedes encontrar al usar la API Conversational Analytics:

  1. Error: PERMISSION_DENIED o 403 Write access to project ... was denied

    • Causa probable: este mensaje suele indicar problemas con los Google Cloud roles de gestión de identidades y accesos. El usuario o la cuenta de servicio que intenta usar la API no tiene los permisos necesarios en el proyecto Google Cloud .
    • Solución de problemas:
      • El Google Cloud propietario del proyecto debe asegurarse de que el usuario o la cuenta de servicio tengan asignados los roles de IAM correctos en el Google Cloud proyecto. Es posible que se necesiten roles como Project Editor para determinadas operaciones, como habilitar la API o probar sus funciones.
      • Si aparece un error 403, como Write access to project 'us-gcp-project-name' was denied, al cambiar de región, comprueba la configuración de gestión de identidades y accesos de tu proyecto.

  2. Error: 500 Internal Server Error cuando un usuario de Looker con el rol Usuario intenta chatear con un agente de datos.

¿Cuáles son los requisitos de Looker para usar la API Conversational Analytics?

Para usar la API Conversational Analytics, necesitas los permisos adecuados tanto en Google Cloud IAM como en Looker, en función de la fuente de datos y las acciones que quieras realizar:

  1. Google Cloud Roles de gestión de identidades y accesos:

    • Debes tener suficientes roles de gestión de identidades y accesos en tu Google Cloud proyecto para interactuar con la API geminidataanalytics.googleapis.com. Los roles de gestión de identidades y accesos mal configurados suelen provocar errores PERMISSION_DENIED.
    • Los roles específicos necesarios pueden depender de las acciones, pero es posible que se necesiten roles generales, como el de Editor de proyectos, para determinadas operaciones.

  2. Permisos y roles de Looker:

    • Permisos a nivel de modelo: para usar Analíticas conversacional y la API de Analíticas conversacional, se debe asignar a los usuarios de Looker un rol que contenga el permiso gemini_in_looker para los modelos con los que interactúan.

Para obtener más información sobre los permisos y los roles necesarios para usar la API Conversational Analytics, consulta la página de documentación Conceder roles y permisos de gestión de identidades y accesos de la API Conversational Analytics.

Además, tu instancia de Looker debe cumplir requisitos específicos:

Para usar la API Conversational Analytics con Looker Studio Pro, tu suscripción a Pro debe estar fuera de un perímetro de VPC-SC.

¿Cómo puedo migrar de la API Data QnA a la API Conversational Analytics?

Si has usado la versión experimental anterior de la API Data QnA (dataqna.googleapis.com), consulta la guía de migración para saber cómo migrar al nuevo endpoint oficial de la API Conversational Analytics (geminidataanalytics.googleapis.com).

¿Cuál es la diferencia entre el nombre y el ID de un agente de datos?

El ID del agente de datos, que se define como el valor de data_agent_id, es el identificador único del agente de datos. El nombre del agente de datos, data_agent.name, se deriva automáticamente del data_agent_id como nombre completo (FQN) y tiene el formato projects/<project>/locations/<location>/dataAgents/<data_agent_id>.

Cuando creas un agente de datos, se ignora cualquier valor que hayas introducido en data_agent.name. Cuando se realizan operaciones get, update o delete, el data_agent.name completo se trata como el identificador único del agente de datos.

Cuando se usa la API Conversational Analytics para crear agentes de datos, se aplican los siguientes casos:

  • Si no defines data_agent_id, se generará un ID único automáticamente.
  • Si defines data_agent_id como, por ejemplo, TestID, cualquier valor que hayas introducido en data_agent.name se sobrescribirá con projects/<project>/locations/<location>/dataAgents/TestID.
  • Si defines data_agent_id con un nombre completo, recibirás un error de nombre con formato incorrecto.

¿Cuáles son las capacidades de memoria del agente de datos de la API Conversational Analytics?

  • En una sola sesión: la API Conversational Analytics admite conversaciones de varios turnos, lo que significa que puede hacer referencia a partes anteriores de la conversación actual.
  • En varias sesiones: la API Conversational Analytics incluye funciones para gestionar el historial de conversaciones, lo que permite a los usuarios chatear en varias sesiones. También admite agentes con estado con conversaciones de varios turnos gestionadas por Google.
  • Memoria a largo plazo: los agentes de datos de la API Conversational Analytics no admiten funciones de memoria a largo plazo explícitas.

¿Un agente de datos de la API Conversational Analytics me dará la misma respuesta cada vez que haga la misma pregunta?

  • Las respuestas en lenguaje natural del agente de datos de la API Conversational Analytics no son deterministas, por lo que la respuesta en lenguaje natural que proporcione el agente puede variar incluso si la pregunta se formula de forma idéntica.
  • Respuestas a consultas de datos: sin embargo, en el caso de una pregunta específica sobre datos, se espera que la consulta subyacente generada (consulta de SQL o de Looker) sea determinista. Los datos que se recuperen deberían ser los mismos, siempre que los datos subyacentes no hayan cambiado.

¿Cómo puedo mejorar la precisión de las respuestas de un agente de datos de la API Conversational Analytics?

Una forma de mejorar la precisión de las respuestas de los agentes de datos es proporcionarles información contextual sólida. Puedes añadir contexto de las siguientes formas:

  • En la capa semántica de Looker, puedes proporcionar contexto en las definiciones de LookML. Para obtener más información y ejemplos, consulta la página de documentación Guía el comportamiento de los agentes con el contexto creado en Looker.
  • Cuando creas un agente de datos, puedes proporcionar instrucciones del sistema, que son directrices definidas por el usuario que pueden determinar el comportamiento de un agente de datos. Estas directrices incluyen lógica específica de la empresa, formato de respuesta o presentación de datos. También puedes proporcionar "consultas de referencia", que son preguntas de ejemplo en lenguaje natural emparejadas con sus consultas de SQL o Looker correctas. Para obtener más información sobre las instrucciones del sistema, consulta la página de documentación Guía el comportamiento del agente con contexto creado.

¿Puedo integrar la API Conversational Analytics con aplicaciones de terceros?

Al integrar la API Conversational Analytics con aplicaciones de terceros, los usuarios pueden interactuar con sus datos directamente en las herramientas que usan a diario.

Cualquier aplicación de terceros que interactúe con los endpoints de la API geminidataanalytics.googleapis.com debe poder enviar mensajes de usuario desde la aplicación al agente y mostrar las respuestas.

Para crear una integración, consulta el repositorio de guías de inicio rápido de analíticas conversacionales para ver ejemplos o bibliotecas. También puedes visitar los foros de desarrolladores de Google para buscar ejemplos de otros usuarios.

¿Cuánto cuesta la API Conversational Analytics?

La API Conversational Analytics está en fase de vista previa y Google no cobra por los productos en vista previa. Te avisaremos con antelación de cualquier cambio de precio que se produzca en el futuro.

¿Qué fuentes de datos admite la API Conversational Analytics?

La API Conversational Analytics admite las siguientes fuentes de datos:

  • BigQuery
  • Exploraciones de Looker
  • Looker Studio

También puedes conectarte a fuentes como SAP y Salesforce a través de BigQuery, y a archivos CSV y Hojas de cálculo de Google a través de Looker Studio.

¿Cuáles son las limitaciones conocidas de la API Conversational Analytics?

Para obtener más información sobre las limitaciones conocidas de la API Conversational Analytics, consulta la página de documentación Limitaciones conocidas de la API Conversational Analytics.

¿Qué cuotas debo tener en cuenta para los proyectos de Google Cloud ?

No hay restricciones en cuanto a la Google Cloud selección de proyectos ni a la ubicación. Puedes crear agentes de datos para consultar fuentes de datos compatibles que pertenezcan a cualquier proyecto o región.

¿La API Conversational Analytics admite la regionalización de datos?

Como la API Conversational Analytics no admite la residencia de datos (DRZ) ni los perímetros de control de servicios (VPC-SC), aún no puedes alojar agentes en regiones geográficas específicas. No se admite la regionalización de datos.

¿La API Conversational Analytics admite idiomas distintos del inglés?

El único idioma admitido oficialmente para la API Conversational Analytics es el inglés. Aunque los modelos de Gemini subyacentes admiten muchos idiomas y algunos usuarios han informado de que han tenido éxito con consultas en otros idiomas, la API Conversational Analytics no admite oficialmente idiomas distintos del inglés.