Os projetos têm como objetivo dar aos clientes a capacidade de organizar seu trabalho. As organizações podem gerenciar acesso e limites, provisionar contas de serviço (pela UI) e rastrear o uso em relação a um escopo restrito dentro de um projeto (por exemplo, modelos, recursos, threads, assistants, fine-tuning, armazenamento etc.). A atividade de uso pode ser detalhada por projeto, e os usuários podem ver o faturamento e definir orçamentos por projeto.
Os proprietários da organização podem ver todos os seus projetos ativos e arquivados na página Projects. Saiba mais sobre funções e permissões de usuário na API Platform.
Quem pode criar um projeto?
Somente os proprietários da organização podem criar um projeto. Consulte funções e permissões para mais informações.
Para alternar entre organizações, passe o cursor sobre o nome da sua organização no canto superior esquerdo da página e selecione a organização na lista:
Para as organizações que estão em um plano de faturamento consolidado, as suborgs são identificadas separadamente. Não é possível criar projetos dentro de suborgs.
Como os projetos funcionam?
Toda organização inclui um “Projeto padrão” que não pode ser excluído. Você pode configurar os limites de taxa, as permissões de modelo virtual e os orçamentos de gastos (desde novembro de 2024). Ele herda a configuração completa da organização, portanto você não pode adicionar membros ou contas de serviço diretamente a ele.
Como crio um projeto?
Primeiro, passe o cursor sobre o nome do projeto no canto esquerdo da página e selecione Create project.
Forneça um nome, uma descrição e um site para o seu projeto e então selecione Create.
Como adiciono usuários a um projeto?
Novos membros da organização não são adicionados automaticamente ao “Projeto padrão”. Novos membros podem ser convidados para o projeto no momento em que são convidados para a organização (ativando a caixa de seleção "Convidar para o projeto padrão") ou depois que o membro aceitar o convite da organização.
Usuários convidados pela Admin API seguem as regras descritas pelo endpoint /organization/invites.
Se você encontrar um erro ao convidar usuários para um projeto pela UI ou pela Admin API, primeiro confirme que o projeto de destino existe e não está arquivado antes de reenviar o convite.
Os proprietários da organização são adicionados automaticamente como proprietários de novos projetos criados dentro de uma organização.
Quais são as diferentes funções de usuário em organizações e projetos, e quais permissões elas envolvem?
Enquanto as organizações têm as funções ‘owner’ e ‘reader’, os projetos têm as funções ‘owner’ e ‘member’. Os membros do projeto são análogos aos readers da organização. Consulte a tabela abaixo para uma descrição mais detalhada das permissões que acompanham cada função de usuário.
| Função | Escopo | Descrição |
|---|---|---|
| Owner | Organização | Pode criar/ver todos os projetos, todos os usuários e todas as chaves de API. Tem a capacidade de monitorar todos os projetos da organização com a página Projects . Pode definir orçamentos da organização e do projeto. Pode conceder permissões para que outros na organização vejam informações de uso. Pode arquivar projetos. |
| Reader | Organização | Pode realizar inferência, usar recursos e criar chaves em seus projetos. Pode ser adicionado a projetos. Não pode criar projetos nem gerenciar usuários. |
| Owner | Projeto | Pode adicionar outros usuários ao projeto e renomear o projeto, além de ter todas as capacidades de um Member. Pode definir orçamentos do projeto. Pode arquivar o projeto. |
| Member | Projeto | Pode realizar inferência, usar recursos e criar chaves no nível do projeto. |
Se eu não for Owner na organização, a que tenho acesso?
Usuários que não são Owners na organização só podem ver projetos dos quais são membros. Somente o proprietário da organização pode ver todos os projetos, membros e chaves de API no nível do projeto e ter acesso à página Projects.
Somente os membros de um projeto (e os proprietários da organização) podem ver os modelos ajustados com fine-tuning que foram criados dentro desse projeto, os threads de quaisquer Assistants criados ou quaisquer arquivos que tenham sido adicionados.
Os membros de um projeto podem ver quem são os outros membros desse projeto e suas funções (ou seja, Owner ou Member).
Como atualizo a função de projeto de um usuário ou removo um usuário de um projeto?
Somente o Owner de um projeto pode atualizar a função de projeto de um usuário ou remover um usuário de um projeto. Consulte funções e permissões para mais informações.
Para atualizar um usuário em um projeto, acesse suas configurações da organização, selecione o projeto e clique em Members. Você tem a opção de definir a função de cada membro como Member ou Owner. Você também pode selecionar Remove para remover o usuário do projeto.
O que é uma conta de serviço e como ela difere de uma conta de usuário comum?
Uma conta de serviço atua como um pseudousuário projetado para acesso ao sistema, distinto das contas de usuários individuais. Somente os proprietários da organização e do projeto podem criar contas de serviço.
As contas de serviço têm escopo apenas para projetos.
Adicionar um membro a um projeto
Se você clicar no botão + Add member, verá uma lista de usuários na sua organização com a função Reader. Se quiser adicionar um usuário que atualmente não faz parte da sua organização, será necessário primeiro adicioná-lo à organização (você pode deixar a caixa de seleção 'Add to Default Project" desmarcada se não quiser dar a esses usuários um acesso mais amplo). Esta lista não incluirá contas de serviço. Durante esta etapa, você pode escolher se a função dele será Owner ou Member:
Ao adicionar um membro da equipe, você deve atribuir a ele a função Member ou Owner. Os membros do projeto podem fazer solicitações à API que leem ou modificam dados, enquanto os proprietários do projeto também podem modificar as configurações e os orçamentos do projeto e gerenciar os membros do projeto. Consulte funções e permissões para mais informações.
Como criar uma conta de serviço para um projeto
Primeiro, navegue até o projeto para o qual deseja criar uma conta de serviço, escolhendo-o no menu suspenso encontrado na barra de navegação:
Em seguida, vá para suas configurações da organização -> Project -> Members -> clique em + Service account:
As contas de serviço criadas no nível do projeto são exclusivas do projeto e não podem ser usadas fora do projeto em que são criadas.
Nomeando a conta de serviço
Independentemente de você criar a conta de serviço no nível da organização ou criar uma exclusiva para um projeto, ao criar uma conta de serviço você pode criar um ID exclusivo de conta de serviço composto por letras, números e hífens para identificar facilmente a conta de serviço.
Salve a chave de API da conta de serviço
Depois de selecionar o botão Create, uma chave de API é criada imediatamente para a conta de serviço e a chave secreta será exibida. Salve essa chave secreta em algum lugar seguro. Por motivos de segurança, você não poderá visualizá-la novamente pela sua conta OpenAI. Se perder essa chave secreta, será necessário gerar uma nova.
As permissões da chave de API da conta de serviço são definidas por padrão para ler e gravar em todos os recursos de API do projeto. Essas permissões podem ser atualizadas nas configurações de API Keys do seu projeto.
As contas de serviço são listadas junto com os membros do projeto na página de configurações de membros do projeto. Consulte aqui para saber mais sobre como atualizar ou remover o acesso de uma conta de serviço na página de configurações de membros do projeto.
Todas as contas de serviço, tanto de projetos quanto de organizações, serão exibidas junto com seus usuários humanos na página de membros no nível da organização.
As contas de serviço são gerenciadas como contas comuns. Em Organização -> menu Members, você pode Remover uma conta de serviço ou atualizar a função:
Como gerencio chaves de API nos projetos da minha organização?
Você pode criar e gerenciar chaves de API para cada projeto na página de configurações desse projeto. Em suas configurações da organização, selecione o projeto e clique em API Keys.
Para criar uma nova chave secreta, selecione + Create new secret key. Você também pode selecionar o ícone Edit ao lado de uma chave secreta para editar suas permissões.
Você pode definir permissões para cada uma de suas chaves de API ao criar uma nova chave secreta ou editando uma chave existente.
Há três níveis de permissões disponíveis: All, Restricted e Read Only.
All — As permissões completas são definidas para a chave secreta. Esta é a configuração padrão.
Restricted — Permite que o usuário defina permissões None, Read e Write para cada endpoint.
Por exemplo, você cria uma chave de API que especificamente não tem permissão para Read ou Write no endpoint /v1/assistants:
Read Only — As permissões de leitura são definidas para todos os endpoints.
Como o acesso é gerenciado para usuários que pertencem a vários projetos ou organizações?
Os usuários podem ser membros de quantos projetos forem necessários. Dentro de um projeto, os usuários podem gerar uma chave de API pessoal com escopo e limitada ao acesso àquele projeto e seus recursos.
Como defino e gerencio limites de taxa para os projetos da minha organização?
Somente o Owner de uma organização pode definir e gerenciar limites de taxa no nível do projeto. Consulte funções e permissões para mais informações.
Em suas configurações da organização, clique no projeto que deseja atualizar e selecione Limits na seção Project da lista de navegação. Você pode atualizar seu Model Usage nesta página.
O uso do modelo permite configurar quais modelos podem ser usados pelo projeto, e os limites de taxa podem ser definidos para cada modelo conforme necessário.
Como defino e gerencio orçamentos para os projetos da minha organização?
Somente os Owners de uma organização e os Owners de um projeto podem definir e gerenciar os orçamentos do projeto. Consulte funções e permissões para mais informações. Para alterar os limites no nível da organização, em suas configurações da organização, clique em Limits, e role para baixo até Usage limits.
Para definir os limites do seu projeto, em suas configurações da organização, clique no projeto que deseja atualizar e selecione Limits. Você pode atualizar seu Monthly budget, Notification threshold e Model Usage.
Definir um orçamento mensal permite estabelecer limites flexíveis de gastos para seu projeto. Quando o uso excede esse limite em um determinado mês do calendário (UTC), as solicitações à API continuarão sendo processadas sem interrupção. Esse recurso foi criado para ajudar você a monitorar o uso por meio de alertas de orçamento, mas ele não impõe um teto rígido de gastos. Quando um orçamento de projeto é criado, por padrão um alerta será criado no limite de 100%. Orçamentos adicionais em limites diferentes podem ser definidos clicando em Add Alert.
Observe que o(s) proprietário(s) da organização e o(s) proprietário(s) do projeto sempre receberão essas mensagens, e isso não pode ser personalizado.
Como excluo ou arquivo um projeto?
Os projetos podem ser arquivados pela nova página de listagem de projetos ou nas configurações de um projeto individual. Depois que um projeto é arquivado, ele não pode ser restaurado. Ao prosseguir com o arquivamento, será solicitado que você digite o nome do projeto para continuar.
Você pode ver uma lista de todos os projetos arquivados pela guia “Archived” na mesma página de listagem de projetos.
Não é possível excluir projetos; mantemos um histórico de todos os projetos para garantir a continuidade do rastreamento de uso e faturamento.
Existe um limite para o número de projetos que posso ter na minha organização?
As organizações podem criar até 2.000 projetos por padrão.
Os recursos podem ser compartilhados entre projetos?
Os recursos do projeto (como arquivos, assistants, armazenamento ou threads) têm escopo do projeto e não podem ser acessados por membros não administradores fora do projeto. Além disso, os recursos não podem ser movidos entre projetos.
A única exceção é que fine-tunes no "Projeto padrão" podem ser acessados de outros projetos.
Qual é a cota de armazenamento de arquivos por projeto?
Atualmente, a OpenAI oferece uma cota de armazenamento de arquivos de 100 GB por projeto.
Se essa cota for excedida, você verá o seguinte erro:
Você excedeu sua cota de armazenamento de arquivos. As organizações estão limitadas a 100 GB de arquivos. Reduza o tamanho dos arquivos ou entre em contato com o suporte.Recomendamos que você exclua arquivos não usados armazenados em sua conta. Para referência, você pode visualizar e listar arquivos com a API.
Sou proprietário de projeto. Por que não consigo ver o Usage Dashboard do meu projeto?
A visibilidade do Usage Dashboard de um projeto não está relacionada à função de um usuário dentro de um projeto. Em vez disso, ela é determinada pela sua função dentro da organização e pelas configurações em https://platform.openai.com/settings/organization/data-controls/visibility
Se você não consegue ver um Usage Dashboard, essa configuração provavelmente está definida como "Visible to organization owners".