Server tool Subagent

A ferramenta orq:subagent delega uma tarefa autocontida a outro modelo. O executor recebe a tarefa, um contexto opcional e a configuração da entrada da ferramenta. Ele não recebe a conversa principal. Use um executor menor ou mais rápido para extração, resumo, rascunhos ou transformação de dados, enquanto o modelo principal continua responsável pela resposta final.

Início rápido

Os exemplos usam a configuração de cliente da Visão geral das server tools.

curl -X POST https://router.toqan.ai/eu/v3/router/chat/completions \
  -H "Authorization: Bearer $TOQAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.4",
    "messages": [
      { "role": "user", "content": "Extract the dates and owners from this project update, then summarize the risks." }
    ],
    "tools": [
      {
        "type": "orq:subagent",
        "model": "openai/gpt-5.4-mini",
        "output_format": "JSON with dates, owners, and risks",
        "max_uses": 2
      }
    ]
  }'

const response = await client.chat.completions.create({
  model: 'openai/gpt-5.4',
  messages: [
    {
      role: 'user',
      content:
        'Extract the dates and owners from this project update, then summarize the risks.',
    },
  ],
  tools: [
    {
      type: 'orq:subagent',
      model: 'openai/gpt-5.4-mini',
      output_format: 'JSON with dates, owners, and risks',
      max_uses: 2,
    },
  ] as any,
});

console.log(response.choices[0].message.content);

response = client.chat.completions.create(
    model="openai/gpt-5.4",
    messages=[
        {
            "role": "user",
            "content": "Extract the dates and owners from this project update, then summarize the risks.",
        }
    ],
    tools=[
        {
            "type": "orq:subagent",
            "model": "openai/gpt-5.4-mini",
            "output_format": "JSON with dates, owners, and risks",
            "max_uses": 2,
        }
    ],
)

print(response.choices[0].message.content)

O modelo principal fornece uma task e um context opcional ao chamar a ferramenta. A saída concluída do executor é retornada ao modelo principal.

Configuração

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
`type`	string	Sim		Deve ser `orq:subagent`.
`model`	string	Sim		Modelo executor no formato `provider/model`.
`max_tokens`	integer	Não	Padrão do provedor	Máximo de tokens de saída do executor. Intervalo aceito: de 0 a 128,000, limitado pela saída máxima do modelo executor. `0` usa o padrão do provedor.
`reasoning_effort`	string	Não	Padrão do provedor	`none`, `minimal`, `low`, `medium`, `high`, `xhigh` ou `max`, quando compatível com o modelo executor.
`temperature`	number	Não	Padrão do provedor	Temperatura de amostragem do executor, de 0 a 2. O modelo selecionado pode impor um máximo menor.
`system_prompt`	string	Não	Prompt integrado do executor	Substitui o prompt de sistema do executor.
`output_format`	string	Não	Nenhum	Adiciona orientações de formato de saída à tarefa do executor.
`max_uses`	integer	Não	Ilimitado	Máximo de delegações durante a solicitação. Defina `0` ou omita o campo para não ter limite específico da ferramenta.

Custo e uso

Os tokens do executor são cobrados pela tarifa padrão do modelo selecionado. Cada chamada ao Subagent aparece em usage.server_tool_use.subagent_requests, incluindo chamadas rejeitadas por max_uses e chamadas cuja solicitação ao executor falhou. orq:sidekick continua sendo aceito como alias legado.

Toqan Router

Visão geral

APIs

MCP Portal

Roteamento

Segurança e privacidade

Recursos dos modelos

Ferramentas de servidor

Cenários comuns

Configuração de provedores

Início rápido

Configuração

Custo e uso

​Início rápido

​Configuração

​Custo e uso

Início rápido

Configuração

Custo e uso