Strumenti

Gli strumenti vengono utilizzati per connettere l'agente a sistemi esterni o al codice inline fornito all'agente. In questo modo, l'agente può interagire con altri sistemi per recuperare, aggiornare, formattare o analizzare le informazioni. Le sezioni di questa pagina descrivono i vari tipi di strumenti supportati.

Crea uno strumento

Per creare uno strumento:

  1. Fai clic sull'icona dello strumento sul lato destro del generatore di agenti.
  2. Seleziona un tipo di strumento (vedi le descrizioni dei tipi di strumenti in questo documento).
  3. Fornisci le informazioni richieste per lo strumento.
  4. Utilizza snake case per il nome dello strumento.
  5. Le descrizioni degli strumenti vengono fornite ai modelli di agenti.

Utilizzare uno strumento in un agente

Dopo aver creato uno strumento, devi istruire un agente specifico a utilizzarlo.

  1. Passa il mouse sopra un agente.
  2. Fai clic su Aggiungi strumento.
  3. Seleziona uno strumento.
  4. Descrivi come deve essere utilizzato lo strumento nelle istruzioni dell'agente.

Testare uno strumento

Prima di utilizzare uno strumento nell'agente, puoi testarlo nella console:

  1. Apri il riquadro degli strumenti.
  2. Fai clic sul pulsante Strumento di test nella parte superiore del riquadro.

  3. Fornisci l'input per lo strumento come definito dallo schema dello strumento. Ad esempio, se lo schema è JSON con le proprietà place e city, puoi utilizzare il seguente input:

    {
  "place": "automobile repair center",
  "city": "austin texas"
}

  4. Fai clic su Invia. Lo strumento viene eseguito con l'input e l'output viene compilato.

Dopo aver testato direttamente lo strumento, puoi testarlo anche utilizzando l'agente di anteprima.

Strumenti disponibili

Sono disponibili i seguenti strumenti:

Strumento Descrizione
Protocollo A2A Collega il tuo agente ad agenti esterni utilizzando lo standard di messaggistica A2A. (Anteprima)
Agente come strumento Riutilizza le funzionalità degli agenti senza trasferirle a un altro agente.
Strumenti per le funzioni client Strumenti di codifica eseguiti lato client, non dall'agente.
Strumenti Confluence Collega l'agente a un'istanza Confluence.
Strumenti per il datastore Fornisci risposte dell'agente generate con l'AI in base ai contenuti del sito web e ai dati caricati.
Strumenti di ricerca dei file Caricare un file o fornire una knowledge base RAG a un agente.
Strumenti di Google Maps Collega il tuo agente a Google Maps. (Anteprima)
Strumenti della Ricerca Google Connetti il tuo agente alla potenza del grounding con la Ricerca Google.
Strumenti di Integration Connectors Crea strumenti che utilizzano le connessioni configurate.
Strumenti Jira Collega l'agente a un'istanza Jira.
Strumenti MCP Connettiti a un server MCP.
Strumenti OpenAPI Connettiti a un'API esterna utilizzando uno schema OpenAPI.
Strumenti per il codice Python Fornisci il codice Python come strumento per l'agente.
Strumenti Salesforce Collega l'agente a un'istanza Salesforce.
Strumenti Service Now Connetti l'agente a un'istanza di Service Now.
Strumenti di SharePoint Collega l'agente a un'istanza di SharePoint.
Strumenti di sistema Strumenti integrati che possono essere utilizzati dall'agente per eseguire attività comuni.
Strumenti per i widget Strumenti per widget flessibili per creare interazioni utente avanzate.

Tipo di esecuzione

Gli strumenti supportano due tipi di esecuzione: asincrona (non bloccante) e sincrona (bloccante). La selezione del tipo di esecuzione appropriato dipende dalla latenza dello strumento e dall'esperienza dell'agente desiderata. Questa impostazione è disponibile nella scheda Avanzate della configurazione dello strumento.

Tipo di esecuzione sincrona

Questo tipo deve essere utilizzato quando l'esecuzione dello strumento deve bloccare la generazione di risposte dell'agente finché la risposta dello strumento non è disponibile. L'agente non genererà alcuna risposta finché non sarà disponibile la risposta dello strumento. Idealmente, questi strumenti dovrebbero avere una latenza bassa (inferiore a 5 secondi) per mantenere bassa la latenza complessiva della risposta dell'agente.

Tipo di esecuzione asincrona

Questo tipo deve essere utilizzato per l'esecuzione non bloccante degli strumenti. Quando viene attivata una chiamata di strumenti, l'agente procederà con una risposta "in attesa". L'agente può continuare a parlare con l'utente mentre viene recuperata la risposta dello strumento. Una volta disponibile, la risposta viene aggiunta al contesto la volta successiva che viene generata una risposta dell'agente. Ideale per strumenti con latenze di risposta di 5-60 secondi.

Flusso di conversazione per il tipo di esecuzione asincrona:

  1. L'agente attiva la chiamata di funzione: L'agente attiva una chiamata di funzione ed è in attesa di risposta. Ad esempio, richiama lo strumento di stato dell'ordine.
  2. Strumento in attesa di risposta: Lo strumento restituisce immediatamente un function_response contenente uno stato in attesa, ad esempio "status": "pending".
  3. L'agente gestisce lo strumento in attesa: L'agente deve essere istruito a gestire le risposte in attesa come desiderato. Istruzione di esempio: "Chiedi all'utente se ha altre domande mentre recuperi lo stato dell'ordine". Risposta dell'agente di esempio: "C'è altro che posso fare per te mentre recupero lo stato dell'ordine?".

  4. L'agente gestisce la risposta finale: La risposta effettiva dello strumento è disponibile per l'agente. che verrà incluso come tag di contesto. Ad esempio:

    <context>function [<tool_name>] completed with response <response JSON></context>

Best practice

Utilizza le seguenti best practice per gli strumenti:

  • Scrivi sempre nomi di strumenti semanticamente significativi e pertinenti all'attività che svolgono.
  • Fornisci sempre descrizioni di alta qualità dei tuoi strumenti e delle attività che sono in grado di svolgere.
  • Per gli strumenti asincroni, includi istruzioni dettagliate per i seguenti scenari:
    • Comunica all'agente che è uno strumento asincrono e inizialmente restituirà una risposta in attesa.
    • Includi istruzioni su come l'agente deve rispondere quando lo strumento restituisce "In attesa".
    • Includi istruzioni su come l'agente deve rispondere quando la risposta effettiva dello strumento è disponibile.
    • Includi istruzioni su come l'agente deve rispondere se lo strumento restituisce un errore.