> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Server tool Fusion

> Execute um prompt em um painel de modelos e retorne uma comparação estruturada ao modelo principal.

A ferramenta `orq:fusion` envia um prompt a um painel de modelos em paralelo. Um modelo analista compara as respostas bem-sucedidas e retorna ao modelo principal os consensos, as contradições, os insights exclusivos e os pontos cegos.

Os membros do painel não recebem a conversa principal nem as ferramentas. O modelo principal precisa fornecer ao Fusion um prompt autocontido.

## Início rápido

Os exemplos usam a configuração de cliente da [Visão geral das server tools](/docs/pt-BR/ai-gateway/features/server-tools.md).

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
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-mini",
    "messages": [
      { "role": "user", "content": "Compare the main architectural options for a multi-region event ingestion service." }
    ],
    "tools": [
      {
        "type": "orq:fusion",
        "analysis_models": [
          "openai/gpt-5.4",
          "anthropic/claude-sonnet-5"
        ],
        "model": "openai/gpt-5.4",
        "max_uses": 1
      }
    ]
  }'
```

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
const response = await client.chat.completions.create({
  model: 'openai/gpt-5.4-mini',
  messages: [
    {
      role: 'user',
      content:
        'Compare the main architectural options for a multi-region event ingestion service.',
    },
  ],
  tools: [
    {
      type: 'orq:fusion',
      analysis_models: ['openai/gpt-5.4', 'anthropic/claude-sonnet-5'],
      model: 'openai/gpt-5.4',
      max_uses: 1,
    },
  ] as any,
});

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

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
response = client.chat.completions.create(
    model="openai/gpt-5.4-mini",
    messages=[
        {
            "role": "user",
            "content": "Compare the main architectural options for a multi-region event ingestion service.",
        }
    ],
    tools=[
        {
            "type": "orq:fusion",
            "analysis_models": [
                "openai/gpt-5.4",
                "anthropic/claude-sonnet-5",
            ],
            "model": "openai/gpt-5.4",
            "max_uses": 1,
        }
    ],
)

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

## Configuração

| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
| - | - | - | - | - |
| `type` | string | Sim | | Deve ser `orq:fusion`. |
| `analysis_models` | string\[] | Sim | | Modelos do painel no formato `provider/model`. Inclua de 1 a 8 modelos. |
| `model` | string | Não | Primeiro modelo do painel | Modelo analista que compara as respostas do painel. |
| `max_tokens` | integer | Não | Padrão do provedor | Máximo de tokens de saída para cada chamada interna. Intervalo aceito: de 0 a 128,000. `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 os modelos do painel. |
| `temperature` | number | Não | Padrão do provedor | Temperatura de amostragem do painel, de 0 a 2. O analista sempre usa `0`. |
| `max_uses` | integer | Não | `1` | Máximo de chamadas ao Fusion durante a solicitação. Um valor ausente ou não positivo usa `1`. |

## Comportamento em caso de falha

Se algumas chamadas do painel falharem, o Fusion compara as respostas bem-sucedidas e inclui os detalhes dos modelos que falharam no resultado. Se o analista falhar, as respostas do painel são retornadas com um `analysis_error`. Se todas as chamadas do painel falharem, a ferramenta retorna `all_panels_failed` ao modelo principal.

## Custo e uso

Cada resposta do painel e a resposta do analista são cobradas pelas tarifas padrão de tokens dos modelos selecionados. Cada invocação do Fusion aparece em `usage.server_tool_use.fusion_requests`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.