Tool search
openrouter:tool_search
Mantém grandes bibliotecas de ferramentas fora do prompt. Marque suas próprias ferramentas com defer_loading e o modelo buscará as ferramentas de que precisa, para que centenas de definições deixem de consumir tokens de entrada a cada turno e a seleção de ferramentas permaneça precisa.
Como funciona
Para bibliotecas grandes de ferramentas: aproximadamente mais de 10 ferramentas ou 10k tokens de definições. Abaixo disso, a chamada de ferramentas padrão é mais simples.
- 1
Seu aplicativo marca as ferramentas de função com defer_loading, para que fiquem fora do prompt.
- 2
Seu modelo busca nas ferramentas adiadas usando um padrão quando precisa de uma.
- 3
OpenRouter revela as melhores correspondências por nome, descrição e argumentos.
- 4
Seu aplicativo trata chamadas a ferramentas reveladas como qualquer outra chamada de função.
Provedores e preços
OpenRouter
Grátis
Executado no próprio processo no OpenRouter durante a solicitação.
Os custos padrão de tokens do modelo se aplicam a todas as solicitações.
Como usar esta ferramenta
Marque suas próprias ferramentas de função com defer_loading. O OpenRouter executa a pesquisa no servidor e revela as ferramentas correspondentes ao modelo, e seu aplicativo processa as chamadas de função reveladas como faria com qualquer outra.
Disponível pela API. Afeta apenas solicitações que marcam outras ferramentas como defer_loading, o que o Chatroom não faz.
APIs compatíveis: Responses and Anthropic Messages.
curl https://openrouter.ai/api/v1/responses \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-5.2",
"tools": [
{
"type": "openrouter:tool_search"
},
{
"type": "function",
"name": "book_restaurant",
"description": "Reserve a restaurant table for a party at a given date and time.",
"parameters": {
"type": "object",
"properties": {
"party_size": {
"type": "integer",
"description": "Number of guests."
},
"datetime": {
"type": "string",
"description": "Reservation time as an ISO 8601 timestamp."
}
},
"required": [
"party_size",
"datetime"
]
},
"defer_loading": true
},
{
"type": "function",
"name": "create_calendar_event",
"description": "Add an event to the user’s calendar.",
"parameters": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Event title."
},
"start": {
"type": "string",
"description": "Start time as an ISO 8601 timestamp."
}
},
"required": [
"title",
"start"
]
},
"defer_loading": true
}
],
"input": "Book me a table for four tomorrow night and add it to my calendar."
}'Configuração, parâmetros e exemplos na documentação.
Ler o guia de integraçãoFerramentas relacionadas
Utilitários