Introdução

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

Este laboratório cria parte do UiPath Finder, um sistema de ação de VPN criado na UiPath para uma desenvolvedora de runtime fictícia. Ele estende um agente criado no laboratório Introdução aos agentes da UiPath . Você cria um conector de API em tempo real que pesquisa o SRD 5e (Documento de Referência do Sistema) e, em seguida, dá ao seu agente Seletor Monstro 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 Typery API que chama o SRD 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 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; o identificador key da API para o robô selecionado, por exemplo, srd_goblin
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ô). A API retorna isso como um objeto, então o agente lê type.name
Saída do agente: monsterCr	string; classificação de desafio. A API retorna um número, como 0.25, que o agente renderiza como texto
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+ - necessário para implantar o inicial. Verificar com uip --version; instalar ou atualizar com 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.