Introdução

Estenda um agente UiPath de pouco código com uma ferramenta de fluxo de trabalho de API que consulta o SRD do D&D 5e no runtime.

Este laboratório cria parte do UiPath Finder, um aplicativo de referência com tema de D&D no UiPath. Ele estende um agente criado no laboratório Introdução aos agentes da UiPath . Você cria um conector de API ao vivo que pesquisa o SRD do D&D 5e (Documento de Referência do Sistema) e, em seguida, dá ao seu agente Seletor de Monstros esse conector como uma ferramenta. O agente o usa de forma autônoma no runtime: decidindo o que pesquisar, chamando a API e selecionando a melhor correspondência entre os resultados.

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. Crie um fluxo de trabalho da API API Query do Monstro que chama o SRD do D&D 5e.
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	Aceita searchName (string), chama a API Open5e D&D 5e SRD, retorna a matriz monsterResults
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; identificador de campo de dados dinâmico do robô selecionado
Saída do agente: monsterName	string; nome de exibição do monitor selecionado
Saída do agente: monsterType	string; tipo de criação (por exemplo, ferramenta, undeal, robô)
Saída do agente: monsterCr	string; Classificação do desafio
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.1+ - necessário para implantar o inicial. Verifique com uip --version.
• 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.