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

# OpenWorker

> Aponte o OpenWorker para o FlexInference através do seu provedor OpenAI.

O OpenWorker aponta seu provedor OpenAI para qualquer servidor compatível com OpenAI. As chaves ficam no armazenamento secreto local do aplicativo, não em um arquivo.

O OpenWorker não oferece um local para definir `start_within` por requisição, então o prazo é definido na chave. Crie uma primeiro (veja [chaves de agente](/pt/agent-keys)).

<Note>
  O OpenWorker está em beta aberto, então esses campos podem mudar.
  Verifique-os em relação à sua versão.
</Note>

O endpoint e a chave são configurados pela interface do usuário do aplicativo, não por um arquivo, então esta página não possui um prompt de configuração de agente. Apenas a linha do modelo fica na configuração.

## Configurar OpenWorker

1. Abra o OpenWorker e vá para as configurações do provedor. Escolha o provedor **OpenAI**.
2. Cole sua chave de agente em **OpenAI API key**.
3. Defina **Custom endpoint (optional)** para o roteador, incluindo o sufixo `/v1`.

```text theme={null}
https://api.flexinference.com/v1
```

4. Defina o modelo padrão em `~/.config/coworker/config.toml`.

```toml theme={null}
model = "gpt-5.6-sol"
```

Um arquivo por workspace em `<your-project>/.coworker/config.toml` substitui o global. Cada chave nele é opcional, e as chaves não definidas retornam aos padrões internos.

O OpenWorker também lê `OPENAI_API_KEY` do ambiente. Exporte sua chave de agente lá para mantê-la fora do armazenamento secreto.

```bash theme={null}
export OPENAI_API_KEY=flex_live_...
```

## Confirmar a aplicação da chave

Toda resposta vem com `x-flexinference-defaults-applied`. O OpenWorker não exibe os cabeçalhos de resposta, então leia a requisição no painel em **Logs**.

## Solução de problemas

**O OpenWorker não detectou o provedor a partir da chave.** Ele verifica os prefixos `sk-` e `AIza` para adivinhar um, e uma chave `flex_live_` não corresponde a nenhum deles. Escolha **OpenAI** manualmente.

**As requisições ainda vão para o OpenAI.** **Custom endpoint (optional)** está em branco, então o provedor retorna para `api.openai.com`. Defina-o para a URL do roteador, incluindo `/v1`.

**[`400 unsupported_parameter`](/pt/errors#unsupported_parameter).** O OpenWorker enviou um parâmetro de Chat Completions que não traduzimos, e em um modelo não-OpenAI recusamos qualquer um deles. Use um slug `gpt-*`.

**[`400 key_default_not_applicable`](/pt/errors#key_default_not_applicable).** Sua chave contém uma duração e um desses parâmetros veio junto. Edite a chave para um tier.

**O seletor de modelo e `config.toml` não concordam.** Um arquivo `.coworker/config.toml` por workspace substitui o arquivo global. Verifique qual deles seu diretório de projeto possui.

Veja [erros](/pt/errors) para cada recusa que retornamos, e [chaves de agente](/pt/agent-keys) para aquelas que não são específicas do OpenWorker.