Ir para o conteúdo

Ferramentas

Busca em arquivos, chamada de funções e interpretador de código — o que o assistente faz além de responder.

Atualizado em 10 de ago. de 2026

Assistentes podem ser equipados com ferramentas: capacidades que o modelo decide usar durante a execução. Três tipos estão disponíveis:

FerramentaO que faz
file_searchRAG integrado: busca nos seus documentos (vector stores) e responde com base neles.
functionChama funções suas: o modelo decide quando e com quais argumentos; seu código executa e devolve o resultado.
code_interpreterExecução de código em sandbox. Aceito para compatibilidade — veja o status na página.

Como habilitar

Ferramentas entram no parâmetro tools do assistente. Recursos que elas precisam — como os vector stores do file_search — vão em tool_resources:

curl -s https://api.hinow.ai/v1/assistants \
  -H "Authorization: Bearer hi_SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hinow/himax",
    "name": "Analista com ferramentas",
    "instructions": "Use a busca em documentos quando a pergunta envolver as políticas internas.",
    "tools": [
      {"type": "file_search"},
      {"type": "function", "function": {
        "name": "get_weather",
        "description": "Clima atual de uma cidade",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }}
    ],
    "tool_resources": {"file_search": {"vector_store_ids": ["vs_..."]}}
  }'

No run, o parâmetro tools sobrepõe a lista do assistente só naquela execução — útil para ligar ou desligar uma ferramenta pontualmente. Threads também podem carregar tool_resources próprios: o file_search busca nos vector stores do assistente e da thread.