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 os proprietários da organização podem criar projetos. Consulte funções e permissões para saber mais.
Para alternar entre organizações, passe o cursor sobre o nome da organização no canto superior esquerdo da página e selecione a organização na lista:
Nas organizações que usam um plano de faturamento consolidado, as suborganizações são identificadas separadamente. Não é possível criar projetos em suborganizações.
Como funcionam os projetos?
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 virtuais dos modelos e os limites de gastos (desde novembro de 2024). Ele herda toda a configuração da organização, por isso não é possível 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 Criar projeto.
Informe um nome, uma descrição e um site para o projeto e selecione Criar.
Como adiciono usuários a um projeto?
Os membros recém-adicionados à organização não são incluídos automaticamente no “Projeto padrão”. Novos membros podem ser convidados para o projeto ao serem convidados para a organização (marcando a caixa "Convidar para o projeto padrão") ou depois que aceitarem o convite para a organização.
Os usuários convidados pela API de administração seguem as regras descritas pelo endpoint /organization/invites.
Se ocorrer um erro ao convidar usuários para um projeto pela interface ou pela API de administração, 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 nela.
Quais são as diferentes funções dos usuários em organizações e projetos, e quais permissões cada uma concede?
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’. Os membros de projetos são equivalentes aos leitores de organizações. Consulte a tabela abaixo para ver 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 e visualizar todos os projetos, usuários e chaves de API. Pode monitorar todos os projetos da organização pela página Projetos . Pode definir limites de gastos para a organização e os projetos. Pode conceder a outras pessoas da organização permissão para visualizar informações de uso. Pode arquivar projetos. |
| Leitor | Organização | Pode executar inferências, usar recursos e criar chaves nos projetos dos quais participa. 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 renomeá-lo, além de ter todas as permissões de um Membro. Pode definir limites de gastos para o projeto. Pode arquivar o projeto. |
| Membro | Projeto | Pode executar inferências, usar recursos e criar chaves no nível do projeto. |
Se eu não for proprietário da organização, a que terei acesso?
Os usuários que não são proprietários da 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, além de acessar a página Projetos.
Somente os membros de um projeto e os proprietários da organização podem ver os modelos ajustados criados no projeto, as threads dos Assistentes criados ou os arquivos adicionados.
Os membros de um projeto podem ver todos os outros integrantes e suas funções, como Proprietário ou Membro.
Como atualizo a função de um usuário ou o removo de um projeto?
Somente o proprietário do projeto pode atualizar a função de um usuário ou removê-lo do projeto. Consulte funções e permissões para saber mais.
Para atualizar um usuário em um projeto, acesse as configurações da organização, selecione o projeto e clique em Membros. Você pode definir a função de cada integrante como Membro ou Proprietário. Você também pode selecionar Remover para retirar 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 funciona como um pseudousuário criado para acesso por sistemas, diferentemente 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
Ao clicar no botão + Adicionar membro, você verá uma lista dos usuários da organização que têm a função de Leitor. Se quiser adicionar um usuário que ainda não faz parte da organização, primeiro será necessário adicioná-lo a ela (você pode deixar a caixa 'Adicionar ao projeto padrão" desmarcada se não quiser conceder a esses usuários um acesso mais amplo). Essa lista não inclui contas de serviço. Nesta etapa, você pode definir a função como Proprietário ou Membro:
Ao adicionar um membro da equipe, atribua a ele a função de Membro ou Proprietário. Os membros do projeto podem fazer solicitações de API que leem ou modificam dados. Já os proprietários também podem alterar as configurações e os limites de gastos do projeto, além de gerenciar seus membros. Consulte funções e permissões para saber mais.
Como criar uma conta de serviço para um projeto
Primeiro, acesse o projeto para o qual deseja criar uma conta de serviço selecionando-o no menu suspenso da barra de navegação:
Depois, acesse as configurações da organização -> Projeto -> Membros -> e clique em + Conta de serviço:
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.
Nomear a conta de serviço
Independentemente de você criar a conta de serviço no nível da organização ou exclusivamente para um projeto, é possível criar um ID exclusivo composto por letras, números e hifens para identificá-la facilmente.
Salvar a chave de API da conta de serviço
Depois que você seleciona o botão Criar, uma chave de API é criada imediatamente para a conta de serviço, e a chave secreta é exibida. Salve essa chave secreta em um local seguro. Por motivos de segurança, não será possível visualizá-la novamente pela sua conta da OpenAI. Se perder essa chave secreta, você precisará gerar outra.
Por padrão, a chave de API da conta de serviço tem permissão para ler e gravar em todos os recursos de API do projeto. Essas permissões podem ser atualizadas nas configurações de Chaves de API do projeto.
As contas de serviço aparecem junto aos membros do projeto na página de configurações de membros. Consulte esta seção 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 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 as chaves de API nos projetos da minha organização?
Você pode criar e gerenciar as chaves de API de cada projeto na página de configurações dele. Nas configurações da organização, selecione o projeto e clique em Chaves de API.
Para criar uma chave secreta, selecione + Criar nova chave secreta. Você também pode selecionar o ícone Editar ao lado de uma chave secreta para alterar as permissões dela.
Você pode definir as permissões de cada chave de API ao criar uma nova chave secreta ou ao editar uma chave existente.
Há três níveis de permissão disponíveis: Todos, Restrito e Somente leitura.
Todos — A chave secreta recebe permissões completas. Essa é a configuração padrão.
Restrito — Permite definir as permissões Nenhuma, Leitura e Gravação para cada endpoint.
Por exemplo, você pode criar uma chave de API especificamente sem permissão de Leitura ou Gravação no endpoint /v1/assistants:
Somente leitura — Todos os endpoints recebem permissão de leitura.
Como é gerenciado o acesso de usuários que pertencem a vários projetos ou organizações?
Os usuários podem participar de quantos projetos forem necessários. Em um projeto, os usuários podem gerar uma chave de API pessoal cujo escopo e acesso ficam limitados a esse projeto e seus recursos.
Como defino e gerencio os limites de taxa dos projetos da minha organização?
Somente o proprietário da organização pode definir e gerenciar limites de taxa no nível do projeto. Consulte funções e permissões para saber mais.
Nas 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 o Uso de modelos nessa página.
O uso de modelos permite configurar quais modelos podem ser usados pelo projeto, e é possível definir limites de taxa para cada modelo conforme necessário.
Como defino e gerencio os limites de gastos dos projetos da minha organização?
Somente os proprietários da organização e do projeto podem definir e gerenciar os limites de gastos do projeto. Consulte funções e permissões para saber mais. Para alterar os limites da organização, acesse as configurações da organização, clique em Limites e role até Limites de uso.
Para definir os limites do projeto, acesse as configurações da organização, clique no projeto que deseja atualizar e selecione Limites. Você pode atualizar o Limite de gastos mensal, o Limite para notificações e o Uso de modelos.
Definir um limite de gastos mensal permite estabelecer limites flexíveis de gastos para o projeto. Quando o uso ultrapassar esse limite em determinado mês-calendário (UTC), as solicitações de API continuarão sendo processadas sem interrupção. Esse recurso ajuda 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 é criado para um projeto, um alerta no patamar de 100% é criado por padrão. Para definir outros alertas em patamares diferentes, clique em Adicionar alerta.
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 projeto?
A OpenAI agora oferece limites mensais de gastos com a API nos níveis da organização e do projeto. Um limite de gastos pode apenas monitorar os gastos, sem bloqueá-los, ou ser aplicado como limite rígido, fazendo com que as solicitações de API falhem quando os gastos atingirem esse valor. Para consultar as etapas de configuração e o comportamento mais recentes, veja Limites de gastos na documentação para desenvolvedores.
Como excluo ou arquivo um projeto?
Os projetos podem ser arquivados pela nova página de lista de projetos ou nas configurações de um projeto específico. Depois que um projeto é arquivado, ele não pode ser restaurado. Ao arquivar um projeto, você precisará digitar o nome dele para prosseguir.
Você pode ver a lista de todos os projetos arquivados na aba “Arquivados” da mesma página de lista de projetos.
Não é possível excluir projetos. Mantemos o histórico de todos os projetos para garantir a continuidade do acompanhamento de uso e faturamento.
Há um limite para o número de projetos que posso ter na minha organização?
Por padrão, as organizações podem criar até 2.000 projetos.
É possível compartilhar recursos entre projetos?
Os recursos do projeto, como arquivos, assistentes, armazenamento ou threads, ficam restritos a ele e não podem ser acessados por membros sem privilégios administrativos que estejam fora do projeto. Além disso, não é possível mover recursos 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 100 GB de arquivos 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 de um projeto. Por que não consigo ver o Painel de uso dele?
A visibilidade do Painel de uso de um projeto não está relacionada à função do usuário no projeto. Ela é determinada pela sua função na organização e pelas configurações em https://platform.openai.com/settings/organization/data-controls/visibility
Se você não consegue ver um Painel de uso, essa configuração provavelmente está definida como "Visível para proprietários da organização".