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 IU) e acompanhar o uso em relação a um escopo restrito dentro de um projeto (por exemplo, modelos, recursos, 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 orçamentos por projeto.
Proprietários da organização podem visualizar 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 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?
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 envolvem?
Enquanto as organizações têm funções de “proprietário” e “leitor”, os projetos têm funções de “proprietário” e “membro”. Membros de projeto são análogos a leitores da organização. Consulte a tabela abaixo para obter uma descrição mais detalhada das permissões associadas a 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. Tem a capacidade de monitorar todos os projetos dentro da organização pela página Projetos . Pode definir orçamentos da organização e orçamentos de projetos. Pode conceder permissões para visualizar informações de uso de outras pessoas na org. Pode arquivar projetos. |
| Leitor | Organização | Pode executar 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 orçamentos de projeto. Pode arquivar o projeto. |
| Membro | Projeto | Pode executar 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 na sua organização com a função Reader. Se quiser adicionar um usuário que ainda não está na sua organização, será necessário adicioná-lo primeiro à organização (você pode manter desmarcada a caixa de seleção “Adicionar ao projeto padrão” se não quiser conceder acesso mais amplo a esses usuários). Esta lista não incluirá contas de serviço. Nesta etapa, você pode escolher se a função deles 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 configurações e orçamentos do projeto e gerenciar 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 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 orçamentos para os projetos da minha organização?
Somente os Proprietários de uma organização e os Proprietários de um projeto podem definir e gerenciar orçamentos de projetos. Consulte funções e permissões para mais informações. Para alterar os limites no nível da organização, nas suas configurações da organização, clique em Limites, e role para baixo até Limites de uso.
Para definir os limites do projeto, nas suas configurações da organização, clique no projeto que deseja atualizar e selecione Limites. Você pode atualizar seu Orçamento mensal, Limite de notificação e Uso de modelos.
Definir um orçamento mensal permite estabelecer limites flexíveis de gastos para seu projeto. Quando o uso exceder esse limite em um determinado mês-calendário (UTC), as solicitações de API continuarão sendo processadas sem interrupção. Este recurso foi projetado para ajudar você a monitorar o uso por meio de alertas de orçamento, mas não impõe um limite 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 diferentes limites podem ser definidos clicando em Adicionar alerta.
Observe que o(s) proprietário(s) da organização e do projeto sempre receberão essas mensagens, e isso não pode ser personalizado.
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”.