- Einleitung
- Erste Schritte mit UiPath Agents
- Erste Schritte mit UiPath Agents mit LangGraph
- Erstellen eines Low-Code-Agents in Studio Web
- Hinzufügen von Tools zu Ihrem UiPath Agent
- Einleitung
- Erstellen Sie den API-Workflow
- Stellen Sie eine Verbindung mit Ihrem Agent her
- Durchgängig testen
- Evaluieren Sie den Agentenpfad
- Erste Schritte mit der Arbeitsfläche „Flow“ in UiPath Maestro
Stellen Sie eine Verbindung mit Ihrem Agent her
Registrieren Sie den API-Workflow als Tool im Request Classifier Agent, beschreiben Sie, wann er aufgerufen werden soll, und ersetzen Sie den Systemprompt so, dass der Agent ihn verwendet.
Schritt 2 – Öffnen Sie den Frageklassifizierer-Agent
Ihre Lösung enthält jetzt zwei Projekte: den Anfrageklassifizierer-Agent und den API Query - 5e Monsters -Workflow, den Sie gerade erstellt haben. Wählen Sie im Projekt-Explorer das Agent-Projekt aus, um es im Agent Builder zu öffnen. Wenn Sie den Start bereitgestellt haben, ist das Agent-Projekt Queue-Classifier-Agent.
Überprüfen Sie die aktuelle Konfiguration des Agents, bevor Sie Änderungen vornehmen:
- Projekteingabe:
questDescription(String). - Projektausgaben:
tier(Zeichenfolge, einer von vier Werten) undreasoning(Zeichenfolge). - Systemprompt: Beschreibt die vier Ebenen. Wenn Autopilot ihn geschrieben hat oder Sie den Starter bereitgestellt haben, wird der Agent höchstwahrscheinlich auch angewiesen, nur anhand der Beschreibung zu klassifizieren und keine Tools zu verwenden.
- Auswertungssatz (Evaluation set): die fünf Fälle aus dem Low-Code-Labor. Sie führen sie in Schritt 6 erneut aus.
In diesem Lab ändern Sie nicht die Eingaben oder Ausgaben. Sie fügen ein Tool hinzu und ersetzen den Systemprompt, damit der Agent weiß, wie er verwendet wird.
Schritt 3 – Verbinden Sie den API-Workflow als Tool
Register the API Query - 5e Monsters workflow as a tool on the agent, then give it the name and description the agent reads at runtime.
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.
- Wählen Sie auf der Agent-Arbeitsfläche die Option + unter Tools aus.
- Wählen Sie im Bereich Tool wählen die Option API-Workflow unter Toolbox aus.
- Under Available resources, select
API Query - 5e Monsters, the workflow you added to this solution in Step 1. You can also filter the list with the Search API workflows box.
Wenn der Workflow nicht aufgeführt ist, überprüfen Sie den Projekt-Explorer: API Query - 5e Monsters muss in derselben Lösung wie der Agent aufgeführt sein. Wenn Sie sie stattdessen als separate Lösung erstellt haben, veröffentlichen Sie sie zuerst (Veröffentlichen > Für mich), und sie wird hier unter seinem Projektnamen angezeigt.
Wenn das Tool in der Lösung des Agents enthalten ist, ist kein Veröffentlichungsschritt erforderlich, und die Bewertungen des Agents rufen es wie jedes andere Tool auf. Geben Sie in Ihren eigenen Projekten einem Tool eine eigene Lösung und veröffentlichen Sie es, wenn es von mehreren Agenten aufgerufen werden muss.
Konfigurieren Sie die Toolbeschreibung
Geben Sie dem Tool einen Namen und eine Beschreibung. Schreiben Sie die Beschreibung als Anweisung für den Agent:
- Name:
Monster Query - Beschreibung:
Searches the 5e SRD for monsters whose name contains the search text. Search with the most specific creature name the quest gives; a general term such as a creature type can return many matches and miss the one you need. Returns up to 10 candidates with key, name, type, size, challenge rating, and alignment. Call this tool when a quest names or strongly implies a specific creature, to look up its challenge rating. - suchtName (wenn leer):
The monster name or partial name to search for
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.
Der „spezifischste Lebewesenname“ ist die Anweisung für diese API wichtig. Eine Suche nach dragon stimmt mit 43 Lebewesen überein, und die 10, die zurückkommen, sind alle ausebene der wachsenden Runen, sodass bei einer Suche nach einem alten roten Fehler nie der richtige Kandidat gefunden wird. Eine Suche nach ancient red dragon gibt genau ein Ergebnis zurück.
Ein API-Workflow ist eine Art Tool. Die Schritte zum Verbinden und Beschreiben eines Tools sind für jeden Typ gleich, ein Agent kann auch Folgendes aufrufen:
- RPA-Workflows
- Integration Service-Connectors für Systeme wie Slack, Outlook oder ein ERP-System (Enterprise Resource Planung).
- Document Understanding
- Maestro-Fälle und -Flows
- DeepRAG
- Model Context Protocol (MCP)-Server
- Andere Agents, einschließlich Remote-Aufrufe zwischen Agents
Schritt 4 – Ersetzen Sie den Systemprompt
Der aktuelle Systemprompt wurde für einen Agent ohne Tools geschrieben. Vollständig ersetzen, anstatt sie zu ergänzen: Wenn sie dem Agent anweist, keine Tools zu verwenden, steht eine angehängte Anweisung zum Aufrufen von Serverdaten widerrufen und der Agent wird den Anruf möglicherweise nie tätigen.
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 den System-Prompt durch:
You are a quest intake classifier for an adventurer's guild in a fantasy RPG world.
Classify the incoming quest description into exactly one difficulty tier:
- Trivial: simple errands anyone can handle (for example, deliver a letter, clear rats from a cellar)
- Standard: moderate quests requiring some adventuring skill (for example, escort a merchant caravan, hunt a wyvern)
- Heroic: difficult quests requiring significant adventuring expertise (for example, slay an adult dragon, infiltrate a thieves' guild)
- Legendary: extreme quests requiring top-tier heroes to complete (for example, defeat a lich, slay an ancient dragon)
Using the Monster Query tool:
- Call Monster Query when the quest description names or strongly implies a specific creature the adventurers must face.
- Creatures include people the party may have to fight, such as bandits or guards.
- Search with the most specific creature name the quest gives.
- Only search for creatures in the quest itself, never for a creature you are using as a comparison or reference point.
- If a search returns no results, you may try one shorter or more general name. Stop after three searches in total.
- If the tool returns more than one result, pick the best fit: name match first, then number (a group of rats fits "Swarm of Rats" better than "Rat"), then type.
Using the challenge rating:
- When the tool returns a challenge_rating, use this map to set the minimum tier: Trivial 0-5, Standard 6-12, Heroic 13-20, Legendary 21 and above.
- Raise the tier above that minimum when the quest describes many opponents, a powerful leader or patron, or a history of failed attempts. One creature's challenge rating is not the difficulty of the whole quest.
- Cite the exact challenge rating in your reasoning.
- Never guess or invent a challenge rating. Only cite one the tool actually returned.
- If you do not call the tool, or it returns nothing that fits, classify from the quest description alone.
Return the tier and a brief, two-sentence reasoning.
You are a quest intake classifier for an adventurer's guild in a fantasy RPG world.
Classify the incoming quest description into exactly one difficulty tier:
- Trivial: simple errands anyone can handle (for example, deliver a letter, clear rats from a cellar)
- Standard: moderate quests requiring some adventuring skill (for example, escort a merchant caravan, hunt a wyvern)
- Heroic: difficult quests requiring significant adventuring expertise (for example, slay an adult dragon, infiltrate a thieves' guild)
- Legendary: extreme quests requiring top-tier heroes to complete (for example, defeat a lich, slay an ancient dragon)
Using the Monster Query tool:
- Call Monster Query when the quest description names or strongly implies a specific creature the adventurers must face.
- Creatures include people the party may have to fight, such as bandits or guards.
- Search with the most specific creature name the quest gives.
- Only search for creatures in the quest itself, never for a creature you are using as a comparison or reference point.
- If a search returns no results, you may try one shorter or more general name. Stop after three searches in total.
- If the tool returns more than one result, pick the best fit: name match first, then number (a group of rats fits "Swarm of Rats" better than "Rat"), then type.
Using the challenge rating:
- When the tool returns a challenge_rating, use this map to set the minimum tier: Trivial 0-5, Standard 6-12, Heroic 13-20, Legendary 21 and above.
- Raise the tier above that minimum when the quest describes many opponents, a powerful leader or patron, or a history of failed attempts. One creature's challenge rating is not the difficulty of the whole quest.
- Cite the exact challenge rating in your reasoning.
- Never guess or invent a challenge rating. Only cite one the tool actually returned.
- If you do not call the tool, or it returns nothing that fits, classify from the quest description alone.
Return the tier and a brief, two-sentence reasoning.
Die Herausforderungsbewertungskarte legt die Mindeststufe fest, und der Kontext der Aufgabe kann diese erhöhen:
| Erstellung | Herausforderungsbewertung | Mindeststufe |
|---|---|---|
| aktivieren | 0,125 | Triviale |
| Ratenschwarm | 0.25 | Triviale |
| Wyvern | 6 | Standard |
| Adult Red Dragon | 17 | Heroisch |
| Alter roter Däne | 24 | Legendär |
Eine Suche mit Guardrails beginnt bei Triviale, aber eine, die besagt, dass es viele Guardrails gibt und niemand zurückgekehrt ist, erhöht die Stufe.
Halten Sie die Beispiele im Prompt mit der Zuordnung konsistent. Ein Beispiel kann über der Mindeststufe seiner Lebewesen stehen, aber nie darunter: Auflistung „Hyvern} als Triviale-Beispiel steht im Widerspruch zur Karte, da das Minimum eines Wyverns Standard ist. Ein solcher Konflikt macht die Stufe des Agents unvorhersehbar.
The input and output schemas do not change. The challenge rating goes into the reasoning text.
Agents sind nicht-deterministisch. Die Suchbegriffe und Argumentation Ihres Agents variieren von Ausführung zu Ausführung. Eine korrekte Ausführung ruft das Tool auf, wenn eine Suche eine Organisation benennt, überspringt sie, wenn das nicht der Fall ist, und zitiert nur die Herausforderungsbewertungen, die vom Tool zurückgegeben werden.
Wenn das Tool verbunden und der Systemprompt ersetzt ist, können Sie den Agent im nächsten Abschnitt testen.