Roteamento

Todo workspace tem uma configuração de roteamento própria, criada automaticamente e compartilhada por todas as requisições que não usam um preset. Ela define quais modelos podem ser usados e em que ordem o fallback automático os tenta — veja Chat Completions para entender como o fallback funciona durante uma requisição.

Modelos permitidos

Por padrão, nenhum modelo é selecionado e a Retrace considera todos os modelos ativos de todos os provedores como candidatos ao fallback.

1. Acesse a página Roteamento.
2. No card Modelos permitidos, adicione os modelos que devem ficar disponíveis para o workspace.
3. Arraste os modelos para reordená-los — a ordem define a prioridade de fallback quando a requisição não indica um modelo âncora específico.

Se a lista de modelos permitidos for esvaziada, a Retrace volta a considerar todos os modelos ativos como candidatos. Uma requisição que solicitar um modelo fora da allowlist é rejeitada com o erro model_not_allowed.

Retenção zero de dados (ZDR)

O switch Exigir retenção zero de dados restringe o roteamento a provedores que não retêm dados para treinamento de modelos. Com a opção ativada, uma requisição para um modelo de provedor sem ZDR é rejeitada com o erro model_zdr_conflict.

Se os modelos permitidos incluírem provedores incompatíveis com ZDR no momento em que a exigência é ativada, a Retrace sinaliza um conflito de configuração na página. Para resolver:

1. Acesse a página Roteamento e clique em Ver no aviso de conflito.
2. Clique em Resolver conflito para remover automaticamente da allowlist os provedores sem retenção zero de dados.

Restaurar configuração

Restaurar a configuração apaga a allowlist de modelos e desfaz customizações, retornando o roteamento do workspace ao estado padrão (todos os modelos ativos como candidatos).

1. Acesse a página Roteamento e clique em Restaurar.
2. Confirme a ação.

Permissões

Apenas membros com permissão de admin ou owner podem alterar a configuração de roteamento do workspace.