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)
• Saída: (string): o campo monsterIndex dados dinâmico do mostrado mostrado mostrado
• 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. No painel Caixa de ferramentas , selecione Fluxo de trabalho da API.
3. No painel Recursos disponíveis , selecione o fluxo de trabalho que você criou na Etapa 1.

Observação:

Os recursos disponíveis estão vazios? O fluxo de trabalho deve ser publicado antes de aparecer aqui. Retorne à Etapa 1 e conclua a subetapa Publicar no seu feed e, em seguida, volte e tente novamente.

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 D&D 5e SRD for monsters matching a name or creature type. Returns up to 10 candidates with name, type, CR, size, alignment, and description. 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.

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 D&D 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.