Un agent peut utiliser les 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, vous pouvez créer plusieurs outils pour une même 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
- Annonces Meta
- 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 :
- Dans Agent Builder, accédez à Outils > Créer.
- Sélectionnez le type d'outil Connecteur d'intégration.
- Sélectionnez le type de connecteur de votre choix.
- Utilisez 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 du 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, comme "Order" ou "Case").
Vous pouvez effectuer des opérations CRUD sur chaque entité :- Créer : crée une entité avec les valeurs de champ spécifiées
- Liste : recherche basée sur des filtres pour les instances d'entités
- Mettre à jour : méthode basée sur des filtres pour modifier les valeurs des champs d'entité
- Supprimer : supprime une entité
- Get récupère une seule entité à l'aide de l'entityId
.
Pour en savoir plus sur les opérations CRUD d'entité, consultez la documentation sur les connecteurs.
- Créer : crée une entité avec les valeurs de champ spécifiées
Actions spécifiques aux connecteurs
De nombreux connecteurs sont compatibles avec l'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 la liste des 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 l'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.
Spécifier 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 le traitement 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'agents, vous êtes responsable de la façon 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 sont appelées.