Programmatic access to Conversational Agents

La API permite automatizar cambios, pero sigue necesitando autenticación, región y manejo de errores. Una librería simplifica el recorrido; no elimina esas responsabilidades del operador.

Índice

Acceso programatico Desarrollo con SCRAPI

Acceso programatico

Herramientas para acceso programático

Hay tres herramientas principales para automatizar las operaciones y el mantenimiento de los agentes conversacionales:

API de Dialogflow CX: Permite automatizar despliegues y reconfiguraciones. Expone interfaces REST y RPC; elegir cliente y versión según el recurso y la operación. Existen múltiples versiones de la API, cada una con un ciclo de vida propio (Generally Available, Beta, Alpha).
Bibliotecas de cliente: Similares a las API, permiten acceder a sus funcionalidades desde lenguajes de programación populares.
SCRAPI: Es una API de Python de alto nivel que simplifica la experiencia de desarrollo al manejar la complejidad subyacente de las API nativas de Google.

SCRAPI: una alternativa de código abierto

SCRAPI (Dialogflow Scripting API) es una herramienta de código abierto ideal para automatizar operaciones.

Ventajas:
- Simplifica la autenticación y regionalización.
- Reduce la cantidad de código necesaria.
- Permite trabajar con datos en estructuras de Python familiares (listas y diccionarios).
Extensiones:
- Pandas DataFrames: Permite manejar los datos en un formato de tabla.
- Google Sheets: Permite sincronizar las frases de entrenamiento y otros recursos entre el agente y una hoja de cálculo. Esta integración es bidireccional.
- Cloud Functions: Facilita la construcción de webhooks.
Flujo de trabajo: Se pueden extraer recursos del agente con SCRAPI para modificarlos y luego escribirlos de vuelta al mismo agente o a otro. Esto permite usar sistemas de control de versiones externos (como Git) para gestionar CI/CD (Continuous Integration/Continuous Deployment).

Desarrollo con SCRAPI

El desarrollo de agentes conversacionales con SCRAPI se basa en tres bloques principales: Core, Tools y Builders.

Autenticación

Local o Colab: Configura Application Default Credentials para la biblioteca. gcloud auth login y gcloud auth application-default login tienen propósitos distintos; en Colab puede usarse el mecanismo propio del entorno.
Servicios de Google Cloud: Asegúrate de que la cuenta de servicio tenga los permisos IAM de Dialogflow requeridos por las operaciones; Dialogflow IAM no identifica un rol predefinido concreto si la aplicación se ejecuta en servicios como Cloud Run.

Bloques de SCRAPI

Core: Contiene las clases y métodos de alto nivel que representan los recursos principales de Dialogflow CX (agentes, intenciones, flujos, etc.). Estos son los bloques fundamentales para construir métodos o herramientas personalizadas.
Tools: Incluye toolkits para tareas de gestión más complejas, como:
- Manipular recursos del agente en estructuras de datos como DataFrames.
- Copiar recursos entre agentes y proyectos de Google Cloud.
- Transferir datos entre Dialogflow CX y otros servicios de Google Cloud como BigQuery o Google Sheets.
Builders: Ofrece métodos para construir protos, que son los componentes fundamentales de Dialogflow CX. Permite construir recursos del agente sin necesidad de hacer llamadas a la API, para luego subirlos de forma masiva a un agente activo.

Navegación del módulo

Anterior: 05 Deployment Lifecycle
Siguiente: 07 Deploy using CI CD Referencia: REST API v3: agentes.

Referencia: SCRAPI, control de acceso. Es una biblioteca de conveniencia, no una API de servicio nueva. Fijar versión y revisar soporte de módulos antes de depender de una clase. Construir un protobuf local no despliega el recurso.

+----------------------------------------+
| Floure &                               |
| Tachibana's guild                      |
| [Hikari · Nozomi · Iona]               |
| SEAL: sha256/12: 2fe21dfae74e          |
| STATUS: LITURGY_IN_PROGRESS            |
+----------------------------------------+