Tools
File search, function calling, and code interpreter — what the assistant does beyond answering.
Updated on Aug 10, 2026
Assistants can be equipped with tools: capabilities that the model decides to use during execution. Three types are available:
| Tool | What it does |
|---|---|
file_search | Built-in RAG: searches your documents (vector stores) and answers based on them. |
function | Calls your functions: the model decides when and with which arguments; your code executes and returns the result. |
code_interpreter | Sandbox code execution. Accepted for compatibility — see status on the page. |
Tools go into the assistant's tools parameter. Resources they need — such as file_search vector stores — go in 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_..."]}}
}'In a run, the tools parameter overrides the assistant's list only for that execution — useful to toggle a tool on or off at a specific time. Threads can also carry their own tool_resources: file_search searches in the assistant's and the thread's vector stores.
Was this page helpful?