Conecte-se ao seu agente

Registre o fluxo de trabalho da API como uma ferramenta em seu agente Seletor de Monstro e atualize o esquema de entrada do agente.

Com o fluxo de trabalho publicado, ele fica disponível no Agent Builder como uma ferramenta conectável.

Etapa 2 - Abrir o agente do Seletor de Monstros

No Studio Web, navegue até sua solução MonsterSeletor e abra-a no Agent Builder.

Aguarde um momento para orientar-se sobre seu estado atual antes de fazer alterações:

• monsters : (string) e questDescription (array de candidatos passados pelo chamador)
• Output: monsterIndex (string): the key of the chosen monster, for example srd_goblin
• Solicitação do sistema: instrui o agente a escolher a melhor correspondência da lista fornecida

Neste laboratório, você remove a entrada monsters e o requisito de preencher previamente os candidatos. O próprio agente os busca usando a ferramenta que você acabou de criar.

---

Etapa 3 - Conecte o fluxo de trabalho da API como uma ferramenta

Adicionar a ferramenta

Certifique-se de que você está na Visualização em tela : use a alternância Tela/Formulário na parte superior do Agent Builder. O botão + em Ferramentas é visível apenas na exibição em Tela.

1. Na tela do agente, selecione + em Ferramentas.

2. In the Choose tool panel, select API workflow under Toolbox.

3. Under Available resources, select the workflow you created in Step 1.

   Your workflow is listed by its project name, nested under a <workspace>/<solution> folder line - so if you renamed the solution in Step 1, look for API Query - 5e Monsters, not the solution name. You can also filter with the Search API workflows box above the list.

Observação:

Available resources empty, or showing "No tools found"? The workflow must be published before it appears here. Return to Step 1 and complete the Publish to your feed sub-step, then come back and try again.

Configure a descrição da ferramenta

Dê um nome e descrição à ferramenta. A descrição é o que o agente lê no runtime para decidir quando e como chamar a ferramenta; escreva como uma instrução para o agente, não como um rótulo para humanos:

• Nome: Monster Query
• Descrição: Searches the 5e SRD for monsters matching a name or creature type. Returns up to 10 candidates with key, name, type, size, challenge rating, and alignment. Call this tool when you need to find monster candidates for a quest.

Observação:

A descrição direciona a seleção de ferramentas. O agente lê essa descrição — não o nome da ferramenta — para decidir quando e como chamar a ferramenta. Uma descrição vaga produz um uso vago de ferramenta. Especifique o que a ferramenta retorna e quando usá-la.

---

Etapa 4 - Atualizar o contrato do agente

Com a ferramenta conectada, atualize a definição do agente para refletir o novo contrato: o agente não precisa mais de uma lista on-line pré-preenchida e agora retorna dados on-line estruturados, incluindo seu próprio raciocínio.

As três alterações nesta etapa funcionam juntas: a remoção de monsters encerra a dependência do agente do chamador para obter dados; o esquema de saída declara o que o agente se compromete em retornar; a solicitação atualizada informa ao agente como usar seu novo recurso. Nenhum dos três funciona sem os outros.

Para editar a definição do agente, selecione o nó do agente na tela para abrir o painel de definição à direita.

Remover mostrados da entrada

Na definição do agente, remova a propriedade monsters do esquema de entrada. A entrada atualizada deve ter apenas questDescription.

Para remover a propriedade monsters :

1. Dentro do agente, abra o Data Manager selecionando o ícone Abrir Data Manager ao longo da barra de navegação esquerda (parecia uma área de transferência).
2. O painel Data Manager possui três agrupamentos: Entradas, Saídas e Variáveis; monsters deve estar na lista de Entradas .
3. monsters para para revelar os ícones de edição e exclusão à direita do rótulo: um ícone de lápis (editar) e um ícone de lixeira (excluir).
4. Selecione o ícone excluir para monsters.
5. Open the agent's Properties panel and remove the now-dangling monsters reference from the User prompt: select the x on the monsters chip. The User prompt should be left with only the questDescription chip.

AVISO:

Deleting the input does not clear the prompt that references it. After step 4 the User prompt still carries a monsters chip, which Studio Web renders in red and flags with an error badge on Inputs. The agent will not run until you remove that chip, so do not skip step 5.

Agora você deve ter apenas uma entrada: questDescription:

Campo	Tipo	Required	Description
questDescription	String	Sim	Descrição da busca

Adicione o esquema de saída

Adicione um esquema de saída com os cinco campos da tabela de design em O que você está criando.

Dentro do mesmo painel do Data Manager :

1. Aponte para o cabeçalho Outputs para revelar o ícone Adicionar propriedade (+).
2. Selecione Adicionar propriedade para adicionar cada um dos campos abaixo:

Campo	Tipo
monsterIndex	String
monsterName	String
monsterType	String
monsterCr	String
monsterReasoning	String

Observação:

é gerado por agente, monsterReasoning pela API. O agente escreve esse próprio campo: é a explicação do agente de por que o robô selecionado se encaixa na busca. Ao contrário dos outros quatro campos (que vêm dos resultados da ferramenta), monsterReasoning reflete o julgamento do próprio agente.

Atualizar a solicitação do sistema

Para abrir o painel de Propriedades , selecione o agente na tela ou selecione o ícone de chave inglesa no canto superior direito. Substitua a mensagem do sistema por:

You are a quest classifier for an adventurer's guild. Given a quest description, your job is to find the most thematically appropriate monster from the 5e SRD and to return information about that monster.

When given a quest description:
1. Analyze the quest to determine what kind of creature fits the context - consider creature type, challenge rating, environment, and theme.
2. Call the Monster Query tool with a search term that targets that creature type.
3. Review the returned candidates and select the best fit for the quest.
4. Return the selected monster's key fields and a monsterReasoning that explains why this monster fits the quest.

Always call the Monster Query tool before selecting a monster. Do not guess monster details from memory.

Importante:

Os agentes de codificação não são determinísticos. Seu prompt produzirá resultados diferentes do exemplo acima; isso é esperado. O que importa é que o agente chame a ferramenta, raciocine sobre os candidatos e retorne todos os cinco campos de saída necessários.

---

Com a ferramenta conectada e o contrato do agente atualizado, você está pronto para testar o pipeline completo na próxima seção.