Os projetos têm como objetivo oferecer aos clientes a capacidade de organizar seu trabalho. As organizações podem gerenciar acesso e limites, provisionar contas de serviço (pela interface) e acompanhar o uso em relação a um escopo restrito dentro de um projeto (por exemplo, modelos, capacidades, threads, assistentes, ajuste fino, armazenamento etc.). A atividade de uso pode ser detalhada por projeto, e os usuários podem visualizar o faturamento e definir limites de gastos por projeto.
Proprietários da organização podem ver todos os seus projetos ativos e arquivados na página Projetos. Saiba mais sobre funções de usuário e permissões na Plataforma de API.
Quem pode criar um projeto?
Somente 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 organizações que estão em um plano de faturamento consolidado, as suborganizações são identificadas separadamente. Projetos não podem ser criados dentro de suborganizações.
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 modelos virtuais e os limites de gastos (a partir de novembro de 2024). Ele herda a configuração completa da organização, portanto você não pode adicionar membros nem 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?
Membros recém-adicionados à organização não são adicionados automaticamente ao “projeto padrão”. Novos membros podem ser convidados para o projeto quando 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 IU ou pela Admin API, primeiro confirme se 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 aos 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 incluem?
Enquanto as organizações têm as funções de “proprietário” e “leitor”, os projetos têm as funções de “proprietário” e “membro”. Membros do projeto são análogos aos leitores da organização. Consulte a tabela abaixo para ver uma descrição mais detalhada das permissões de cada função de usuário.
| Função | Escopo | Descrição |
|---|---|---|
| Proprietário | Organização | Pode criar/visualizar todos os projetos, todos os usuários e todas as chaves de API. Pode monitorar todos os projetos da organização pela página Projetos. Pode definir limites de gastos da organização e limites de gastos do projeto. Pode conceder permissões para que outras pessoas na organização visualizem informações de uso. Pode arquivar projetos. |
| Leitor | 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. |
| Proprietário | Projeto | Pode adicionar outros usuários ao projeto e renomear o projeto, além de ter todas as permissões de um membro. Pode definir limites de gastos do projeto. Pode arquivar o projeto. |
| Membro | Projeto | Pode realizar inferência, usar recursos e criar chaves no nível do projeto. |
Se eu não for Proprietário na organização, a que tenho acesso?
Usuários que não são Proprietários na organização só podem ver os 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 Projetos.
Somente os membros de um projeto (e proprietários da organização) podem ver os modelos com ajuste fino criados dentro desse projeto, as threads de quaisquer Assistants criados ou quaisquer arquivos adicionados.
Membros de um projeto podem ver quem são todos os outros membros desse projeto e suas funções (ou seja, Proprietário ou Membro).
Como atualizo a função de projeto de um usuário ou removo um usuário de um projeto?
Somente o Proprietário 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 Membros. Você tem a opção de definir a função de cada membro como Membro ou Proprietário. Também é possível selecionar Remover 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 da sua organização com a função Reader. Se quiser adicionar um usuário que ainda não faz parte da sua organização, primeiro será preciso adicioná-lo à organização (você pode manter a caixa de seleção “Adicionar ao projeto padrão” desmarcada se não quiser conceder a esses usuários um acesso mais amplo). Essa lista não incluirá contas de serviço. Nesta 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 de Membro ou Proprietário. Membros do projeto podem fazer solicitações de API que leem ou modificam dados, enquanto proprietários do projeto também podem modificar as configurações e os limites de gastos do projeto, além de gerenciar os membros do projeto. Consulte funções e permissões para saber mais.
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 no menu suspenso encontrado na barra de navegação:
Em seguida, acesse suas configurações da organização -> Projeto -> Membros -> 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.
Salvar a chave de API da conta de serviço
Depois de selecionar o botão Criar, uma chave de API é criada imediatamente para a conta de serviço e a chave secreta será exibida. Salve esta chave secreta em um local seguro e protegido. Por motivos de segurança, você não poderá visualizá-la novamente pela sua conta da OpenAI. Se você perder esta chave secreta, precisará 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 todos os recursos de API do projeto. Essas permissões podem ser atualizadas nas configurações de Chaves de API do seu projeto.
Contas de serviço são listadas junto com os membros do projeto na página de configurações de membros do seu 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 seu projeto.
Todas as contas de serviço em projetos e organizações serão exibidas junto com seus usuários humanos na página de membros no nível da organização.
Contas de serviço são gerenciadas como contas comuns. No menu Organização -> Membros, 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. Nas suas configurações da organização, selecione o projeto e clique em Chaves de API.
Para criar uma nova chave secreta, selecione + Create new secret key. Você também pode selecionar o ícone Editar ao lado de uma chave secreta para editar suas permissões.
Você pode definir permissões para cada uma das suas chaves de API ao criar uma nova chave secreta ou ao editar uma chave existente.
Há três níveis de permissões disponíveis: Todas, Restritas e Somente leitura.
Todas — Permissões completas são definidas para a chave secreta. Esta é a configuração padrão.
Restritas — Permite que o usuário defina permissões Nenhuma, Leitura e Gravação para cada endpoint.
Por exemplo, você cria uma chave de API que especificamente não tem permissão para Ler ou Gravar no endpoint /v1/assistants:
Somente leitura — 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 Proprietário 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.
Nas suas configurações da organização, clique no projeto que deseja atualizar e selecione Limites na seção Projeto da lista de navegação. Você pode atualizar seu Uso de modelos nesta página.
O uso de modelos permite configurar quais modelos podem ser usados pelo projeto, e limites de taxa podem ser definidos para cada modelo conforme necessário.
Como defino e gerencio os limites de gastos dos projetos da minha organização?
Somente os proprietários de uma organização e os proprietários de um projeto podem definir e gerenciar limites de gastos do projeto. Consulte funções e permissões para saber mais. Para alterar os limites no nível da organização, em suas configurações da organização, clique em Limites, e role para baixo até Limites de uso.
Para definir os limites do projeto, em suas configurações da organização, clique no projeto que deseja atualizar e selecione Limites. Você pode atualizar seu Limite mensal de gastos, Limite para notificação e Uso de modelos.
Definir um limite mensal de gastos permite estabelecer limites flexíveis de gastos para o seu projeto. Quando o uso exceder esse limite em um determinado mês do calendário (UTC), as solicitações de API continuarão sendo processadas sem interrupção. Esse recurso foi criado para ajudar você a monitorar o uso por meio de alertas de limite de gastos, mas não impõe um teto rígido aos gastos. Quando um limite de gastos do projeto é criado, por padrão, um alerta é criado no limite de 100%. Alertas adicionais em limites diferentes podem ser definidos clicando em Adicionar alerta.
Observe que os proprietários da organização e do projeto sempre receberão essas mensagens, e isso não pode ser personalizado.
Como defino limites de gastos para minha organização ou meu projeto?
A OpenAI agora oferece suporte a limites mensais de gastos de API tanto no nível da organização quanto no nível do projeto. Um limite de gastos pode monitorar os gastos sem aplicá-lo, ou você pode aplicá-lo como um limite rígido para que as solicitações de API falhem depois que os gastos atingirem o limite. Para ver as etapas de configuração e o comportamento mais recentes, consulte Limites de gastos na documentação para desenvolvedores.
Como excluo ou arquivo um projeto?
Projetos podem ser arquivados pela nova página de lista de projetos ou nas configurações de um projeto individual. Depois que um projeto é arquivado, ele não pode ser restaurado. Ao prosseguir com um arquivamento, será solicitado que você insira o nome do projeto para continuar.
Você pode ver uma lista de todos os projetos arquivados pela guia “Arquivados” na mesma página de lista de projetos.
Não é possível excluir projetos; mantemos um histórico de todos os projetos para garantir a continuidade do acompanhamento 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 excluir arquivos não utilizados armazenados na sua conta. Para referência, você pode visualizar e listar arquivos com a API.
Sou proprietário do projeto. Por que não consigo ver o Painel de uso do meu projeto?
A visibilidade do Painel de uso 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 conseguir ver um Painel de uso, essa configuração provavelmente está definida como “Visível para proprietários da organização”.