acme/legal-assistant. Só o seu espaço de trabalho pode vê-la ou chamá-la, e ela funciona em qualquer lugar onde um ID de modelo público funciona.
Os modelos privados estão em Beta. Proprietários e administradores do espaço de trabalho os adicionam e gerenciam.
Antes de começar
Sua implantação precisa oferecer:- uma URL base HTTPS pública;
- um endpoint
/chat/completionscompatível com OpenAI; - autenticação por token Bearer; e
- um ID de modelo ou de implantação upstream aceito por esse endpoint.
/responses é opcional. Deixe-o desativado, a menos que a implantação implemente esse endpoint explicitamente.
Conectar uma implantação
1
Abra Modelos privados
Abra Painel → Configurações → Espaço de trabalho → Modelos privados e selecione Adicionar modelo. Você precisa ser proprietário ou administrador do espaço de trabalho. Para automatizar, chame
POST /v1/private-models com os mesmos campos e uma chave de gerenciamento.2
Dê um nome ao modelo
Escolha um modelo existente do catálogo para adicionar esta implantação à lista de provedores dele, ou digite um slug curto de modelo, como Você não pode escolher nem substituir o namespace do espaço de trabalho. IDs exatos do catálogo se vinculam a esse modelo sem alterar sua identidade pública.
legal-assistant. Se nenhum modelo do catálogo tiver esse slug único, o Phaseo o combina com o namespace confiável do espaço de trabalho:3
Configure o endpoint
Digite a URL base antes do caminho de inferência. Por exemplo, use:Não inclua
/chat/completions nem /responses. Digite o ID exato do modelo ou da implantação upstream separadamente; o Phaseo o substitui ao encaminhar as solicitações.4
Armazene a credencial
Digite a chave de API da implantação. O Phaseo criptografa a credencial e nunca a devolve depois de salva. Você pode substituí-la mais tarde na página de configurações do modelo.
5
Chame o modelo
Use o ID de modelo gerado com o endpoint normal de Chat Completions:A chave de API que faz a chamada precisa pertencer ao mesmo espaço de trabalho do modelo privado.
cURL
Como o roteamento funciona
Um modelo autônomo do espaço de trabalho só é roteado para o endpoint configurado. Um endpoint vinculado a um modelo do catálogo entra na lista de provedores desse modelo de acordo com sua política de roteamento:
O Phaseo envia a credencial armazenada como token Bearer e substitui o ID do modelo upstream configurado.
Um modelo privado nunca se torna uma rota pública de provedor e não fica visível para outros espaços de trabalho. Os modelos privados habilitados entram no catálogo de modelos autenticado e aparecem no filtro Privados.
Depois de adicionar, alterar ou habilitar uma implantação privada, aguarde até um minuto antes de testar o roteamento. Até lá, algumas solicitações ainda podem usar a configuração anterior, como os provedores públicos do modelo. Solicitações já em andamento não são redirecionadas.
Exemplos de provedores
Os produtos e formatos de URL dos provedores podem mudar. Confirme a URL base, o ID do modelo, o método de autenticação e os endpoints aceitos na documentação de implantação atual do provedor.
Gerenciar modelos privados pela API
A administração no servidor pode usar a API de Modelos privados com uma chave de gerenciamento que tenhaprivate_models:read, private_models:write ou private_models:delete, conforme necessário.
As solicitações de criação e atualização aceitam model_reference, que pode ser um ID exato de modelo do catálogo ou um slug curto. O Phaseo deriva model_id; os clientes não podem enviá-lo diretamente. Use host_provider_id para um provedor existente do Phaseo, ou custom_provider_name e o opcional custom_provider_url para outro operador.
Solução de problemas
- 404 do provedor: confira se a URL base termina antes do caminho de inferência.
- Modelo desconhecido: copie o ID da implantação upstream do provedor em ID do modelo no provedor. Não use ali o ID de modelo do espaço de trabalho do Phaseo.
- Solicitação upstream não autorizada: substitua a credencial armazenada e confirme que o provedor aceita autenticação Bearer.
- Chat funciona, mas Responses falha: desative Responses API, a menos que o provedor implemente
/responsesnativamente. - Modelo ausente do catálogo: confirme que o modelo está habilitado e que quem chama está autenticado no mesmo espaço de trabalho.