Introdução

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.

No final, você terá UiPathfinder.QuestParser: um agente que recebe apenas uma descrição da busca, decide o que pesquisar, chama a ferramenta Consulta ao Monstro e retorna os campos-chave do Monstruo selecionado, sem a necessidade de uma lista pré-preenchida.

Sem uma ferramenta, o agente depende do chamador para buscar previamente candidatos e passá-los como dados. Adicionar uma ferramenta muda isso: o agente decide no runtime o que pesquisar, chama a API e raciocina sobre resultados ao vivo. Esse é o padrão por trás da maioria dos fluxos de trabalho de agente de produção; o valor do agente vem de sua capacidade de buscar e raciocinar, não apenas de classificar o que é entregue.

Você fará o seguinte:

1. Build a Monster Query API Workflow that calls the 5e SRD.
2. Conecte-o ao seu agente Seletor de Monstro como uma ferramenta.
3. Atualize o contrato do agente para refletir o novo recurso.
4. Teste o agente completo que usa ferramentas de ponta a ponta.

Tempo estimado: 30 a 45 minutos

O que você está criando

Component	Detalhes
Fluxo de trabalho da API	Accepts searchName (string), calls the Open5e 5e SRD API, returns monsterResults array
Entrada do agente: questDescription	string; a descrição da busca. O agente busca seus próprios candidatos por meio da ferramenta
Saída do agente: monsterIndex	string; the API's key identifier for the selected monster, for example srd_goblin
Saída do agente: monsterName	string; nome de exibição do monitor selecionado
Saída do agente: monsterType	string; creature type (for example, beast, undead, dragon). The API returns this as an object, so the agent reads type.name
Saída do agente: monsterCr	string; challenge rating. The API returns a number, such as 0.25, which the agent renders as text
Saída do agente: monsterReasoning	string; a explicação do agente sobre por que ele selecionou esse robô para a busca

---

Pré-requisitos

• Studio Web - é executado no seu navegador; nenhuma instalação na área de trabalho é necessária. Abra o Studio Web no Chrome, Edge ou Firefox antes de iniciar.
• Conta da UiPath — inscreva-se ou faça login no UiPath Automation Cloud antes de começar.
• Node.js 18+ - necessário para instalar a UiPath CLI. Instale a partir do nodejs.org , se necessário.
• UiPath CLI v1.198.0+ - required to deploy the starter. Check with uip --version; install or upgrade with npm install -g @uipath/cli.
• Um agente Seletor de Monstro no Studio Web - este laboratório cria o agente de Introdução aos Agentes da UiPath. Se você concluiu esse laboratório, seu agente já está lá. Se não, implante o inicial:

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

Abra o Studio Web e confirme SeletorDeMonstros aparece no seu espaço de trabalho antes de iniciar a Etapa 1.