Rufen Sie Agent auf

Rufen Sie einen Microsoft Azure AI Foundry-Agent auf, der auf der Antwort-API in einem Maestro Agent-Prozess basiert.

Beschreibung

Diese Aktivität ermöglicht die Verwendung von Microsoft Azure AI Foundry-Agents, die auf der Antwort-API basieren, als Teilnehmer an einem automatisierten Prozess, der von Maestro orchestriert wird.

Oberfläche des Foundry-Agents

Azure AI Foundry stellt zwei separate Agent-Oberflächen auf demselben Projektendpunkt bereit:

• Assistants (klassisch) – wurden über die /assistants API erstellt. Verwenden Sie dafür die Aktivität Thread ausführen .
• Agents (Foundry-Portal) – werden im Azure AI Foundry-Portal erstellt und über die Responses-API aufgerufen. Verwenden Sie dafür Invoke Agent .

Hinweis:

Nur Agents des Typs „Prompt“ und „Gehostet“ sind für die Arbeit mit dieser Aktivität verifiziert. Agents der Art Workflow oder extern wurden nicht validiert und haben keine Bestätigung, dass sie funktionieren.

Wie die Aktivität verwendet wird

Um diese Aktivität in einem Maestro-Prozess zu verwenden, führen Sie folgende Schritte aus:

1. Fügen Sie ein Dienstaufgabenelement zur Arbeitsfläche hinzu und öffnen Sie den Eigenschaftenbereich der Aufgabe.

2. Wählen Sie im Abschnitt Implementierung in der Dropdownliste Aktion die Option Starten und auf einen externen Agent warten.

3. Wählen Sie den Microsoft Azure AI Foundry- Connector aus.

4. Wählen Sie eine vorhandene Verbindung aus oder erstellen Sie eine neue. Weitere Informationen finden Sie unter Microsoft Azure AI Foundry-Authentifizierung.

5. Wählen Sie unter Aktivität die Option Agent aufrufen aus.

6. Wählen Sie unter Agent einen Agent aus der Liste der Agents in Ihrem Azure AI Foundry-Projekt aus. Jeder Eintrag zeigt die Art des Agents neben seinem Namen, z. B. ah-vo-script-agent (hosted).

7. Geben Sie unter Nachricht den Prompt ein, der an den Agent gesendet werden soll.

8. Verbinden Sie das Startereignis mit der Dienstaufgabe und die Dienstaufgabe mit einem Endereignisknoten in der Canvas.

9. Wählen Sie Debuggen , um diesen Prozess auszuführen.

   Die Aktivität wird immer asynchron ausgeführt: Integration Service ruft die Antwort des Agents ab und setzt den Maestro-Schritt fort, sobald die Ausführung abgeschlossen ist.

Ausgabe

Parameter	Beschreibung
Antwortbezeichner	Eindeutiger Bezeichner der Agent-Antwort.
Status	Aktueller Status der Antwort: queued, in_progress, completed, failed oder incomplete.
Output text	Der Antworttext des Agenten.
Modellbezeichner	Das Modell, das die Antwort erzeugt hat.
Fehlercode	Fehlercode, wenn die Ausführung nicht erfolgreich abgeschlossen wurde (status ist failed). Bei Erfolg leer.
Fehlermeldung	Für Menschen lesbarer Grund, warum die Ausführung fehlgeschlagen ist (status ist failed). Bei Erfolg leer.
Unvollständiger Grund	Warum die Ausführung unvollständig beendet wurde (status ist incomplete), z. B. content_filter oder max_output_tokens. Bei Erfolg leer.
Verwendete Eingabetoken	Anzahl der verbrauchten Eingabetoken.
Verwendete Ausgabetoken	Anzahl der erzeugten Ausgabetoken.
Insgesamt verwendete Token	Gesamtzahl der während der Anforderung verbrauchten Token.

Weisen Sie die Ausgabe einer Prozessvariablen zu, damit sie den Fortschritt des Maestro-Prozesses beeinflussen kann, z. B. um bei Status zu verzweigen oder die Antwort aus Ausgabetext zu verwenden.

Hinweis:

Die Antwortzeit der Aktivität hängt vom Abrufintervall der Verbindung ab, das standardmäßig 5 Minuten beträgt. Eine abgeschlossene Ausführung kann daher langsamer als ihre tatsächliche Abschlusszeit angezeigt werden.