Skip to main content
Os espaços de trabalho organizam chaves de API, configurações de roteamento, presets, guardrails e acesso administrativo para uma equipe, produto ou ambiente. Os espaços de trabalho estão incluídos no serviço padrão de pagamento por uso do Phaseo. Você não precisa de um plano separado para criá-los ou usá-los.

​
Quando criar um espaço de trabalho

Use espaços de trabalho separados se quiser:
  • isolar credenciais de desenvolvimento, staging e produção
  • manter produtos ou projetos de clientes separados
  • dar às integrações administrativas acesso apenas aos recursos necessários
  • aplicar políticas diferentes de roteamento, presets ou guardrails
Para uma integração pequena, o espaço de trabalho padrão pode ser suficiente.

​
Gerenciar espaços de trabalho

Você pode gerenciar espaços de trabalho pelo painel do Phaseo ou pela API de gerenciamento. A API de espaços de trabalho usa chaves de API de gerenciamento. As chaves padrão do Gateway servem para solicitações de inferência e não podem chamar endpoints administrativos de espaços de trabalho.
Os endpoints de gerenciamento de espaços de trabalho estão marcados como Beta. Mantenha a automação administrativa fácil de repetir e revise as respostas da API antes de aplicar alterações subsequentes.

​
Escolher o acesso adequado

Crie uma chave de gerenciamento apenas com os recursos de espaço de trabalho necessários para a sua integração:
  • workspaces:read para listar e consultar espaços de trabalho
  • workspaces:write para criar ou atualizar espaços de trabalho
  • workspaces:delete para excluir espaços de trabalho
O Phaseo também verifica a associação ao espaço de trabalho e as funções. Uma capacidade, por si só, não concede acesso a outro espaço de trabalho. Armazene chaves de gerenciamento no armazenamento de secrets do servidor. Não as exponha em código do navegador, logs de desktop, controle de versão ou chats.

​
Excluir um espaço de trabalho

O espaço de trabalho padrão não pode ser excluído. Antes de excluir outro, remova ou mova as chaves de API ativas dele para que as solicitações não apontem para um espaço de trabalho inexistente.

​
Cobrança

Os espaços de trabalho não criam planos de preços separados. O uso continua sendo cobrado pelo modelo padrão de pagamento por uso descrito em Preços e cobrança.

​
Próximas etapas

Chaves de API de gerenciamento

Crie uma credencial de servidor com escopo limitado para administrar espaços de trabalho.

Autenticação

Use chaves de API do Gateway para solicitações de modelos e geração.
Última modificação em 2 de outubro de 2026