Un agent peut utiliser des outils de connecteur pour effectuer des actions à l'aide de vos connexions configurées dans Integration Connectors. Chaque outil de connecteur est configuré avec une seule connexion et une ou plusieurs actions. Si nécessaire, plusieurs outils peuvent être créés pour une seule connexion afin de regrouper différentes actions que votre agent pourra utiliser.
L'outil de connecteur est compatible avec les types de connecteurs suivants :
- 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
- Enterprise License Manager
- Firestore
- FreshBooks
- FTP
- GitHub
- Gmail
- Google Analytics
- Google Agenda
- Google Classroom
- Google Cloud Natural Language
- Google Contacts
- Google Docs
- Google Forms
- Google Sheets
- Google Slides
- Greenplum
- Jira Cloud
- Jira Service Management
- Kintone
- Magento
- Mailchimp
- MariaDB
- Meta Ads
- Microsoft Teams
- Monday
- MongoDB (version 2)
- Neo4j
- OneDrive
- Oracle DB (version 2
- PayPal
- PostgreSQL
- Salesforce
- Salesforce Marketing Cloud
- SAP HANA
- SAP SuccessFactors
- ServiceNow
- SharePoint
- Shopify (version 1
- Slack
- Stripe
- Trello
- WordPress
- Workday
- Zendesk
Créer une connexion
Pour créer une connexion :
- Accédez à Outils > Créer dans l'outil de création d'agent.
- Sélectionnez le type d'outil Connecteur d'intégration.
- Sélectionnez le type de connecteur de votre choix.
- Cliquez sur le bouton Créer une connexion.
Vous serez redirigé vers la création d'Integration Connectors, avec un certain nombre de champs préremplis.
Vous pouvez également accéder à Integration Connectors et suivre les instructions pour créer une connexion.
Actions de connecteur
Pour chaque outil de connecteur, deux types d'actions peuvent être mis à la disposition de votre agent (pour en savoir plus, consultez Entités, opérations et actions ) :
Opérations CRUD sur les entités
Chacune de vos connexions comporte des "entités" correspondant aux objets de cette source de données (pour BigQuery, il s'agit de tables ; pour Salesforce, il s'agit d'objets, tels que "Commande" ou "Requête").
Vous pouvez effectuer des opérations CRUD sur chaque entité :- Créer : crée une entité avec des valeurs de champ spécifiées
- Liste : recherche d'instances d'entité basée sur des filtres
- Mettre à jour : méthode basée sur des filtres pour modifier les valeurs de champ d'une entité
- Supprimer : supprime une entité
- Obtenir : récupère une seule entité à l'aide de l'entityId
Pour en savoir plus sur les opérations CRUD sur les entités, consultez la documentation sur les connecteurs.
- Créer : crée une entité avec des valeurs de champ spécifiées
Actions spécifiques aux connecteurs
De nombreux connecteurs sont compatibles avec une action 'ExecuteCustomQuery', qui permet d'exécuter une requête SQL sur la source de données, où chacune des entités de la source de données peut être référencée en tant que table. Consultez cette liste pour connaître les connecteurs compatibles.
Les actions supplémentaires varient en fonction du type de connecteur. Par exemple, consultez les actions du connecteur BigQuery ou les actions du connecteur Salesforce.
Configurer les champs d'entrée / de sortie pour les opérations CRUD
En sélectionnant des champs d'entrée ou de sortie spécifiques à utiliser pour l'action de votre outil de connecteur, vous pouvez limiter la complexité de ces actions pour l'agent.
Par exemple, si vous n'avez besoin de créer une entité qu'avec un sous-ensemble de ses champs, la configuration de cet ensemble de champs dans votre action simplifie l'action pour l'agent.
La spécification d'un ensemble de champs de sortie réduit la taille de la réponse de l'outil (utile si les limites de jetons sont un problème) et simplifie la gestion de la sortie par l'agent en n'exposant que les champs pertinents.
Authentification
Si la connexion que vous utilisez est configurée pour autoriser le remplacement de l'authentification, l'outil peut être configuré pour transmettre les identifiants à partir des paramètres de session spécifiés.
En tant que créateur d'agent, vous êtes responsable de la manière dont ces identifiants sont renseignés dans les paramètres de session. L'outil les transmettra automatiquement à la source de données pour l'authentification lorsque les actions de l'outil seront appelées.