Arthur MCPArthur MCP
Dashboard
How it worksFeaturesDocsEarly accessGitHubDashboard

Como Adicionar Saída HTML a uma Ferramenta

Transforme a resposta JSON bruta de uma ferramenta em uma view HTML renderizada, para clientes de IA que conseguem exibir saída rica em vez de dados simples.

Pré-requisitos: uma ferramenta que já retorna uma resposta JSON funcionando — teste-a uma vez antes de adicionar um template.

Passos

  1. Abra o servidor e vá na aba Ferramentas, depois abra a ferramenta à qual você quer adicionar saída HTML.

    Abra o servidor de captura para documentar Add HTML Output to a Tool

  2. Encontre a seção de template de saída HTML e habilite-a.

  3. Preencha valores de argumentos de teste e rode "Testar & mapear resposta" — o Arthur chama o endpoint real e mostra a resposta de verdade.

    Abra a aba Ferramentas, onde fica a interface usada por este procedimento

  4. Clique em "Usar schema da resposta" para extrair automaticamente os campos dessa resposta como variáveis de template — campos escalares viram {{campo}}, campos de lista viram blocos {{#each itens}}...{{/each}}.

  5. Escreva seu HTML no editor, usando as variáveis extraídas. Mude para a aba Preview para ver renderizado ao vivo contra seus dados de teste.

  6. Salve.

    Leve o painel Nova ferramenta para a área visível da captura

Confirme que funcionou

A aba Preview mostra seus dados reais renderizados como HTML, não JSON bruto. Quando a ferramenta é chamada por um cliente de IA, sua saída agora é o HTML renderizado em vez do corpo JSON simples.

Bom saber

  • O editor tem um modo tela cheia se você estiver escrevendo um template mais longo.
  • A mesma abordagem de templating com Handlebars é usada em Recursos dinâmicos — se você já construiu um template HTML, o outro funciona da mesma forma.

Relacionado

Vídeo tutorial