Gerencie sua organização na janela de administração

A janela de administração é onde os proprietários, administradores e responsáveis pelo faturamento de uma organização com plano de equipe a gerenciam: membros e convites, grupos e funções personalizadas, políticas, conexões, uso e faturamento, além do registro de auditoria. Ela abre em https://cloud.altifigence.com/admin e é separada de Configurações, onde ficam suas configurações pessoais e do app.

As funções abaixo descrevem as permissões padrão. Cada organização pode personalizar as permissões administrativas; as seções e ações que você pode usar dependem das suas permissões efetivas. Consulte Permissões administrativas personalizadas.

Quem pode abrir a janela de administração

A janela de administração se destina a organizações com plano de equipe (tipo de conta Business ou Academic). O que abre depende das suas permissões efetivas na organização que você está gerenciando. A tabela mostra os padrões antes de a organização personalizar as permissões.

A janela mostra apenas o que suas permissões efetivas permitem, e o serviço de contas verifica novamente cada solicitação; portanto, alterar o endereço não concede acesso.

As funções básicas são:

As funções personalizadas acrescentam permissões a uma pessoa ou a um grupo (consulte Grupos e funções personalizadas). As configurações de permissão específicas da organização e as concessões personalizadas podem alterar quais seções e ações administrativas um membro pode usar. Elas não concedem acesso ao conteúdo de projetos privados. As permissões da função de proprietário não podem ser reduzidas.

Abra a janela de administração

1. Entre no Altifigence Cloud e confira a organização em que você está trabalhando.

2. Abra o menu da conta (seu nome no painel de navegação) e escolha Administração da organização. Você também pode abrir Configurações e escolher Administração da organização, que aparece junto de Projetos, Dispositivos conectados e Acesso de desenvolvedor, ou acessar https://cloud.altifigence.com/admin.

3. A janela de administração abre em tela cheia com um menu à esquerda. A barra superior mostra a organização gerenciada e sua função. Use o seletor de organização para alternar entre suas organizações de equipe. Escolha Voltar ao Cloud para retornar.

Se o Cloud estiver usando uma organização diferente da que você deseja gerenciar, a janela pergunta Trocar o Cloud para esta organização? Escolha Trocar para a organização desejada ou continue gerenciando a que o Cloud está usando. A troca também altera suas outras abas abertas do Cloud.

No app para desktop, Administração da organização abre a janela de administração no navegador. Entre por lá se isso for solicitado.

As páginas de IAM da organização foram movidas para a janela de administração. No Cloud, os endereços antigos de Visão geral, Membros, Grupos e Funções redirecionam para a seção administrativa correspondente da organização de equipe selecionada. Os endereços antigos das políticas de Agent da organização levam a Políticas. Quando um aviso de mudança de página é exibido, ele diz Organization administration has moved e oferece Open the admin window. Organizações pessoais não têm janela de administração.

Projetos, Dispositivos conectados e Acesso de desenvolvedor continuam em Configurações. No Cloud, um endereço antigo /console/projects ou /console/manage/projects leva a Administração da organização → Projetos depois que a leitura da administração de projetos é concluída com sucesso para a organização Business ou Academic selecionada; os parâmetros de consulta e o fragmento são preservados. Enquanto essa leitura estiver pendente ou se ela falhar, a página existente do console permanece aberta. Endereços antigos de políticas da organização levam a Políticas; sem uma organização de equipe, eles abrem /admin para orientação. O aplicativo de desktop não redireciona esses endereços automaticamente. As carteiras e compras de créditos continuam em Faturamento no console; seus endereços antigos não redirecionam automaticamente. Use Uso e Faturamento na janela de administração para os relatórios e o faturamento da organização. A página de pagamento de planos e pacotes de horas é aberta em www.altifigence.com em uma nova janela ou aba.

A entrada Administração da organização é exibida para todas as funções em uma organização Business ou Academic. Membros sem permissões administrativas veem a página de orientação; a entrada não lhes concede permissões de administração.

Alterações exigem uma entrada recente

Toda alteração permitida pelas suas permissões na janela de administração exige uma entrada realizada nos últimos 10 minutos. Se sua última entrada for anterior a isso, a janela leva você à página de entrada e depois de volta à página em que estava. Dependendo da página, sua alteração é então retomada automaticamente uma vez ou você recebe uma solicitação para fazê-la novamente. Confira a página antes de repetir uma alteração.

Alterações em membros, grupos, funções e segurança exigem um motivo de até 1.000 caracteres, que é registrado com a alteração. A página Auditoria não mostra os motivos. Políticas e conexões também exigem um motivo, mas ele não é registrado. Não inclua senhas, chaves nem outras credenciais em nenhum motivo.

Se aparecer “Muitas solicitações”, aguarde alguns minutos e tente novamente.

Visão geral

O que faz. A Visão geral mostra o plano da organização, quantas licenças estão em uso, o período atual de QUOTA (a parcela restante e a data de redefinição) e as pendências: convites pendentes e problemas de faturamento, como uma forma de pagamento salva que expirou ou um contrato de equipe que não está ativo. Uma linha de avisos de segurança é exibida, mas ainda não está disponível. As visualizações do plano e de QUOTA precisam ser habilitadas pelo serviço.

Quem pode usar. Proprietário, Administrador e Faturamento por padrão. Aparecem apenas os cartões permitidos pelas suas permissões de leitura.

Etapas.

1. Abra a janela de administração. Visão geral é a primeira página.

2. Escolha Conferir ao lado dos convites pendentes para abrir a página Convites.

3. Escolha Abrir faturamento para ir a Faturamento quando houver um problema de faturamento.

Membros e convites

O que faz. Membros lista as pessoas da organização com sua função e status. Aqui você convida pessoas, altera funções, suspende ou remove membros, restaura um membro, transfere a propriedade e atribui funções personalizadas. O cartão Assentos pagos mostra o contrato e o uso de Standard/Premium quando os níveis estão configurados.

Quem pode usar. Proprietário e Administrador por padrão. Somente o proprietário pode transferir a propriedade.

Convide um membro

1. Abra Membros e escolha Convidar membro.

2. Digite o endereço de e-mail da pessoa e escolha Membro, Administrador ou Faturamento. Escolha Pago ou Gratuito (somente visualização); para um convite pago, escolha Standard ou Premium. Role para baixo para informar um motivo.

3. Escolha Enviar convite.

Novos convites recebem uma licença paga por padrão. A pessoa recebe um e-mail e aceita o convite no site de contas. Um convite expira 7 dias após o envio. O período é fixo e não pode ser alterado.

Acompanhe, reenvie ou cancele convites

1. Abra Membros e escolha Convites.

2. Confira o status de cada convite: Pendente, Aguardando uma licença, Aceito, Cancelado ou Expirado. A linha também mostra se o e-mail foi enviado e quando o convite expira.

3. Escolha Reenviar para enviar um novo e-mail e iniciar outro período de 7 dias. O link anterior deixa de funcionar. Aguarde um minuto entre os envios. São enviados no máximo 5 e-mails de convite para um endereço por dia.

4. Escolha Cancelar convite para impedir que um convite seja aceito. Para um convite cancelado ou expirado, escolha Enviar novamente.

Um convite pago marcado como Aguardando uma licença foi aceito quando todas as licenças pagas estavam em uso. Ele aguarda até que haja capacidade disponível de licenças pagas (consulte Licenças).

Altere uma função, suspenda ou remova um membro

1. Abra Membros e encontre a pessoa. A lista de membros pesquisa os membros carregados até o momento; escolha Carregar mais para incluir os demais.

2. Escolha Alterar função para definir Administrador, Membro ou Faturamento. A função Proprietário só é definida pela transferência de propriedade, e ninguém pode alterar a própria função.

3. Escolha Suspender para retirar o acesso. O membro perde o acesso e o trabalho que estava executando nessa organização é interrompido. Se a interrupção demorar um pouco, um aviso informa isso e a tentativa é repetida automaticamente.

4. Escolha Remover para remover a pessoa da organização.

5. Informe um motivo e confirme.

O proprietário não pode ser suspenso nem removido. Para alterar o proprietário, transfira a propriedade primeiro.

Restaure um membro por convite

O acesso não é restaurado diretamente. Um membro suspenso ou removido só retorna ao aceitar um novo convite.

1. Abra Membros e encontre o membro suspenso ou removido.

2. Escolha Restaurar.

3. Escolha a função e o tipo de assento para o novo convite e, se for pago, o nível. Role para baixo, informe um motivo e escolha Enviar convite.

4. A pessoa recebe um convite por e-mail e precisa aceitá-lo no site de contas antes de recuperar o acesso. Como qualquer convite, ele expira 7 dias após o envio.

Transfira a propriedade

Somente o proprietário pode fazer isso.

1. Abra Membros e escolha Transferir propriedade ao lado de um membro ativo com e-mail verificado.

2. Confirme que entende que deixará de ser o proprietário e informe um motivo.

3. Escolha Transferir propriedade. O membro se torna o proprietário e você passa a ser Administrador.

Licenças

O cartão Assentos pagos em Membros mostra a capacidade contratada e, quando disponíveis, o período dos assentos e o estado do contrato. Também mostra o uso de Standard e Premium em relação ao limite de cada nível. Use essas contagens por nível e os assentos restantes exibidos em Alterar assento para verificar a disponibilidade de assentos pagos. Alterar o tipo ou o nível do assento de um membro é uma operação separada da alteração da capacidade contratada.

Quando todos os assentos pagos estão em uso, um convite pago aceito agora aguarda capacidade disponível de assentos pagos. Mudar um membro ativo com assento pago para Gratuito (somente visualização), suspendê-lo ou removê-lo libera um assento pago. O aviso de limite excedido orienta a mudar membros para assentos gratuitos ou pedir ao proprietário da organização que altere a capacidade paga. A capacidade contratada não é alterada na janela de administração.

O cartão também avisa sobre o limite geral de assentos, a ausência de um registro de assentos ou um contrato que foi revogado, terminou ou ainda não começou. Se os limites por nível não estiverem configurados, ele mostra Os níveis de assento não estão configurados para esta organização. Entre em contato com a equipe de vendas. Não há link nem formulário de contato nesse cartão. Os números nas capturas de tela são dados de exemplo.

Tipos de licença

• Novos convidados recebem uma licença paga por padrão. Os membros existentes continuam com licenças pagas.

• Para alterar um assento, são necessárias as permissões Visualizar membros e Gerenciar assentos dos membros. Proprietários e administradores têm ambas por padrão; elas podem ser personalizadas por organização.

• Somente as licenças pagas contam para a capacidade de licenças pagas.

Para alterar seu próprio assento ou o de outro membro, abra Membros (/admin/<organization>/members) e escolha Alterar assento na coluna Assento desse membro. Selecione Pago ou Gratuito (somente visualização). Para Pago, escolha Standard ou Premium em Nível do assento pago; um nível lotado não está disponível para uma nova atribuição. Confira o efeito, informe o Motivo e escolha Salvar assento. É necessário um login recente, e o motivo é registrado no histórico de alterações. A função na organização permanece a mesma.

Selecionar Pago explica que um membro ativo usa um assento pago, sujeito à capacidade disponível, e mantém sua função na organização.

Se a caixa de diálogo mostrar Não há assentos disponíveis. ou informar que não há assentos disponíveis no nível selecionado, feche-a, atualize Membros e abra Alterar assento novamente quando houver capacidade disponível. Uma alteração rejeitada não pode ser reenviada nessa caixa de diálogo. Na nova caixa de diálogo, escolha um nível com assentos disponíveis ou entre em contato com o administrador da organização.

A capacidade de auditoria considera todos os membros ativos, incluindo membros gratuitos; consulte Retenção e capacidade da auditoria.

Permissões administrativas personalizadas

Cada organização pode personalizar permissões administrativas detalhadas para suas funções básicas e conceder permissões por meio de funções personalizadas a pessoas ou grupos.

As permissões da função de proprietário não podem ser reduzidas, e pelo menos um proprietário sempre mantém o gerenciamento de permissões. Quem gerencia permissões só pode conceder as que possui. Permissões administrativas não concedem acesso ao conteúdo dos projetos.

1. Abra Funções e encontre Permissões básicas (/admin/{organization-id}/roles). Você precisa da permissão Gerenciar permissões básicas.

2. Marque ou desmarque permissões para Administrador, Faturamento e Membro. Proprietário é fixo. As concessões de funções personalizadas continuam válidas mesmo que você desmarque a permissão correspondente da função básica.

3. Escolha Salvar alterações, confira as alterações, informe um motivo e escolha Salvar permissões. Salve no máximo 100 alterações de uma vez; atualize os mapeamentos antes de preparar outro lote.

4. Se o acesso ou a organização mudar, escolha Atualizar mapeamentos e descartar rascunho, confira os mapeamentos atuais e comece novamente.

A navegação segue as permissões efetivas. Uma concessão personalizada pode abrir a seção correspondente, mas entrar em uma seção não concede permissão para ler seus dados nem para executar todas as ações. Uma seção indisponível leva à primeira seção que você pode usar; sem nenhuma permissão administrativa, você vê a página de orientação. A edição de permissões precisa ser habilitada pelo serviço antes que as alterações possam ser salvas.

Grupos e funções personalizadas

O que faz. Uma função personalizada combina permissões existentes da organização. Um grupo atribui funções personalizadas a vários membros de uma vez. Você só pode incluir permissões que possui.

Quem pode usar. Proprietário e Administrador por padrão.

As permissões abrangem membros e convites, grupos e funções, gerenciamento de permissões, alterações de licença, segurança, políticas, conexões (incluindo desbloqueio de MCP), administração de projetos, uso e faturamento, além de acesso e configurações de auditoria. Selecione as permissões necessárias para o trabalho. Os padrões e as proteções do proprietário estão descritos em Permissões administrativas personalizadas.

Crie uma função personalizada.

1. Abra Funções e escolha Nova função.

2. Informe um nome e uma descrição para a função e selecione as permissões.

3. Informe um motivo e escolha Criar função.

Use Editar para alterar uma função. Remover exclui a função e também a retira de todos os membros e grupos que a possuem.

Atribua uma função personalizada a um membro. Abra Membros, escolha Funções personalizadas para a pessoa, selecione as funções e escolha Salvar funções. Você só pode atribuir funções cujas permissões possui.

Crie um grupo.

1. Abra Grupos e escolha Novo grupo.

2. Informe um nome para o grupo, selecione os membros ativos a adicionar e selecione as funções personalizadas que o grupo atribui.

3. Informe um motivo e escolha Criar grupo.

Use Editar para alterar um grupo. Remover exclui o grupo: seus membros perdem as permissões que ele concedia, e os membros em si não são removidos. Alterar um grupo que tem funções personalizadas exige a permissão para atribuir funções personalizadas.

Projetos

O que faz. Projetos lista os projetos da organização e gerencia a propriedade, o arquivamento e o acesso direto de membros e grupos aos projetos quando a administração de projetos está habilitada. A administração de projetos precisa ser habilitada pelo serviço.

Quem pode usar. Proprietário e Administrador por padrão. Leitura de projetos, gerenciamento de membros, gerenciamento de grupos, transferência de propriedade e arquivamento têm permissões separadas e personalizáveis. Ler o inventário não concede acesso ao conteúdo de projetos privados.

1. Abra Projetos (/admin/{organization-id}/projects). Use Pesquisar projetos para pesquisar por nome ou slug e Todos, Ativos ou Arquivados para filtrar. Escolha Carregar mais para ver mais resultados.

2. Escolha Gerenciar acesso em um projeto para abrir sua página de administração (/admin/{organization-id}/projects/{project-id}).

3. Em Membros, use Adicionar membro para atribuir uma função no projeto a um membro ativo da organização; use Alterar função ou Remover em uma linha existente. Responsáveis pelo faturamento não podem ser adicionados. Em Grupos, use Adicionar grupo e selecione Editor ou Visualizador. Um grupo não pode ser proprietário de um projeto. Remover uma concessão direta mantém qualquer acesso por grupo; remover uma concessão por grupo mantém as demais concessões.

4. Escolha Transferir propriedade. Se o projeto tiver vários proprietários, selecione Proprietário que transfere; um único proprietário é selecionado automaticamente, e um projeto sem proprietário não tem proprietário de origem. Selecione Novo proprietário, informe um motivo e confirme. O proprietário anterior continua como editor. Somente o proprietário da organização pode transferir um projeto pertencente ao proprietário da organização.

5. Escolha Arquivar projeto e confirme com um motivo. Um projeto arquivado continua legível no Cloud; as gravações de conteúdo são interrompidas, enquanto o gerenciamento de acesso continua disponível. Desarquivar projeto restaura a edição para pessoas com uma função de edição.

As ações aparecem conforme suas permissões. Adicionar pessoas ou grupos e escolher um novo proprietário também exige permissão para ler a lista correspondente de membros ou grupos. As alterações exigem uma entrada recente e um motivo. Depois de entrar novamente, repita a alteração no projeto; ela não é repetida automaticamente. Se um projeto mudar enquanto você estiver trabalhando, feche o formulário e comece novamente a partir da página atualizada.

Se a administração de projetos estiver desabilitada ou sua rota ainda não for oferecida, a página passa a mostrar os projetos dos quais você participa, explica as ações indisponíveis e oferece Abrir configurações do projeto. Outros erros do serviço são exibidos como erros. Essa alternativa não comprova que o serviço completo de administração está habilitado em produção. No Cloud, endereços antigos de Projetos em Configurações levam a esta página de administração de toda a organização somente depois que sua leitura de projetos é concluída com sucesso; se a leitura estiver pendente ou falhar, a página do console continua disponível.

Acesso à organização

A Conta oferece suporte à entrada interna e à administração da organização.

Suporte a logon único e provisionamento

Políticas

O que faz. Políticas define os limites para todos na organização: acesso ao Agent, ferramentas MCP, compartilhamento e quem pode criar projetos. As restrições da organização têm prioridade sobre preferências pessoais e de projeto, e são aplicadas pelo servidor, não apenas pela tela. Os padrões pessoais de Agent continuam em Configurações. As restrições da organização que antes estavam em Configurações, IA foram movidas para cá.

Quem pode usar. Proprietário e Administrador por padrão, conforme as permissões de leitura e atualização de políticas da organização.

Etapas.

1. Abra Políticas.

2. Em Acesso ao Agent:

   • Permitir chaves de API pessoais (BYOK) permite que os membros usem suas próprias chaves conectadas dentro das restrições existentes.

   • Permitir pesquisa na web permite que os membros escolham pesquisar. Eles ainda precisam dar qualquer consentimento exigido.

   • Limite de permissão do Agent define a permissão mais alta que um membro pode escolher: Perguntar, Permitir ou Automático.

3. Em Ferramentas MCP:

   • Habilitar MCP ativa o MCP para a organização. As ferramentas também precisam estar habilitadas na política de conexão e concedidas à organização.

   • Restringir às ferramentas selecionadas limita o MCP às ferramentas selecionadas em Ferramentas permitidas. Sem nenhuma seleção, todas as ferramentas MCP são negadas.

   • Ferramentas negadas sempre prevalecem sobre as permitidas.

4. Em Compartilhamento e projetos:

   • Permitir compartilhamento externo restringe ainda mais o compartilhamento de projetos onde ele é compatível. Isso não habilita o compartilhamento por link de projetos para organizações Business ou Academic. Atualmente, links de compartilhamento de projetos só podem ser criados para projetos pertencentes a organizações pessoais.

   • Restringir criação de projetos limita a criação às funções selecionadas em Funções com permissão para criar projetos. A lista se aplica a todas as funções, incluindo proprietários e administradores. Uma lista vazia nega a criação para todos.

5. Abra Restrições avançadas do Agent para acessar regras de domínio e limites de pesquisa na web, permissões e níveis de esforço que os membros podem usar, limites de saída e instruções, contexto de projeto que o Agent pode ler e período de retenção do histórico. As restrições existentes permanecem, e somente os controles que você alterar são salvos.

6. Informe um motivo (obrigatório, até 1.000 caracteres) e escolha Salvar políticas.

As gravações automáticas do Agent vêm desativadas por padrão. Um administrador autorizado de políticas (Proprietário e Administrador por padrão) pode habilitá-las em Acesso ao Agent → Limite de permissão do Agent, selecionando Automático. Isso permite gravações automáticas dentro das permissões existentes de projeto, ferramenta e gravação. Restrições avançadas do Agent → Permissões permitidas do Agent também permite editar o conjunto de permissões permitidas; ele precisa incluir Automático para ativar o recurso. Alterar outra política não habilita gravações automáticas.

A página mostra a versão da política e a revisão da organização. Se uma delas mudar durante a edição, recarregue as políticas atuais, confira suas alterações e salve novamente. A IA fornecida pela empresa aparece apenas como Agent; as políticas nunca mostram nomes de modelos.

Conexões

O que faz. Conexões gerencia contas de serviço, chaves de API da organização, as conexões MCP criadas pelos membros e a conexão Git da organização.

Quem pode usar. Proprietário e Administrador por padrão. A organização pode personalizar permissões separadas de leitura e gerenciamento para contas de serviço, chaves de API, MCP e Git.

Abra Conexões e escolha uma aba: Contas de serviço, Chaves de API, MCP ou Git da organização. As listas de contas de serviço, chaves de API e MCP mostram quando cada item foi criado e usado pela última vez. Toda alteração exige um motivo e uma entrada recente.

Uma chave é exibida uma única vez. Quando você cria ou rotaciona uma, a página mostra Salve sua nova chave. Copie-a e armazene-a com segurança. Ela não pode ser lida novamente e nunca é exibida em listas nem armazenada em logs. Se a perder, rotacione a chave para obter uma nova.

Contas de serviço

1. Escolha Criar conta de serviço, informe um nome e um motivo e confirme. O escopo é apenas acesso de leitura à organização.

2. Copie a chave quando ela for exibida e escolha Concluído.

3. Use Rotacionar para substituir as chaves da conta de serviço. Todas as chaves anteriores deixam de funcionar imediatamente.

4. Use Revogar para interromper a conta de serviço. Suas chaves são revogadas junto com ela.

Chaves de API da organização

1. Abra Chaves de API e escolha Criar chave de API. Informe um nome e um motivo e confirme.

2. Copie a chave quando ela for exibida e escolha Concluído.

3. Use Rotacionar para substituir uma chave. A chave anterior deixa de funcionar imediatamente. Use Revogar para interromper uma chave.

Uma chave concede apenas acesso de leitura à organização. Ela não concede acesso pelo navegador nem acesso administrativo. Para usar uma chave, envie GET /v1/organization-api/organization com Authorization: Bearer <organization API key> ao endpoint configurado da API da organização. Não envie cookies, cabeçalho Origin, parâmetros de consulta nem corpo de solicitação.

Conexões MCP

A aba MCP lista as conexões que os membros da organização fizeram com o Altifigence MCP, com o membro, o cliente, os escopos e as datas de criação, expiração e último uso de cada uma. As políticas da organização continuam em vigor.

Para encerrar uma conexão, escolha Revogar ao lado dela e confirme. Isso revoga todo o acesso MCP desse membro nesta organização, incluindo o acesso já emitido, e não afeta outros membros nem outras organizações. Um membro cujo acesso foi revogado continua bloqueado no MCP desta organização até que um administrador autorizado o desbloqueie explicitamente. O desbloqueio de MCP cabe a proprietários e administradores por padrão e é personalizável por organização. Entrar novamente, reconectar ou reativar Habilitar MCP não remove esse bloqueio específico do membro.

1. Abra Conexões → MCP (/admin/{organization-id}/connections).

2. Escolha Desbloquear acesso ao MCP. Informe o UUID de usuário do membro em ID de usuário do membro e informe o Motivo da alteração.

3. Escolha Confirmar. O membro precisa dar um novo consentimento OAuth. Conexões antigas, tokens de acesso, tokens de atualização e consentimentos incompletos continuam inutilizáveis; as negações da política da organização e as permissões de ferramentas continuam válidas.

A ação exige a permissão Desbloquear conexões MCP. Se a página informar que a API de desbloqueio está indisponível, ela precisa ser habilitada antes que a ação possa ser usada.

Conexões antigas cuja organização não pode ser verificada não são listadas, pois não podem ser atribuídas à organização com segurança. Esses membros precisam se conectar novamente, e isso não remove suas conexões antigas. Se a lista informar que o inventário está incompleto, vá à próxima página antes de considerá-lo completo.

Git da organização

Git da organização conecta uma instalação de GitHub App que pertence à sua organização. As conexões Git pessoais são gerenciadas separadamente.

1. Abra Git da organização e escolha Conectar GitHub.

2. Informe o ID da instalação do GitHub App atribuída à sua organização, informe um motivo e confirme.

3. Para desconectar, escolha Revogar. Isso impede a próxima autorização de Git da organização. Tokens do GitHub já emitidos podem continuar válidos até expirarem.

MCP e Git da organização exigem configuração para a sua organização. Se um deles não estiver disponível, a respectiva aba informa isso. Uma instalação de GitHub App precisa estar atribuída à sua organização antes que você possa conectá-la.

Uso e faturamento

O que faz. Uso mostra a QUOTA da organização e seu uso por membro, projeto e mecanismo, e permite exportá-lo em CSV. Faturamento mostra o plano, as licenças, as formas de pagamento, os dados de faturamento e as faturas da organização de equipe. As visualizações de Uso e Faturamento precisam ser habilitadas pelo serviço.

Quem pode usar. Proprietário, Administrador e Faturamento por padrão. As permissões de uso e faturamento são personalizáveis por organização; Faturamento tem apenas essas permissões administrativas por padrão. Sua assinatura pessoal não é gerenciada aqui: ela continua no site de contas, e Faturamento tem um link Abrir site de contas para ela.

Uso

1. Abra Uso. O cartão de QUOTA mostra a parcela de QUOTA restante, usada e reservada no período atual e quando ela é renovada ou redefinida. QUOTA é exibida como parcelas do período, não como valores absolutos.

2. Em Uso por membro, projeto ou mecanismo, escolha Membro, Projeto ou Mecanismo em Agrupar uso por. As linhas de mecanismo mostram Agent, Execução do projeto, o nome do mecanismo que executou uma tarefa, Tarefa do mecanismo ou Outros.

3. Escolha as datas De (UTC) e Até (UTC) e escolha Mostrar. Escolha um intervalo de relatório de até 92 dias de calendário em UTC, contando tanto a data De quanto a data Até. A data Até deve ser hoje (UTC) ou uma data anterior.

4. Leia as linhas: Usos, Créditos cobrados e Último uso. As colunas Cobrado (USD) e Qualificação nativa aparecem quando o intervalo contém essas cobranças; nesse caso, o relatório mostra cada linha como um bloco com rótulos em telas de até aproximadamente 1040 pixels de largura. Um total encerra o relatório. As linhas de membros mostram nomes para quem pode ler membros, “Você” na sua própria linha e uma chave curta para as demais pessoas.

5. Com permissão para exportar uso, escolha Exportar CSV para baixar o relatório. O arquivo lista os membros por uma chave pseudônima, e não por nome ou endereço de e-mail (o relatório de Membro informa isso abaixo do botão).

Quando você pode ler o relatório, o botão CSV aparece apenas com permissão de exportação de uso, um intervalo válido, uso detalhado disponível e pelo menos uma linha. Se você tiver permissão de exportação sem permissão de leitura do relatório, Exportar CSV fica disponível para um intervalo válido sem exibir o relatório; o serviço continua verificando o acesso e a disponibilidade do uso detalhado. O CSV de Uso contém resumos de consumo, em vez de eventos de auditoria. Esse download não cria o comprovante de exportação do histórico de auditoria descrito em Registro de auditoria.

Faturamento

1. Abra Faturamento. A aba Plano e pagamento mostra o plano, seu status, quando o período atual termina e qualquer alteração agendada.

2. Leia o resumo do contrato de assentos. Os planos de equipe e a capacidade de assentos pagos seguem seu contrato. Confira o uso de Standard/Premium em Membros para verificar a disponibilidade em cada nível. O tipo e o nível do assento de um membro são gerenciados separadamente em Licenças.

3. A página mostra Plano, Licenças, Formas de pagamento, Dados de faturamento e Assinatura pessoal nessa ordem, conforme suas permissões. Em Dados de faturamento, escolha Editar ao lado de Contato de faturamento, Endereço ou Empresa, altere essa seção e escolha Salvar. Cada seção é salva separadamente. As alterações se aplicam ao faturamento futuro; as faturas existentes mantêm seus dados originais. A página também mostra o próximo pagamento quando disponível.

Formas de pagamento

1. Em Formas de pagamento, confira as formas salvas e suas datas de validade.

2. Escolha Adicionar ou alterar forma de pagamento e depois Continuar para o provedor de pagamentos. O provedor de pagamentos abre em uma nova aba e o link funciona por pouco tempo.

3. Para remover uma forma salva, escolha Excluir e confirme. Uma forma usada por uma assinatura precisa ser substituída primeiro.

Faturas

1. Abra a aba Faturas.

2. Confira a data, o número da fatura, o valor e o status de cada fatura. Escolha Carregar mais para ver as mais antigas.

3. Escolha Obter PDF e depois Abrir PDF. Se um PDF não estiver pronto, a página informa isso.

Alterar ou excluir uma forma de pagamento ou editar dados de faturamento exige uma entrada nos últimos 10 minutos. Se a página mostrar Entrar novamente, escolha essa opção e faça a alteração de novo. Faturamento não mantém o que você digitou.

As permissões de leitura, exportação e alteração são separadas. Com permissão de alteração, mas sem permissão de leitura, a página pode permitir que você substitua uma seção de faturamento sem mostrar os dados salvos ou exclua uma forma de pagamento salva pelo ID. Siga as orientações da página sobre permissões e atualização antes de fazer uma alteração.

Registro de auditoria

O que faz. O registro de auditoria mostra as atividades de gerenciamento e os eventos de segurança da organização. Você pode pesquisar, filtrar e exportar em CSV ou JSON. Ele nunca mostra endereços de e-mail, endereços IP, conteúdos de solicitações nem os motivos informados pelas pessoas.

Quem pode usar. Proprietário e Administrador por padrão. Leitura/exportação de auditoria e configurações de auditoria têm permissões separadas que a organização pode personalizar.

O registro de auditoria inclui alterações de membros, convites, grupos, funções e permissões; alterações de acesso, propriedade e arquivamento de projetos; atividade de políticas e conexões da organização; uso registrado de chaves de API; alterações das configurações de auditoria; e leituras e exportações do histórico de auditoria. Alterações de políticas de segurança, alterações de domínios e Encerrar sessões de todos os membros também aparecem, junto com as negações de entrada por segurança da organização que foram registradas. Alterações dos dados de faturamento, remoção de formas de pagamento e solicitações do portal de faturamento registram uma intenção de autorização antes da operação do provedor e um resultado final separado quando ela é concluída. Uma intenção não comprova que a operação do provedor foi bem-sucedida. Apenas eventos explicitamente associados à organização aparecem; atividades históricas de entrada não relacionadas não são atribuídas com base na participação atual.

Retenção e capacidade da auditoria

A política de retenção de auditoria mantém os registros por 5 anos após o término do contrato. A exclusão automática por retenção está desativada no momento, portanto a configuração de retenção não exclui nem oculta registros. A configuração de retenção (padrão: 12 meses) só se aplica quando a exclusão automática por retenção é ativada.

Abra Auditoria → Retenção e capacidade de auditoria (/admin/{organization-id}/audit; capacidade: #capacity). É necessária permissão de leitura das configurações de auditoria para ver as configurações e o uso. Alterar as configurações também exige permissão de gerenciamento das configurações de auditoria; a permissão de gerenciamento sozinha não concede acesso de leitura. A permissão de leitura de eventos de auditoria é separada.

A configuração Retenção da organização (meses) aceita de 1 a 1.200 meses inteiros. Capacidade por membro (GB) tem como padrão 1 GB para cada membro ativo, incluindo membros gratuitos e pagos; 1 GB equivale a 1.000.000.000 de bytes. Essa contagem é separada da capacidade de assentos pagos. Capacidade alternativa da organização (GB; deixe em branco para usar os membros) substitui o total baseado nos membros. Remover um membro pode reduzir a capacidade para abaixo do uso armazenado e não exclui os registros existentes.

Para alterar essas configurações, informe um Motivo da alteração, escolha Salvar configurações, confira os valores antigos e novos e confirme. Ainda não é possível reduzir o período de retenção; você pode mantê-lo ou aumentá-lo. Para salvar, é necessário ter entrado nos últimos 10 minutos. Salvar uma configuração de retenção, por si só, não exclui registros nem libera espaço; a exclusão automática continua desativada.

Uso armazenado mostra os GB armazenados estimados em relação à capacidade e a porcentagem usada. Capacidade reservada (separada do uso armazenado) e Margem para resposta a incidentes (dentro da capacidade total) são mostradas separadamente. Crescimento recente por dia (adições brutas) calcula a média dos dias observados entre os últimos sete dias UTC completos; exclui hoje e não desconta exclusões. Menos de sete dias observados é indicado como baixa confiança. Data prevista de capacidade esgotada (UTC) aparece apenas quando os dados estão completos, atuais e são confiáveis. Quando essa previsão confiável chega a sete dias ou menos, esta página pode mostrar No ritmo atual, a capacidade se esgotará em cerca de {days} dias. e Ir para as configurações de capacidade, mesmo com os avisos automáticos desativados. Uso desconhecido não é zero; preenchimento retroativo, uso desatualizado e histórico arquivado indisponível têm mensagens separadas. Use Recarregar configurações e uso para verificar novamente. Um valor Desconhecido não tem um resultado atual confiável: ele pode ainda não ter sido calculado ou um resultado anterior pode estar desatualizado; não significa zero.

A aplicação dos limites de capacidade e os avisos automáticos de previsão estão desativados no momento. Se o uso armazenado atingir a capacidade, a página explica que a aplicação dos limites está desativada; atingir o total exibido não significa que a gravação parou ou que alterações de administração estão sendo recusadas. O arquivamento automático também está desativado. Exportar baixa uma cópia; não exclui registros nem libera capacidade.

A exclusão automática por retenção está desativada na versão de lançamento. Enquanto estiver desativada, a configuração de retenção não exclui nem oculta registros.

Pesquise no registro de auditoria

1. Abra Auditoria.

2. Informe um termo de pesquisa. A pesquisa é literal e abrange o código bruto da ação, o ID do autor da ação e o ID do alvo. Ela não pesquisa endereços de e-mail nem detalhes de eventos.

3. Restrinja os resultados com De (inclusivo) e Até (exclusivo) em UTC, Ação (correspondência exata), UUID de usuário do autor da ação e ID do alvo (correspondência exata). Em Ação, escolha um nome de evento compreensível ou insira um código de ação exato (letras, números e _ . : -). Identificadores do evento em cada evento mostra seu código bruto. Escolha Aplicar filtros ou Redefinir para começar novamente.

4. Leia cada evento. Seu título é a ação em linguagem simples, por exemplo Acesso MCP revogado ou Membro atualizado, com o resultado (Sucesso, Falha ou Bloqueado). Abaixo estão o momento em que ocorreu (UTC), o autor da ação, o alvo (seu tipo e ID), a origem e, em alguns eventos, detalhes como o provedor ou a quantidade de itens. Escolha Identificadores do evento para ver a ação bruta, o tipo bruto do alvo e a origem bruta. Um evento que a janela não reconhece é exibido como Evento desconhecido. Use Página anterior e Próxima página para navegar.

As páginas vêm de um retrato fixo dos dados, exibido como Retrato dos dados (UTC). Se o retrato ou o cursor expirar, aplique os filtros novamente para iniciar outra consulta.

Exporte o registro de auditoria

1. Aplique os filtros desejados.

2. Escolha Baixar página em CSV ou Baixar página em JSON.

3. Se houver mais registros disponíveis, escolha Exportar próxima página para a próxima página. Uma exportação nunca baixa o histórico inteiro por conta própria.

Cada página comporta até 1.000 linhas e 2 MiB de conteúdo UTF-8. Se uma página for grande demais, reduza o intervalo de datas ou os filtros. Cada página exige uma entrada nos últimos 10 minutos. Cada download registra um comprovante. A aplicação dos limites de capacidade está desativada no momento; exportar não libera capacidade de auditoria. No arquivo CSV, todas as células ficam entre aspas, e uma célula que começa com =, +, - ou @ recebe um apóstrofo no início. As colunas são id, organizationId, occurredAt, actorUserId, action, targetType, targetId, outcome e details.

A retenção e a capacidade estão descritas em Retenção e capacidade da auditoria. A exportação não libera espaço.

Mensagens comuns

Guias relacionados

Segurança da conta · Contas, licenças e faturamento · Autenticação MCP · Agent · Planos e preços

Os preços e as licenças dos planos de equipe seguem seu contrato. Este guia não informa preços.