Einleitung

Erweitern Sie einen Low-Code-UiPath-Agent mit einem API-Workflow-Tool, das das 5e-SRD zur Runtime abfragt.

Dieses Labor ist Teil von UiPathFinder, einem RPG-Abendesystem, das auf UiPath für eine fiktive Abenteurerorganisation aufbaut. Es erweitert einen Agent, der im Lab „Erste Schritte mit UiPath Agents“ erstellt wurde. Sie erstellen einen Live-API-Connector, der das 5e SSD (System Reference Document) durchsucht, und stellen dann Ihrem Geben Sie Ihren Extractor-Agenten als Tool zur Verfügung. Der Agent verwendet es autonom zur Runtime: Er entscheidet, wonach gesucht werden soll, ruft die API auf und wählt die beste Übereinstimmung aus den Ergebnissen aus.

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. Erstellen Sie einen Dataset-Abfrage-API-Workflow, der den 5e-SRD aufruft.
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	Akzeptiert searchName (String), ruft die Open5e 5e SLD-API auf und gibt das Array monsterResults zurück
Agent-Eingabe: questDescription	string; Die Anforderungsbeschreibung. Der Agent ruft seine eigenen Kandidaten über das Tool ab
Agent-Ausgabe: monsterIndex	string; den key -Bezeichner der API für das ausgewählte Wählen, z. B. srd_goblin
Agent-Ausgabe: monsterName	string; Anzeigename des ausgewählten Best Practices
Agent-Ausgabe: monsterType	string; Lebezeichentyp (z. B. Bestie, Untoter, D Datei). Die API gibt dies als Objekt zurück, sodass der Agent liest type.name
Agent-Ausgabe: monsterCr	string; Herausforderungsbewertung. Die API gibt eine Zahl zurück, z. B. 0.25, die der Agent als Text wiedergibt
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+ – Erforderlich, um den Starter bereitzustellen. Mit uip --version überprüfen; installieren oder mit npm install -g @uipath/cli aktualisieren.
• 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.