Os projetos visam dar aos clientes a capacidade de organizar 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 face a um âmbito limitado dentro de um projeto (por exemplo, modelos, capacidades, threads, assistentes, afinação, armazenamento, etc.). A atividade de utilização pode ser discriminada por projeto, e os utilizadores podem ver a faturação e definir orçamentos 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 de utilizador e permissões 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 modelo virtual e os orçamentos de despesa (desde novembro de 2024). Herda a configuração completa da organização, pelo que não pode adicionar diretamente membros nem contas de serviço ao mesmo.
Como crio um projeto?
Primeiro, passe o cursor sobre o nome do projeto no canto esquerdo da página e selecione Create project.
Indique um nome, uma descrição e um website para o seu projeto e depois selecione Create.
Como adiciono utilizadores a um projeto?
Os membros recém-adicionados à 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 de seleção “Invite to default project”) ou depois de o membro aceitar o convite da organização.
Os utilizadores convidados através da Admin API seguem as regras descritas pelo endpoint /organization/invites.
Se encontrar um erro ao convidar utilizadores para um projeto através da IU ou da Admin API, 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 dentro de uma 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 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 dentro da organização com a página Projetos . Pode definir orçamentos da organização e orçamentos de projetos. Pode conceder permissões para ver informações de utilização de outros membros da org. Pode arquivar projetos. |
| Leitor | Organização | Pode realizar inferência, utilizar recursos e criar chaves nos seus 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, bem como todas as capacidades de um Membro. Pode definir orçamentos de projeto. Pode arquivar o projeto. |
| Membro | Projeto | Pode realizar inferência, utilizar recursos e criar chaves ao nível do projeto. |
Se eu não for Proprietário na organização, a que tenho acesso?
Os utilizadores que não são Proprietários na organização só podem ver os projetos de que 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, e ter acesso à página Projetos.
Apenas os membros de um projeto (e os proprietários da organização) podem ver os modelos com afinação fina que foram criados nesse projeto, os threads de quaisquer Assistentes criados ou quaisquer ficheiros que tenham sido adicionados.
Os membros de um projeto podem ver quem são todos os outros membros desse projeto e as respetivas funções (ou seja, Proprietário ou Membro).
Como atualizo a função de projeto de um utilizador ou removo um utilizador de um projeto?
Apenas o Proprietário de um projeto pode atualizar a função de projeto de um utilizador ou remover um utilizador de um projeto. Consulte funções e permissões para obter mais informações.
Para atualizar um utilizador num projeto, aceda às suas definições da organização, selecione o projeto e clique em Membros. Tem a opção de 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 + Add member, verá uma lista de utilizadores na sua organização com a função Reader. Se quiser adicionar um utilizador que atualmente não faz parte da sua organização, terá de o adicionar primeiro à organização (pode manter a caixa de seleção “Add to Default Project” desmarcada se não quiser dar a estes utilizadores um acesso mais amplo). Esta lista não incluirá contas de serviço. Durante este passo, pode escolher se a função é Owner ou Member:
Quando adiciona 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 leem ou modificam dados, enquanto os proprietários do projeto também podem modificar as definições e os orçamentos do projeto e gerir membros do projeto. Consulte funções e permissões para obter mais informações.
Como criar uma conta de serviço para um projeto
Primeiro, navegue para o projeto para o qual pretende criar uma conta de serviço, escolhendo-o no menu pendente encontrado na barra de navegação:
Depois, aceda às suas definições da organização -> Projeto -> Membros -> clique em + Service account:
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, é criada imediatamente uma chave de API para a conta de serviço e a chave secreta será apresentada. Guarde esta chave secreta num local seguro e protegido. 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.
As permissões da chave de API da conta de serviço estão predefinidas para ler e escrever todos os recursos da API do projeto. Estas permissões podem ser atualizadas nas definições de Chaves de API do seu projeto.
As contas de serviço são listadas juntamente com os membros do projeto na página de definiçõ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 definições de membros do seu 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 chaves de API nos projetos da minha organização?
Pode criar e gerir chaves de API para cada projeto na página de definições desse projeto. Nas suas definições da organização, selecione o projeto e clique em Chaves de API.
Para criar uma nova chave secreta, selecione + Create new secret key. Também pode selecionar o ícone Editar junto a uma chave secreta para editar as respetivas permissões.
Pode definir permissões para cada uma das suas chaves de API quando cria 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 definição predefinida.
Restritas — Permite ao utilizador definir permissões Nenhuma, Leitura e Escrita para cada endpoint.
Por exemplo, cria uma chave de API que especificamente não tem permissão para Ler ou Escrever no 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 orçamentos para os projetos da minha organização?
Apenas os Proprietários de uma organização e os Proprietários de um projeto podem definir e gerir orçamentos de projetos. Consulte funções e permissões para obter mais informações. Para alterar os limites ao nível da organização, nas suas definições da organização, clique em Limites, e desloque-se para baixo até Limites de utilização.
Para definir os limites do projeto, nas suas definições da organização, clique no projeto que pretende atualizar e selecione Limites. Pode atualizar o seu Orçamento mensal, Limiar de notificação e Utilização do modelo.
Definir um orçamento mensal permite-lhe estabelecer limiares flexíveis de despesas para o seu projeto. Quando a utilização excede este limite num determinado mês civil (UTC), os pedidos à API continuarão a ser processados sem interrupção. Esta funcionalidade foi concebida para o ajudar a monitorizar a utilização através de alertas de orçamento, mas não impõe um limite rígido às despesas. Quando é criado um orçamento de projeto, por predefinição, será criado um alerta no limiar de 100%. Podem ser definidos orçamentos adicionais com limiares diferentes clicando em Adicionar alerta.
Tenha em atenção que os proprietários da organização e os proprietários do projeto receberão sempre estas mensagens, e isto não pode ser personalizado.
Como elimino ou arquivo um projeto?
Os projetos podem ser arquivados através da nova página de listagem de projetos ou nas definições de um projeto individual. Depois de um projeto ser arquivado, não pode ser restaurado. Ao prosseguir com o arquivo, ser-lhe-á pedido que introduza o nome do projeto para avançar.
Pode ver uma lista de todos os projetos arquivados através do separador “Arquivados” na mesma página de listagem 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 suporta uma quota de armazenamento de ficheiros de 100 GB por projeto.
Se esta quota for excedida, 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 dentro de um projeto. Em vez disso, é determinada pela sua função dentro da 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 proprietários da organização”.