Un agente puede usar las herramientas del conector para realizar acciones con tus conexiones configuradas en Integration Connectors. Cada herramienta de conector se configura con una sola conexión y una o más acciones. Si es necesario, se pueden crear varias herramientas para una sola conexión y agrupar diferentes acciones para que las use tu agente.
La herramienta de conector admite los siguientes tipos de conectores:
- AlloyDB
- Asana
- Azure AD (Entra ID)
- BigQuery
- Box
- Cloud Search
- Cloud Spanner
- Cloud SQL - MySQL
- Cloud SQL - PostgreSQL
- Cloud SQL - SQL Server
- Cloud Storage
- Cloud Translation
- Confluence
- Couchbase
- DocuSign
- Dropbox
- Dynamics 365
- Elasticsearch
- Correo electrónico
- Enterprise License Manager
- Firestore
- FreshBooks
- FTP
- GitHub
- Gmail
- Google Analytics
- Calendario de Google
- Google Classroom
- Google Cloud Natural Language
- Google Contacts
- Documentos de Google
- Formularios de Google
- Hojas de cálculo de Google
- Presentaciones de Google
- Greenplum
- Jira Cloud
- Jira Service Management
- Kintone
- Magento
- Mailchimp
- MariaDB
- Meta Ads
- Microsoft Teams
- Lunes
- MongoDB (versión 2)
- Neo4j
- OneDrive
- Base de datos de Oracle (versión 2)
- PayPal
- PostgreSQL
- Salesforce
- Marketing Cloud de Salesforce
- SAP HANA
- SAP SuccessFactors
- ServiceNow
- SharePoint
- Shopify (versión 1
- Slack
- Stripe
- Trello
- WordPress
- Workday
- Zendesk
Crear una conexión
Para crear una conexión, sigue estos pasos:
- Navega desde el Agent Builder a Herramientas > Crear.
- Selecciona el tipo de herramienta Integration connector.
- Selecciona el tipo de conector que elegiste
- Usa el botón Crear conexión.
Esto te llevará a la creación de Integration Connectors con varios campos completados previamente.
Como alternativa, puedes navegar a Integration Connectors y seguir las instrucciones para crear una conexión.
Acciones del conector
Para cada herramienta de conector, hay dos tipos de acciones que se pueden poner a disposición de tu agente (consulta Entidades, operaciones y acciones para obtener más información):
Operaciones CRUD de entidades
Cada una de tus conexiones tiene "entidades" que corresponden a los objetos de esa fuente de datos (para BigQuery, son tablas; para Salesforce, son objetos, como "Pedido" o "Caso").
Puedes realizar operaciones CRUD en cada entidad:- Create: Crea una entidad con los valores de campo especificados.
- List: Búsqueda basada en filtros de instancias de entidades
- Update: Método basado en filtros para modificar los valores de los campos de entidades
- Borrar: Borra una entidad
- Get recupera una sola entidad con entityId
Obtén más información sobre los detalles de las operaciones CRUD de entidades en la documentación de Connectors.
- Create: Crea una entidad con los valores de campo especificados.
Acciones específicas del conector
Muchos conectores admiten una acción "ExecuteCustomQuery", que permite ejecutar una consulta en SQL en la fuente de datos, en la que se puede hacer referencia a cada una de las entidades de la fuente de datos como tablas. Consulta esta lista para ver los conectores compatibles.
Las acciones adicionales varían según el tipo de conector. Por ejemplo, consulta las acciones del conector de BigQuery o las acciones del conector de Salesforce.
Cómo configurar campos de entrada y salida para operaciones CRUD
Si seleccionas campos de entrada o salida específicos para que los use la acción de la herramienta del conector, puedes limitar la complejidad de estas acciones para el agente.
Por ejemplo, si solo necesitas crear una entidad con un subconjunto de sus campos, configurar este conjunto de campos en tu acción simplifica la acción para el agente.
Especificar un conjunto de campos de salida reduce el tamaño de la respuesta de la herramienta (lo que resulta útil si los límites de tokens son un problema) y simplifica el manejo de la salida por parte del agente, ya que solo expone los campos pertinentes.
Autenticación
Si la conexión que usas está configurada para permitir la anulación de autenticación, la herramienta se puede configurar para pasar las credenciales de los parámetros de sesión especificados.
Como creador del agente, eres responsable de cómo se propagan estas credenciales a los parámetros de la sesión, y la herramienta las pasará automáticamente a la fuente de datos para que se usen en la autenticación cuando se llamen las acciones de la herramienta.