Documentazione dell'infrastruttura Oracle Cloud

Gestione degli strumenti di chiamata degli endpoint API negli agenti AI generativa

Uno strumento di chiamata degli endpoint API è uno strumento personalizzato negli agenti AI generativa che consente di integrare e chiamare in modo sicuro le API OCI e le tue API REST. Solo le connessioni HTTPS (protette) sono consentite dagli agenti AI generativa.

Utilizzando gli strumenti di chiamata degli endpoint API, puoi rendere un agente una potente estensione delle API e della business logic esistenti senza integrazioni o modifiche personalizzate ai tuoi sistemi backend. Attraverso uno schema OpenAPI caricato che descrive la struttura e il funzionamento delle operazioni API, gli agenti AI generativa possono selezionare e richiamare dinamicamente l'endpoint e il metodo API appropriati durante una chat in linguaggio naturale.

Le API possono essere ospitate in reti pubbliche o private. Tutto il traffico HTTP pubblico o privato in uscita viene instradato tramite una subnet nella rete cloud virtuale (VCN) OCI. Le operazioni API possono essere richieste con l'autenticazione o senza l'utilizzo di un metodo di autenticazione, quindi eseguite all'interno dei limiti e delle regole di sicurezza della rete.

Aggiungendo gli strumenti di chiamata degli endpoint API a un agente in Generative AI Agents, l'agente può chiamare le API esistenti per eseguire task quali il recupero dei dati dei clienti, l'aggiornamento degli stati degli ordini, l'attivazione dei flussi di lavoro o il controllo dell'inventario. Ad esempio, un agente di supporto potrebbe risolvere un ticket cercando un account utente e iniziando un rimborso, il tutto tramite chiamate API.

Prima di iniziare

Prima di creare uno strumento di chiamata endpoint API, assicurarsi di rivedere le Linee guida per lo strumento di chiamata endpoint API e di completare i task necessari.

Gestisci strumenti di chiamata endpoint API

Se si dispone delle autorizzazioni manage per genai-agent-family, è possibile creare e gestire gli strumenti di chiamata degli endpoint API negli agenti AI generativa. Vedere i seguenti collegamenti:

Consulta l'esempio in Chiamata di endpoint API con SDK negli agenti AI generativa per scoprire come creare e richiamare uno strumento di chiamata di endpoint API utilizzando l'SDK Java OCI.