Oracle Cloud Infrastructure-Dokumentation

API-Endpunktaufruftools in Generative AI Agents verwalten

Ein API-Endpunktaufruf-Tool ist ein benutzerdefiniertes Tool in Generative AI Agents, mit dem Sie OCI-APIs und Ihre eigenen REST-APIs sicher integrieren und aufrufen können. Nur HTTPS-(gesicherte) Verbindungen sind von Generative AI Agents zulässig.

Mit API-Endpunktaufruf-Tools können Sie einen Agent zu einer leistungsstarken Erweiterung Ihrer vorhandenen APIs und Geschäftslogik ohne benutzerdefinierte Integrationen oder Änderungen an Ihren Backend-Systemen machen. Über ein hochgeladenes Schema OpenAPI, das die Struktur und das Verhalten der API-Vorgänge beschreibt, können Generative AI Agents den entsprechenden API-Endpunkt und die entsprechende Methode während eines Chats in natürlicher Sprache dynamisch auswählen und aufrufen.

Die APIs können in öffentlichen oder privaten Netzwerken gehostet werden. Der gesamte ausgehende öffentliche oder private HTTP-Traffic wird über ein Subnetz in Ihrem virtuellen OCI-Cloud-Netzwerk (VCN) geleitet. Die API-Vorgänge können mit oder ohne Authentifizierungsmethode angefordert und dann innerhalb der Grenz- und Sicherheitsregeln Ihres Netzwerks ausgeführt werden.

Durch das Hinzufügen von API-Endpunktaufruf-Tools zu einem Agent in Generative AI Agents kann der Agent vorhandene APIs aufrufen, um Aufgaben wie das Abrufen von Kundendaten, das Aktualisieren von Auftragsstatus, das Auslösen von Workflows oder das Prüfen des Bestands auszuführen. Beispiel: Ein Support-Agent kann ein Ticket lösen, indem er ein Benutzerkonto sucht und eine Rückerstattung durch API-Aufrufe initiiert.

Bevor Sie beginnen

Bevor Sie ein API-Endpunktaufruf-Tool erstellen, müssen Sie die Richtlinien für API-Endpunktaufruf-Tools prüfen und alle erforderlichen Aufgaben ausführen.

API-Endpunktaufruf-Tools verwalten

Wenn Sie manage-Berechtigungen für genai-agent-family haben, können Sie API-Endpunktaufruftools in Generative AI Agents erstellen und verwalten. Siehe folgende Links:

Im Beispiel unter API-Endpunktaufruf mit SDKs in Generative AI Agents erfahren Sie, wie Sie ein API-Endpunktaufruftool mit dem OCI-Java-SDK erstellen und aufrufen.