Stellen Sie eine Verbindung mit Ihrem Agent her

Registrieren Sie den API-Workflow als Tool in Ihrem Explorer-Agenten und aktualisieren Sie das Eingabeschema des Agenten.

Sobald der Workflow veröffentlicht wurde, ist er im Agent Builder als verbundenes Tool verfügbar.

Schritt 2 – Öffnen Sie den Server-Selektor-Agent

Navigieren Sie in Studio Web zu Ihrer MongoSelector -Lösung und öffnen Sie sie im Agent Builder.

Nehmen Sie einen Moment Zeit, um sich über den aktuellen Status zu informieren, bevor Sie Änderungen vornehmen:

• Eingabe: questDescription (Zeichenfolge) und monsters (Array von Kandidaten, die vom Aufrufer übergeben wurden)
• Ausgabe: monsterIndex (String): der Slug des ausgewählten Monstros
• Systemprompt: Weist den Agent an, die beste Übereinstimmung aus der bereitgestellten Liste auszuwählen

In diesem Lab entfernen Sie die Eingabe monsters und die Anforderung, Kandidaten vorab auszufüllen. Der Agent ruft sie selbst mit dem Tool ab, das Sie gerade erstellt haben.

---

Schritt 3 – Verbinden Sie den API-Workflow als Tool

Fügen Sie das Tool hinzu

Stellen Sie sicher, dass Sie sich in der Canvas- Ansicht befinden: Verwenden Sie den Umschalter Canvas/Formular oben im Agent Builder. Die Schaltfläche + unter Tools ist nur in der Canvas-Ansicht sichtbar.

1. Wählen Sie auf der Agent-Arbeitsfläche die Option + unter Tools aus.
2. Wählen Sie im Bereich Toolbox die Option API-Workflow aus.
3. Wählen Sie im Bereich Verfügbare Ressourcen den Workflow aus, den Sie in Schritt 1 erstellt haben.

Hinweis:

Verfügbare Ressourcen sind leer? Der Workflow muss veröffentlicht werden, bevor er hier angezeigt wird. Kehren Sie zu Schritt 1 zurück und schließen Sie den Unterschritt In Ihrem Feed veröffentlichen ab, kehren Sie dann zurück und versuchen Sie es erneut.

Konfigurieren Sie die Toolbeschreibung

Geben Sie dem Tool einen Namen und eine Beschreibung. Die Beschreibung ist das, was der Agent zur Runtime liest, um zu entscheiden, wann und wie das Tool aufgerufen werden soll; Schreiben Sie es als Anweisung für den Agent und nicht als Beschriftung für Menschen:

• Name: Monster Query
• Beschreibung: Searches the D&D 5e SRD for monsters matching a name or creature type. Returns up to 10 candidates with name, type, CR, size, alignment, and description. Call this tool when you need to find monster candidates for a quest.

Hinweis:

Die Beschreibung steuert die Auswahl des Tools. Der Agent liest diese Beschreibung – nicht den Toolnamen –, um zu entscheiden, wann und wie das Tool aufgerufen wird. Eine vage Beschreibung führt zu einer vage Toolverwendung. Legen Sie genau fest, was das Tool zurückgibt und wann es verwendet werden soll.

---

Schritt 4 – Aktualisieren Sie den Agentenvertrag

Wenn das Tool verbunden ist, aktualisieren Sie die Definition des Agents, um den neuen Vertrag widerzuspiegeln: Der Agent benötigt keine vorab ausgefüllte Serverliste mehr und gibt jetzt strukturierte Serverdaten einschließlich seiner eigenen Argumentation zurück.

Die drei Änderungen in diesem Schritt arbeiten zusammen: Durch das Entfernen von monsters wird die Abhängigkeit des Agents vom Aufrufer für Daten beendet; Das Ausgabeschema deklariert, was der Agent zurückgibt; Der aktualisierte Prompt teilt dem Agent mit, wie er seine neue Funktion verwenden kann. Keine der drei Optionen funktioniert ohne die anderen.

Um die Definition des Agents zu bearbeiten, wählen Sie den Agent-Knoten auf der Arbeitsfläche, um den Definitionsbereich rechts zu öffnen.

Entfernen Sie Server aus der Eingabe

Entfernen Sie in der Agentendefinition die Eigenschaft monsters aus dem Eingabeschema. Die aktualisierte Eingabe sollte nur questDescription haben.

So entfernen Sie die Eigenschaft monsters :

1. Öffnen Sie im Agent den Data Manager , indem Sie das Symbol „Data Manager öffnen“ in der linken Navigationsleiste auswählen (es sieht aus wie eine Zwischenablage).
2. Der Data Manager- Bereich hat drei Gruppierungen: Eingaben, Ausgaben und Variablen; monsters muss in der Eingabeliste sein.
3. Zeigen Sie auf monsters , um die Symbole zum Bearbeiten und Löschen rechts neben der Beschriftung anzuzeigen: ein Bleistiftsymbol (Bearbeiten) und ein Papierkorbsymbol (Löschen).
4. Wählen Sie das Löschsymbol aus, um monsters zu entfernen.

Sie sollten jetzt nur eine Eingabe haben: questDescription:

Feld	Typ	Erforderlich	Beschreibung
questDescription	string	Ja	Beschreibung der Anforderung

Fügen Sie das Ausgabeschema hinzu

Fügen Sie ein Ausgabeschema mit den fünf Feldern aus der Designtabelle unter Was Sie erstellen hinzu.

Im selben Bereich „Data Manager“ :

1. Zeigen Sie auf den Header Ausgaben , um das Symbol Eigenschaft hinzufügen (+) anzuzeigen.
2. Wählen Sie Eigenschaft hinzufügen aus, um jedes der folgenden Felder hinzuzufügen:

Feld	Typ
monsterIndex	string
monsterName	string
monsterType	string
monsterCr	string
monsterReasoning	string

Hinweis:

monsterReasoning wird durch Agent generiert, nicht über die API. Der Agent schreibt dieses Feld selbst: Es ist die Erklärung des Agents, warum das ausgewählte Best Practice der Anfrage entspricht. Im Gegensatz zu den anderen vier Feldern (die aus den Ergebnissen des Tools stammen) spiegelt monsterReasoning die eigene Beurteilung des Agents wider.

Aktualisieren Sie den System-Prompt

Um den Eigenschaftenbereich zu öffnen, wählen Sie den Agent auf der Arbeitsfläche oder das Schraubenschlüsselsymbol in der oberen rechten Ecke aus. Ersetzen Sie die Systemmeldung durch:

You are a quest classifier for an adventurer's guild. Given a quest description, your job is to find the most thematically appropriate monster from the D&D 5e SRD and to return information about that monster.

When given a quest description:
1. Analyze the quest to determine what kind of creature fits the context - consider creature type, challenge rating, environment, and theme.
2. Call the Monster Query tool with a search term that targets that creature type.
3. Review the returned candidates and select the best fit for the quest.
4. Return the selected monster's key fields and a monsterReasoning that explains why this monster fits the quest.

Always call the Monster Query tool before selecting a monster. Do not guess monster details from memory.

Wichtig:

Codierungs-Agents sind nicht-deterministisch. Ihre Aufforderung führt zu anderen Ergebnissen als das obige Beispiel; das erwartet wird. Wichtig ist, dass der Agent das Tool aufruft, die Kandidaten berücksichtigt und alle fünf erforderlichen Ausgabefelder zurückgibt.

---

Wenn das Tool verbunden und der Agent-Vertrag aktualisiert ist, können Sie die vollständige Pipeline im nächsten Abschnitt testen.