Einleitung

Extend a low-code UiPath agent with an API Workflow tool that queries the 5e SRD at runtime.

This lab builds part of UiPathfinder, an RPG Adventure system built on UiPath for a fictional Adventurer's Guild. It extends an agent built in the Getting Started with UiPath Agents lab. You build a live API connector that searches the 5e SRD (System Reference Document), then give your Monster Selector agent that connector as a tool. The agent uses it autonomously at runtime: deciding what to search for, calling the API, and selecting the best match from the results.

Am Ende haben Sie UiPathfinder.QuestParser: einen Agent, der nur eine Anforderungsbeschreibung erhält, entscheidet, nach was gesucht werden soll, ruft das Tool „Monbot-Abfrage“ auf und gibt die Schlüsselfelder des ausgewählten Gebens zurück, ohne dass eine vorab ausgefüllte Liste erforderlich ist.

Ohne ein Tool ist der Agent darauf angewiesen, dass der Aufrufer Kandidaten vorab abruft und sie als Daten weitergibt. Das Hinzufügen eines Tools ändert Folgendes: Der Agent entscheidet zur Runtime, nach was gesucht werden soll, ruft die API auf und argumentiert mit den Live-Ergebnissen. Dies ist das Muster hinter den meisten Workflows in der Produktion. Der Wert des Agents ergibt sich aus seiner Fähigkeit, abzurufen und zu argumentieren – nicht nur zu klassifizieren, was ihm übergeben wird.

Sie werden Folgendes tun:

1. Build a Monster Query API Workflow that calls the 5e SRD.
2. Verbinden Sie es als Tool mit Ihrem Explorer-Agenten.
3. Aktualisieren Sie den Agent-Vertrag, um die neue Funktion widerzuspiegeln.
4. Testen Sie das vollständige Tool durchgängig mit Agent.

Geschätzte Zeit: 30–45 Minuten

Was Sie erstellen

Komponente	Details
API-Workflow	Accepts searchName (string), calls the Open5e 5e SRD API, returns monsterResults array
Agent-Eingabe: questDescription	string; Die Anforderungsbeschreibung. Der Agent ruft seine eigenen Kandidaten über das Tool ab
Agent-Ausgabe: monsterIndex	string; the API's key identifier for the selected monster, for example srd_goblin
Agent-Ausgabe: monsterName	string; Anzeigename des ausgewählten Best Practices
Agent-Ausgabe: monsterType	string; creature type (for example, beast, undead, dragon). The API returns this as an object, so the agent reads type.name
Agent-Ausgabe: monsterCr	string; challenge rating. The API returns a number, such as 0.25, which the agent renders as text
Agent-Ausgabe: monsterReasoning	string; Die Erklärung des Agents, warum er dieses Agent für die Aufgabe ausgewählt hat

---

Voraussetzungen

• Studio Web – wird in Ihrem Browser ausgeführt; keine Desktop-Installation erforderlich. Öffnen Sie Studio Web in Chrome, Edge oder Firefox, bevor Sie beginnen.
• UiPath-Konto – Registrieren Sie sich oder melden Sie sich bei der UiPath Automation Cloud an, bevor Sie beginnen.
• Node.js 18+ – required to install the UiPath CLI. Installieren Sie bei Bedarf über Nodejs.org .
• UiPath CLI v1.198.0+ - required to deploy the starter. Check with uip --version; install or upgrade with npm install -g @uipath/cli.
• Ein Einhorn-Agent in Studio Web – Dieses Projekt baut auf dem Agent von Erste Schritte mit UiPath Agents auf. Wenn Sie dieses Test abgeschlossen haben, ist Ihr Agent bereits vorhanden. Wenn nicht, stellen Sie den Starter bereit:

git clone https://github.com/cliff-simpkins/UiPath-Workshops.git
cd UiPath-Workshops/starters/monster-selector
uip login
uip solution upload .

Öffnen Sie Studio Web und bestätigen Sie, dass Server-Selektor in Ihrem Arbeitsbereich angezeigt wird, bevor Sie mit Schritt 1 beginnen.