Criando Tools

Uma ferramenta virtual é uma operação JavaScript associada a um agente. Use-a para combinar ferramentas de conexões existentes ou transformar seus resultados em uma operação reutilizável. Se uma ferramenta conectada já faz o trabalho, associe-a diretamente.

Criando Tools com Deco Chat

Descreva o resultado, o agente de destino, os inputs esperados e as conexões necessárias. Por exemplo:

Crie uma ferramenta de triagem para este agente. Leia os pedidos recentes
no sistema de suporte conectado, agrupe-os por prioridade e devolva o ID
e o link original de cada pedido. Não altere os registros de suporte.

O assistente precisa de acesso às ferramentas de gestão relevantes. O fluxo atual é:

1. Identificar o agente com COLLECTION_VIRTUAL_MCP_LIST ou COLLECTION_VIRTUAL_MCP_GET.
2. Consultar suas ferramentas virtuais com COLLECTION_VIRTUAL_TOOLS_LIST para evitar duplicatas.
3. Criar a definição com COLLECTION_VIRTUAL_TOOLS_CREATE: nome, descrição, input schema, código JavaScript e connection_dependencies.
4. Consultar o resultado com COLLECTION_VIRTUAL_TOOLS_GET e testar o comportamento com inputs representativos.

Esses são nomes de ferramentas de gestão. Peça ao assistente para consultar as funcionalidades disponíveis no workspace, em vez de presumir que toda operação está associada a cada agente.

O que acontece por trás?

Input schema

Use um JSON Schema explícito para os inputs. Mantenha os campos próximos do domínio da tarefa: ID de pedido, intervalo de datas ou quantidade máxima de registros.

Implementação JavaScript

Ferramentas virtuais usam esta assinatura no sandbox:

export default async function (tools, args) {
  const result = await tools.some_tool({ id: args.id });
  return { result };
}

tools contém ferramentas das conexões downstream, e não o conjunto completo do agente. Substitua some_tool por uma ferramenta conectada existente. args contém inputs validados pelo schema declarado.

Dependências de conexões

Liste os IDs de todas as conexões chamadas pelo código em connection_dependencies. Isso permite que o Studio acompanhe essas dependências e mostre a conexão quebrada se alguma for removida.

Output

Devolva dados estruturados compatíveis com JSON e com formato estável. Inclua IDs ou links de registros de origem quando uma pessoa precisar conferir o resultado.

Descobrindo Tools Existentes

Gerencie as integrações da organização em Settings → Connections. Navegue pelo catálogo ou escolha Custom Connection para um servidor MCP não listado. Em Settings do agente, selecione as conexões e as ferramentas específicas necessárias. Veja Conexões.

Para criar seu próprio servidor ou uma interface ligada a uma ferramenta, use Criar ferramentas e MCP Apps.

Gerenciando Tools

Use COLLECTION_VIRTUAL_TOOLS_GET para consultar uma definição salva e COLLECTION_VIRTUAL_TOOLS_UPDATE para uma mudança pontual. Mantenha o input schema, o código e as dependências de conexões alinhados. Confira o resultado salvo antes de testar novamente.

Testando

Teste a operação com um input pequeno e representativo. Confira os dados retornados, os links dos registros originais e o comportamento quando uma dependência falha. As instruções e ferramentas selecionadas determinam as ações do agente; uma ferramenta virtual não cria acesso adicional a sistemas externos.

Referência da implementação: guia de ferramentas virtuais. Revisado em 2026-10-05.