Pular para o conteúdo principal
Ferramentas são capacidades externas que ampliam o que o agente consegue fazer além de gerar texto. Cada ferramenta expõe uma função (ou um conjunto de funções) que o agente pode chamar para executar ações no mundo real ou consultar dados confiáveis. Alguns exemplos comuns:
  • 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?

No Orkeia, trabalhamos com a permissão de chamar ferramentas e, nisso o agente pode fazer das seguintes maneiras:
  • 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

É importante que você forneça descrições claras para os seus agentes, explique exatamente o que a ferramenta faz e quando usá-la. Além disso, recomendamos que defina ambientes separados, habilitando (ou desabilitando) as ferramentas para evitar efeitos indesejados em produção. O Orkeia também permite que você restrinja as ferramentas por setores e recomendamos usar isso para ter maior controle de suas ferramentas.

​
Interface de Ferramenta do Orkeia

O Orkeia permite, via API, que passemos ferramentas para nossos agentes, abaixo temos um exemplo de interface: 
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"
  }
}