Funktionen

Codierte Funktionen als Agent-Tools, sodass ein Agent benutzerdefinierten Python-Code als deterministisches, prozessbasiertes Tool neben Automatisierungen und API-Workflows ausführen kann.

Mit dem codierten Funktionstool kann ein Agent benutzerdefinierten Python-Code als Tool ausführen. Eine Funktion kapseln eine deterministische Logik – Datentransformationen, Berechnungen oder Aufrufe an externe Systeme – die der Agent aufruft, wenn seine Argumentation dies erfordert, und argumentiert dann mit dem zurückgegebenen Ergebnis.

Eine codierte Funktion verhält sich wie die anderen prozessbasierten Tools, die einem Agent zur Verfügung stehen, z. B. API-Workflows, Automatisierungen oder Agent-Tools. Der Agent übergibt Eingabeargumente an die Funktion, die Funktion führt ihren Python-Code aus und der Agent erhält die strukturierte Ausgabe.

Funktionen werden in Studio Web erstellt. Weitere Informationen zu Schreib-, Verpackungs- und Veröffentlichungsfunktionen finden Sie im Benutzerhandbuch zu Funktionen.

Wie Agenten Funktionen verwenden

Sobald eine Funktion in Ihrer Lösung verfügbar ist, wird sie als auswählbares Tool im Abschnitt Tools einer Agent-Definition in Studio Web angezeigt. Jedes Tool hat eine Beschreibung, die dem Agent hilft, seinen Zweck zu verstehen und wann er verwendet werden sollte.

Zur Runtime übergibt der Agent Eingabeparameter an die Funktion, die Funktion führt ihre Python-Logik aus und das Ergebnis wird als strukturierte Ausgabe für den nächsten Schritt im Plan an den Agent zurückgegeben. Da es sich bei der Logik um einen deterministischen Code handelt, gibt eine Funktion dieselbe Ausgabe für dieselbe Eingabe zurück, wodurch sie für präzise Vorgänge geeignet ist, die das Sprachmodell nicht ausschließlich durch Argumentation ausführen sollte.

Wie andere Tooltypen unterstützen codierte Funktionen die Governance-Steuerelemente der Plattform. Sie können Leitplanken einrichten, um zu steuern, wann und wie eine Funktion aufgerufen wird, und Toolsimulationen nutzen , um die Argumentation des Agents zu testen, ohne den echten Code auszuführen.

Hinzufügen einer Funktion als Tool

Sie können eine vorhandene Funktion aus Ihren verfügbaren Ressourcen hinzufügen oder eine neue erstellen, ohne den Agent zu verlassen.

1. Wählen Sie vom Bereich Definition aus im Abschnitt Tools die Option Tool hinzufügen.
2. Funktion auswählen.
3. Fügen Sie die Funktion hinzu:
   • Um eine vorhandene Funktion zu verwenden, suchen Sie nach ihr oder wählen Sie sie aus den verfügbaren Ressourcen aus.
   • Um eine neue Funktion zu erstellen, wählen Sie Neu erstellen aus. Der Assistent zum Erstellen von Funktionen wird innerhalb der Lösung geöffnet.
4. Verwenden Sie den System-Prompt, um den Zweck der Funktion zu beschreiben und wann der Agent sie verwenden soll. Geben Sie für alle Argumente eine Beschreibung an, damit der Agent sie effektiv verwenden kann.

Ausführung der Funktion überwachen

Wenn ein Agent ein codiertes Funktionstool ausführt, können Sie die Ausführung an zwei Stellen überprüfen:

• Agent-Ablaufverfolgung – Nach einer Debug-Ausführung enthält der Ausführungspfad einen Toolaufruf für die Funktion, der die an sie übergebenen Eingabeargumente und die zurückgegebene Ausgabe zeigt.
• Orchestrator – Die Funktion wird als Prozess ausgeführt. Unter Überwachung > Aufträge in Orchestrator wird die Funktion als Auftrag zusammen mit den anderen Auftragsausführungen des Agents angezeigt.