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

# Server tool Code interpreter

> Execute Python em um sandbox isolado durante a resposta de um modelo com a server tool orq:code_interpreter.

A ferramenta `orq:code_interpreter` executa Python em um sandbox isolado e restrito ao workspace. Ela é adequada para cálculos, transformação de dados, parsing e outras tarefas em que executar código é mais confiável do que raciocinar em texto.

## 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": "Calculate the compound annual growth rate from 4.2 million to 7.1 million over five years." }
    ],
    "tools": [
      { "type": "orq:code_interpreter" }
    ]
  }'
```

```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:
        'Calculate the compound annual growth rate from 4.2 million to 7.1 million over five years.',
    },
  ],
  tools: [{ type: 'orq:code_interpreter' }] 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": "Calculate the compound annual growth rate from 4.2 million to 7.1 million over five years.",
        }
    ],
    tools=[{"type": "orq:code_interpreter"}],
)

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

O modelo escreve o código Python. Um valor atribuído a `result` e tudo o que for gravado na saída padrão são retornados ao modelo.

## Configuração

| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
| - | - | - | - | - |
| `type` | string | Sim | | Deve ser `orq:code_interpreter`. |
| `files` | object\[] | Não | Nenhum | Arquivos do workspace a disponibilizar em `/workspace`. Máximo: 10 arquivos. |
| `files[].file_id` | string | Sim | | ID do arquivo no workspace. |
| `files[].name` | string | Sim | | Nome do arquivo exposto em `/workspace`. Os nomes precisam ser únicos e podem conter letras, números, `.`, `_` e `-`. |
| `network.mode` | string | Não | `disabled` | Intenção da política de rede. Os valores aceitos são `disabled` e `allowlist`. |
| `network.allowlist` | string\[] | Não | Nenhum | Hostnames simples ou endereços IPv4. Obrigatório quando o modo é `allowlist`. Máximo: 50 entradas. |

Cada arquivo disponibilizado pode ter até 10 MB.

> [!NOTE]
>
> As configurações de rede são aceitas e validadas, mas a aplicação das regras de
> saída do sandbox ainda está sendo implantada. As execuções no sandbox mantêm o
> acesso público padrão à internet do deployment até que a aplicação seja ativada.

## Disponibilidade e uso

Cada execução expira após 60 segundos.

O deployment precisa ter a infraestrutura de sandbox configurada. Quando ela não está disponível, o modelo recebe um erro de ferramenta em vez de um resultado do Python.

O Code interpreter não tem cobrança separada como server tool nesta versão. O número de sessões aparece em `usage.server_tool_use.code_interpreter_sessions`.


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