Importazione di strumenti da un OpenAPI

Modifica online

Gli strumenti possono essere aggiunti all'agente da una specifica di OpenAPI. È possibile caricare le specifiche di OpenAPI e selezionare le operazioni che si desidera importare come strumenti. Ogni operazione viene creata come strumento separato.

Aggiunta di strumenti

Innanzitutto, decidere se creare uno strumento OpenAPI direttamente nel sistema o per un agente specifico:

Per creare uno strumento " OpenAPI " nel sistema:

  1. Dal menu Menu, seleziona " Build ".

    In un ambient IBM Cloud, selezionare dall'elenco degli spazi di lavoro quello in cui si desidera creare lo strumento oppure creare un nuovo spazio di lavoro.

  2. Seleziona tutti gli strumenti.

  3. Seleziona uno strumento esistente oppure clicca su Crea strumento+ per aggiungerne uno nuovo.

  4. Selezionare OpenAPI.

Per creare uno strumento " OpenAPI " all'interno di un agente:

  1. Dal menu Menu, seleziona " Build ".

    Per un ambient IBM Cloud, selezionare l'area di lavoro per l'agente dall'elenco delle aree di lavoro.

  2. Seleziona tutti gli agenti.

  3. Trovate e fate clic sul vostro agente.

  4. Dal set di strumenti dell'agente, nella sezione Set di strumenti, fare clic su Aggiungi strumento.

  5. Cliccare OpenAPI.

Quindi, per importare gli strumenti da una specifica di OpenAPI, completare i seguenti passaggi:

  1. Dal set di strumenti dell'agente, nella sezione Set di strumenti, fare clic su Aggiungi strumento.

  2. Dal menu Aggiungi uno strumento, selezionare l'opzione OpenAPI opzione.

  3. Trascinate il vostro file OpenAPI per caricarlo. Una volta caricato il file, fare clic su Avanti.

  4. Selezionare le operazioni che si desidera creare come strumenti, quindi fare clic su Avanti.

  5. Eseguire una delle seguenti operazioni per associare le connessioni alla specifica OpenAPI :

    • Scegliere una connessione disponibile.

    • Fare clic su Aggiungi nuova connessione per crearne una nuova. È necessario fornire i dettagli della connessione per configurarla nella finestra Aggiungi nuova connessione.

  6. Fare clic su Eseguito.
Suggerimento:

Ora è possibile modificare la configurazione di uno strumento importato per collegarlo a una connessione diversa. Questa flessibilità consente di rispondere alle modifiche dell'autenticazione o dell'ambiente senza dover ricreare lo strumento. Per ulteriori informazioni, consultare la panoramica dei tipi di autenticazione.

Cosa fare successivamente

Una volta aggiunto uno strumento, un agente può iniziare a utilizzarlo. Dopo aver aggiunto gli strumenti, considerare quanto segue:

  • Aggiornare la descrizione dello strumento. L'agente utilizza il campo di descrizione dello strumento per determinare se utilizzerà lo strumento e come lo utilizzerà. Assicuratevi di fornire una descrizione dettagliata di come l'agente può utilizzare lo strumento. Per aggiornare la descrizione dello strumento, fare clic sul menu dello strumento e selezionare Modifica dettagli. Quando si è soddisfatti della descrizione, fare clic su Salva. È possibile continuare a iterare la descrizione, mentre si testa lo strumento.

  • Testate lo strumento. Per testare lo strumento, utilizzare il prompt nella finestra di chat di anteprima per richiamare lo strumento.

  • Assicurarsi che il valore restituito da uno strumento Python corrisponda al tipo di dati definito per quello strumento.