Ferramentas

• Conectores de dados: buscar em bases internas, CRMs, planilhas, bancos SQL/NoSQL.
• Ações de sistema: enviar e-mails, criar tickets, enviar mensagens.
• Serviços analíticos: rodar consultas, análises estatísticas, sumarizações.
• Automação: fazer requisições HTTP, ler páginas, extrair conteúdo/padrões.
• MCP (Model Context Protocol): padroniza como o agente descobre e chama ferramentas hospedadas remotamente.

​

Como o agente decide usar uma Ferramenta?

• Detecção de intenção: a política do agente (prompt + regras) identifica que a tarefa requer dados/ação externa.
• Seleção da ferramenta: escolhe a melhor ferramenta com base em descrição, permissões e ambiente (dev/staging/prod).
• Planejamento de parâmetros: estrutura argumentos com validações (tipos, limites, sanitização).
• Execução e observação: chama a ferramenta; o retorno vira “observação” para o próximo passo do raciocínio.
• Segurança e governança: logs, rate limits, máscaras de dados sensíveis e checagens de autorização por setor/ambiente.

​

Boas práticas

​

Interface de Ferramenta do Orkeia

export interface Tool {
  id?: string;
  name: string;
  description: string;
  code?: string;
  entryFunctionName?: string;
  sectors: string[];
  publisher: string;
  enabled: boolean;
  environments: string[];
  mcp?: {
    url: string;
    transport: 'sse' | 'streamable-http';
  };
}

​

Exemplo de JSON de Ferramenta do Orkeia

json
{
  "id": "tool_http_fetcher_v1",
  "name": "HTTP Fetcher",
  "description": "Executa requisições HTTP (GET/POST) com validação de URL, cabeçalhos opcionais e corpo JSON. Use para integrar com APIs REST quando não houver um conector dedicado.",
  "code": "código em python",
  "entryFunctionName": "run",
  "sectors": ["engineering", "integrations", "data"],
  "publisher": "Orkeia tools team",
  "enabled": true,
  "environments": ["dev", "staging", "prod"],
  "mcp": {
    "url": "https://api.orkeia.ai/mcp/tools/http-fetcher",
    "transport": "streamable-http"
  }
}