Strumenti di Integration Connectors

Gli strumenti del connettore possono essere utilizzati da un agente per eseguire azioni utilizzando le tue connessioni configurate in Integration Connectors. Ogni strumento connettore è configurato con una singola connessione e una o più azioni. Se necessario, è possibile creare più strumenti per una singola connessione per raggruppare diverse azioni che l'agente può utilizzare.

Lo strumento connettore supporta i seguenti tipi di connettore:

Crea una connessione

Per creare una connessione:

  • Passa dal generatore di agenti a Strumenti > Crea.
  • Seleziona il tipo di strumento Connettore di integrazione
  • Seleziona il tipo di connettore che preferisci.
  • Utilizza il pulsante Crea connessione.

In questo modo, verrà visualizzata la creazione di Integration Connectors con un numero di campi precompilati.

In alternativa, puoi andare a Integration Connectors e seguire le istruzioni per creare una connessione.

Azioni del connettore

Per ogni strumento connettore, sono disponibili due tipi di azioni che possono essere rese disponibili per l'agente (per ulteriori informazioni, vedi Entità, operazioni e azioni):

  1. Operazioni CRUD delle entità

    Ogni connessione ha "entità" corrispondenti agli oggetti di quell'origine dati (per BigQuery, si tratta di tabelle; per Salesforce, si tratta di oggetti, come "Ordine" o "Richiesta").

    Puoi eseguire operazioni CRUD su ogni entità:

    • Create: crea un'entità con i valori dei campi specificati
    • Elenco: ricerca basata su filtri delle istanze delle entità
    • Aggiornamento: metodo basato sui filtri per modificare i valori dei campi delle entità
    • Elimina: elimina un'entità
    • Get recupera una singola entità utilizzando entityId

    Scopri di più sui dettagli delle operazioni CRUD delle entità nella documentazione di Connettori.

  2. Azioni specifiche del connettore

    Molti connettori supportano un'azione "ExecuteCustomQuery", che consente di eseguire una query SQL sull'origine dati, in cui ogni entità dell'origine dati può essere referenziata come tabella. Consulta questo elenco per i connettori supportati.

    Le azioni aggiuntive variano in base al tipo di connettore. Ad esempio, consulta le azioni del connettore BigQuery o le azioni del connettore Salesforce.

Configurazione dei campi di input / output per le operazioni CRUD

Selezionando campi di input o output specifici da utilizzare per l'azione dello strumento connettore, puoi limitare la complessità di queste azioni per l'agente.

Ad esempio, se devi creare un'entità solo con un sottoinsieme dei suoi campi, la configurazione di questo insieme di campi nell'azione semplifica l'azione per l'agente.

La specifica di un insieme di campi di output riduce le dimensioni della risposta dello strumento (utile se i limiti dei token sono un problema) e semplifica la gestione dell'output da parte dell'agente esponendo solo i campi pertinenti.

Autenticazione

Se la connessione che utilizzi è configurata per consentire l'override dell'autenticazione, lo strumento può essere configurato per trasferire le credenziali dai parametri di sessione specificati.

In qualità di builder dell'agente, sei responsabile della modalità di compilazione di queste credenziali nei parametri di sessione e lo strumento le trasmetterà automaticamente all'origine dati da utilizzare per l'autenticazione quando vengono chiamate le azioni dello strumento.