Os projetos têm como objetivo permitir que os clientes organizem o seu trabalho. As organizações podem gerir o acesso e os limites, aprovisionar contas de serviço (através da IU) e acompanhar a utilização num âmbito limitado dentro de um projeto (por exemplo, modelos, capacidades, threads, assistentes, fine-tuning, armazenamento, etc.). A atividade de utilização pode ser discriminada por projeto, e os utilizadores podem ver a faturação e definir limites de gastos por projeto.
Os proprietários da organização podem ver todos os seus projetos ativos e arquivados na página Projetos. Saiba mais sobre funções e permissões de utilizador na Plataforma de API.
Quem pode criar um projeto?
Apenas os proprietários da organização podem criar um projeto. Consulte funções e permissões para obter 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 têm um plano de faturação consolidada, as suborganizações são identificadas separadamente. Não é possível criar projetos dentro de suborganizações.
Como funcionam os projetos?
Todas as organizações incluem um «projeto predefinido» que não pode ser eliminado. Pode configurar os limites de taxa, as permissões de modelos virtuais e os limites de gastos (a partir de novembro de 2024). Herda a configuração completa da organização, pelo que não pode adicionar-lhe diretamente membros nem contas de serviço.
Como crio um projeto?
Primeiro, passe o cursor sobre o nome do projeto no canto esquerdo da página e selecione Criar projeto.
Indique um nome, uma descrição e um site para o projeto e, em seguida, selecione Criar.
Como adiciono utilizadores a um projeto?
Os novos membros da organização não são adicionados automaticamente ao «Projeto predefinido». Os novos membros podem ser convidados para o projeto quando são convidados para a organização (ativando a caixa «Convidar para o projeto predefinido») ou depois de aceitarem o convite para a organização.
Os utilizadores convidados através da API de administração seguem as regras descritas pelo endpoint /organization/invites.
Se ocorrer um erro ao convidar utilizadores para um projeto através da interface ou da API de administração, confirme primeiro que o projeto de destino existe e não está arquivado antes de reenviar o convite.
Os proprietários da organização são automaticamente adicionados como proprietários aos novos projetos criados na organização.
Quais são as diferentes funções de utilizador em organizações e projetos, e que permissões implicam?
Enquanto as organizações têm funções de «proprietário» e «leitor», os projetos têm funções de «proprietário» e «membro». Os membros do projeto são análogos aos leitores da organização. Consulte a tabela abaixo para obter uma descrição mais detalhada das permissões associadas a cada função de utilizador.
| Função | Âmbito | Descrição |
|---|---|---|
| Proprietário | Organização | Pode criar/ver todos os projetos, todos os utilizadores e todas as chaves de API. Tem a capacidade de monitorizar todos os projetos da organização através da página Projetos . Pode definir limites de gastos da organização e limites de gastos do projeto. Pode conceder permissões para ver informações de utilização de outras pessoas na organização. Pode arquivar projetos. |
| Leitor | Organização | Pode realizar inferência, utilizar recursos e criar chaves nos respetivos projetos. Pode ser adicionado a projetos. Não pode criar projetos nem gerir utilizadores. |
| Proprietário | Projeto | Pode adicionar outros utilizadores ao projeto e mudar o nome do projeto, além de ter todas as capacidades de um Membro. Pode definir limites de gastos do projeto. Pode arquivar o projeto. |
| Membro | Projeto | Pode realizar inferência, utilizar recursos e criar chaves ao nível do projeto. |
Se não for proprietário da organização, a que posso aceder?
Os utilizadores que não são proprietários da organização apenas podem ver os projetos dos quais são membros. Apenas o proprietário da organização pode ver todos os projetos, membros e chaves de API ao nível do projeto, bem como aceder à página Projetos.
Apenas os membros de um projeto (e os proprietários da organização) podem ver os modelos com otimização criados nesse projeto, as conversas de quaisquer Assistentes criados ou os ficheiros adicionados.
Os membros de um projeto podem ver todos os outros membros desse projeto e as respetivas funções (ou seja, Proprietário ou Membro).
Como atualizo a função de um utilizador num projeto ou removo um utilizador de um projeto?
Apenas o proprietário de um projeto pode atualizar a função de um utilizador ou removê-lo do projeto. Para mais informações, consulte funções e permissões.
Para atualizar um utilizador num projeto, aceda às definições da organização, selecione o projeto e clique em Membros. Pode definir a função de cada membro como Membro ou Proprietário. Também pode selecionar Remover para remover o utilizador do projeto.
O que é uma conta de serviço e em que difere de uma conta de utilizador normal?
Uma conta de serviço atua como um pseudoutilizador concebido para acesso do sistema, distinto das contas de utilizador individuais. Apenas os proprietários da organização e do projeto podem criar contas de serviço.
As contas de serviço estão limitadas apenas a projetos.
Adicionar um membro a um projeto
Se clicar no botão + Adicionar membro, verá uma lista dos utilizadores da sua organização com a função de Leitor. Se quiser adicionar um utilizador que ainda não pertence à sua organização, terá primeiro de o adicionar à organização (pode deixar a caixa «Adicionar ao projeto predefinido» desmarcada se não quiser conceder um acesso mais amplo a estes utilizadores). Esta lista não inclui contas de serviço. Neste passo, pode escolher entre as funções de Proprietário e Membro:
Ao adicionar um membro da equipa, tem de lhe atribuir a função de Membro ou Proprietário. Os membros do projeto podem fazer pedidos à API que leiam ou alterem dados, enquanto os proprietários também podem alterar as definições e os limites de despesas do projeto, bem como gerir os respetivos membros. Para mais informações, consulte funções e permissões.
Como criar uma conta de serviço para um projeto
Primeiro, aceda ao projeto para o qual pretende criar uma conta de serviço, escolhendo-o no menu pendente da barra de navegação:
Em seguida, aceda às definições da organização -> Projeto -> Membros -> e clique em + Conta de serviço:
As contas de serviço criadas ao nível do projeto são exclusivas desse projeto e não podem ser utilizadas fora do projeto em que foram criadas.
Nomear a conta de serviço
Independentemente de criar a conta de serviço ao nível da organização ou uma conta exclusiva de um projeto, ao criar uma conta de serviço pode criar um ID de conta de serviço único, composto por letras, números e hífenes, para identificar facilmente a conta de serviço.
Guardar a chave de API da conta de serviço
Depois de selecionar o botão Criar, é imediatamente criada uma chave de API para a conta de serviço e a chave secreta é apresentada. Guarde esta chave secreta num local seguro. Por motivos de segurança, não poderá voltar a vê-la através da sua conta OpenAI. Se perder esta chave secreta, terá de gerar uma nova.
Por predefinição, as permissões da chave de API da conta de serviço permitem ler e escrever em todos os recursos de API do projeto. Estas permissões podem ser atualizadas nas definições de Chaves de API do projeto.
As contas de serviço aparecem juntamente com os membros do projeto na página de definições dos membros do projeto. Consulte esta secção para saber mais sobre como atualizar ou remover o acesso de uma conta de serviço na página de definições dos membros do projeto.
Todas as contas de serviço, tanto em projetos como em organizações, serão apresentadas juntamente com os utilizadores humanos na página de membros ao nível da organização.
As contas de serviço são geridas como contas normais. No menu Organização -> Membros, pode Remover uma conta de serviço ou atualizar a função:
Como giro as chaves de API nos projetos da minha organização?
Pode criar e gerir chaves de API para cada projeto na respetiva página de definições. Nas definições da organização, selecione o projeto e clique em Chaves de API.
Para criar uma nova chave secreta, selecione + Criar nova chave secreta. Também pode selecionar o ícone Editar junto a uma chave secreta para editar as respetivas permissões.
Pode definir as permissões de cada chave de API ao criar uma nova chave secreta ou ao editar uma chave existente.
Estão disponíveis três níveis de permissões: Todas, Restritas e Só de leitura.
Todas — São definidas permissões completas para a chave secreta. Esta é a configuração predefinida.
Restritas — Permite ao utilizador definir as permissões Nenhuma, Leitura e Escrita para cada endpoint.
Por exemplo, pode criar uma chave de API especificamente sem permissões de Leitura ou Escrita para o endpoint /v1/assistants:
Só de leitura — São definidas permissões de leitura para todos os endpoints.
Como é gerido o acesso de utilizadores que pertencem a vários projetos ou organizações?
Os utilizadores podem ser membros de tantos projetos quantos os necessários. Num projeto, os utilizadores podem gerar uma chave API pessoal que está limitada e restringida ao acesso a esse projeto e aos seus recursos.
Como defino e giro limites de taxa para os projetos da minha organização?
Apenas o Proprietário de uma organização pode definir e gerir limites de taxa ao nível do projeto. Consulte funções e permissões para obter mais informações.
Nas suas definições da organização, clique no projeto que pretende atualizar e selecione Limites na secção Projeto da lista de navegação. Pode atualizar a sua Utilização do modelo nesta página.
A utilização do modelo permite-lhe configurar que modelos podem ser usados pelo projeto, e os limites de taxa podem ser definidos para cada modelo conforme necessário.
Como defino e giro os limites de despesas dos projetos da minha organização?
Apenas os proprietários de uma organização e os proprietários de um projeto podem definir e gerir os limites de despesas do projeto. Para mais informações, consulte funções e permissões. Para alterar os limites ao nível da organização, aceda às definições da organização, clique em Limites e desloque-se até Limites de utilização.
Para definir os limites do projeto, aceda às definições da organização, clique no projeto que pretende atualizar e selecione Limites. Pode atualizar o Limite mensal de despesas, o Limiar de notificação e a Utilização de modelos.
Definir um limite mensal de despesas permite estabelecer limiares de despesas flexíveis para o projeto. Quando a utilização ultrapassar este limite num determinado mês civil (UTC), os pedidos à API continuarão a ser processados sem interrupção. Esta funcionalidade ajuda a monitorizar a utilização através de alertas de limite de despesas, mas não impõe um limite máximo absoluto às despesas. Quando é criado um limite de despesas para um projeto, é também criado, por predefinição, um alerta para o limiar de 100%. Pode definir alertas adicionais para diferentes limiares clicando em Adicionar alerta.
Tenha em atenção que os proprietários da organização e do projeto receberão sempre estas mensagens e que esta opção não pode ser personalizada.
Como defino limites de gastos para a minha organização ou projeto?
A OpenAI suporta agora limites mensais de gastos com a API ao nível da organização e do projeto. Um limite de gastos pode monitorizar os gastos sem aplicação, ou pode aplicá-lo como um limite rígido para que os pedidos à API falhem depois de os gastos atingirem o limite. Para consultar os passos de configuração e o comportamento mais recentes, veja Limites de gastos na documentação para programadores.
Como elimino ou arquivo um projeto?
Os projetos podem ser arquivados através da nova página da lista de projetos ou nas definições de cada projeto. Depois de arquivado, um projeto não pode ser restaurado. Ao avançar com o arquivamento, ser-lhe-á pedido que introduza o nome do projeto para continuar.
Pode consultar a lista de todos os projetos arquivados no separador «Arquivados» da mesma página da lista de projetos.
Não é possível eliminar projetos. Mantemos um histórico de todos os projetos para garantir a continuidade do acompanhamento da utilização e da faturação.
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 predefinição.
Os recursos podem ser partilhados entre projetos?
Os recursos do projeto (como ficheiros, assistants, armazenamento ou threads) estão limitados ao projeto e não podem ser acedidos 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 os fine-tunes no "Projeto predefinido" podem ser acedidos a partir de outros projetos.
Qual é a quota de armazenamento de ficheiros por projeto?
Atualmente, a OpenAI permite uma quota de armazenamento de 100 GB de ficheiros por projeto.
Se esta quota for ultrapassada, verá o seguinte erro:
Excedeu a quota de armazenamento de ficheiros. As organizações estão limitadas a 100 GB de ficheiros. Reduza o tamanho dos ficheiros ou contacte o suporte.Recomendamos que elimine os ficheiros não utilizados armazenados na sua conta. Para referência, pode ver e listar ficheiros com a API.
Sou proprietário de um projeto. Porque não consigo ver o Painel de utilização do meu projeto?
A visibilidade do Painel de utilização de um projeto não está relacionada com a função de um utilizador nesse projeto. Em vez disso, é determinada pela sua função na organização e pelas definições em https://platform.openai.com/settings/organization/data-controls/visibility
Se não conseguir ver um Painel de utilização, é provável que esta definição esteja configurada como «Visível para os proprietários da organização».