Integration Connectors-Tools

Connector-Tools können von einem Agent verwendet werden, um Aktionen mit Ihren in Integration Connectors konfigurierten Verbindungen auszuführen. Jedes Connector-Tool wird mit einer einzelnen Verbindung und einer oder mehreren Aktionen konfiguriert. Bei Bedarf können mehrere Tools für eine einzelne Verbindung erstellt werden, um verschiedene Aktionen zu gruppieren, die Ihr Agent verwenden soll.

Das Connector-Tool unterstützt die folgenden Connectors-Typen:

• AlloyDB
• Asana
• Azure AD (Entra ID)
• BigQuery
• Hinweise für 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
• E-Mail
• Enterprise License Manager
• Firestore
• FreshBooks
• FTP
• GitHub
• Gmail
• Google Analytics
• Google Kalender
• Google Classroom
• Google Cloud Natural Language
• Google Kontakte
• Google Docs
• Google Formulare
• Google Sheets
• Google Präsentationen
• Greenplum
• Instagram
• Jira Cloud
• Jira Service Management
• Kintone
• Magento
• Mailchimp
• MariaDB
• Meta-Werbung
• Microsoft Teams
• Montag
• 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

Verbindung herstellen

So erstellen Sie eine Verbindung:

• Gehen Sie im Agent Builder zu Tools > Erstellen.
• Wählen Sie den Tooltyp Integrations-Connector aus.
• Wählen Sie den gewünschten Anschlusstyp aus.
• Klicken Sie auf die Schaltfläche Verbindung erstellen.

Sie werden zur Erstellung von Integration Connectors weitergeleitet. Dort sind bereits einige Felder ausgefüllt.

Alternativ können Sie zu Integration Connectors navigieren und der Anleitung zum Erstellen einer Verbindung folgen.

Hinweis :Verbindungen müssen sich am selben Speicherort wie Ihr Agent befinden, damit Sie sie zum Erstellen eines Connector-Tools verwenden können.

Connector-Aktionen

Für jedes Connector-Tool gibt es zwei Arten von Aktionen, die für Ihren Agent verfügbar gemacht werden können (weitere Informationen finden Sie unter Entitäten, Vorgänge und Aktionen):

1. CRUD-Vorgänge für Entitäten
   
   Jede Ihrer Verbindungen hat „Entitäten“, die den Objekten dieser Datenquelle entsprechen (für BigQuery sind das Tabellen, für Salesforce Objekte wie „Bestellung“ oder „Vorgang“).
   
   Sie können CRUD-Vorgänge für jede Entität ausführen:
   

   • Erstellen: Erstellt eine Entität mit den angegebenen Feldwerten
     
   • Liste: Filterbasierte Suche nach Entitätsinstanzen
     
   • Aktualisieren: Filterbasierte Methode zum Ändern von Attributfeldwerten
     
   • Löschen: Löscht eine Entität
     
   • Mit Get wird eine einzelne Entität mit der entityId
     abgerufen.
   Hinweis: Der Get-Vorgang kann nur verwendet werden, um einen einzelnen Datensatz aus einer Entität mit einem Primärschlüssel abzurufen. Häufig ist es praktischer, den List-Vorgang mit einer filterClause zu verwenden, um eine Entität abzurufen.

   Weitere Informationen zu CRUD-Vorgängen für Entitäten finden Sie in der Connectors-Dokumentation.

2. Connectorspezifische Aktionen
   
   Viele Connectors unterstützen die Aktion 'ExecuteCustomQuery', mit der eine SQL-Abfrage für die Datenquelle ausgeführt werden kann. Dabei kann auf jede der Datenquellenentitäten als Tabelle verwiesen werden. Hier finden Sie eine Liste der unterstützten Connectors.
   
   Zusätzliche Aktionen variieren je nach Connectortyp. Beispiele finden Sie unter BigQuery-Connector-Aktionen oder Salesforce-Connector-Aktionen.

Eingabe-/Ausgabefelder für CRUD-Vorgänge konfigurieren

Wenn Sie bestimmte Ein- oder Ausgabefelder für die Connector-Tool-Aktion auswählen, die verwendet werden sollen, können Sie die Komplexität dieser Aktionen für den Agenten begrenzen.

Wenn Sie beispielsweise nur eine Entität mit einer Teilmenge ihrer Felder erstellen müssen, wird die Aktion für den Agent vereinfacht, wenn Sie diese Felder in der Aktion konfigurieren.

Wenn Sie eine Reihe von Ausgabefeldern angeben, wird die Größe der Tool-Antwort reduziert. Das ist hilfreich, wenn Tokenlimits ein Problem darstellen. Außerdem wird die Verarbeitung der Ausgabe durch den Agent vereinfacht, da nur die relevanten Felder verfügbar sind.

Authentifizierung

Wenn die von Ihnen verwendete Verbindung für die Authentifizierungsüberschreibung konfiguriert ist, kann das Tool so konfiguriert werden, dass Anmeldedaten aus angegebenen Sitzungsparametern übergeben werden.

Sie als Agent-Entwickler sind dafür verantwortlich, wie diese Anmeldedaten in die Sitzungsparameter eingefügt werden. Das Tool übergibt sie automatisch an die Datenquelle, die für die Authentifizierung verwendet werden soll, wenn die Aktionen des Tools aufgerufen werden.