> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Controles de Acesso a Modelos

> Restrinja quais modelos de IA os membros do seu workspace Krea podem usar com modos de lista de permissões e lista de bloqueio para conformidade, governança e políticas de segurança.

<Info>
  **Apenas Business e Enterprise** — Os Controles de Acesso a Modelos estão disponíveis nos planos Business e Enterprise. [Entre em contato com nossa equipe de vendas](mailto:sales@krea.ai) para saber mais.
</Info>

Os Controles de Acesso a Modelos permitem que os proprietários e administradores de workspace decidam quais modelos de IA estão disponíveis para a sua equipe. Você pode restringir modelos no nível do workspace ou de membros individuais.

Isso é especialmente útil para organizações que precisam estar em conformidade com políticas de fornecedores, requisitos de governança de dados ou padrões internos de segurança.

## Conceitos Principais

### Dois Modos

O Krea oferece dois modos de controle de acesso que determinam como os modelos são tratados por padrão:

<CardGroup cols={2}>
  <Card title="Permitir Todos (Lista de Bloqueio)" icon="shield-check">
    Todo modelo está **disponível por padrão**. Você bloqueia explicitamente os que não quer.

    Novos modelos adicionados ao Krea ficam **automaticamente disponíveis**.
  </Card>

  <Card title="Bloquear Todos (Lista de Permissões)" icon="shield-xmark">
    Todo modelo está **bloqueado por padrão**. Você permite explicitamente os que aprova.

    Novos modelos adicionados ao Krea ficam **automaticamente bloqueados** até que você os permita.
  </Card>
</CardGroup>

<Tip>
  Se a sua organização precisa revisar e aprovar cada modelo antes que ele fique disponível, use o modo **Bloquear Todos (Lista de Permissões)**. Isso garante que novos modelos nunca fiquem acessíveis até que um administrador os habilite explicitamente.
</Tip>

### Políticas Hierárquicas

O acesso a modelos é aplicado em vários níveis. Cada nível pode restringir ainda mais — mas nunca expandir — o acesso concedido pelo nível acima.

| Nível         | Escopo                                        | Disponibilidade  |
| ------------- | --------------------------------------------- | ---------------- |
| **Workspace** | Aplica-se a todos no workspace                | Disponível agora |
| **Membro**    | Restringe o acesso de um membro individual    | Disponível agora |
| **Projeto**   | Restringe o acesso para um projeto específico | Em breve         |

<Note>
  Uma política de membro só pode restringir modelos que já estão permitidos no nível do workspace. Ela não pode conceder acesso a um modelo que o workspace tenha bloqueado.
</Note>

## Pré-requisitos

<CardGroup cols={2}>
  <Card title="Papel no Workspace" icon="user-shield">
    Você precisa ser **proprietário do workspace** ou **administrador**
  </Card>

  <Card title="Plano Business ou Enterprise" icon="building">
    Os Controles de Acesso a Modelos exigem uma assinatura Business ou Enterprise
  </Card>
</CardGroup>

## Escolher um Modo de Controle de Acesso

Por padrão, novos workspaces começam no modo **Permitir Todos (Lista de Bloqueio)**. Para alternar:

<img src="https://mintcdn.com/krea/yXUnvYlVwIGpwFus/images/model-access-mode-toggle.png?fit=max&auto=format&n=yXUnvYlVwIGpwFus&q=85&s=90ca873c8201790a5fd43e8ecac6fa63" alt="Toggle de modo de Acesso a Modelos nas Configurações do Workspace" width="754" height="112" data-path="images/model-access-mode-toggle.png" />

<Steps>
  <Step title="Abra as Configurações do Workspace">
    Navegue até [Workspace Settings ↗](https://www.krea.ai/settings/workspace-settings) e encontre a seção **Model Access**.
  </Step>

  <Step title="Selecione um Modo">
    Clique em **Permitir Todos (Lista de Bloqueio)** ou em **Bloquear Todos (Lista de Permissões)**.
  </Step>

  <Step title="Confirme a Troca">
    Um diálogo de confirmação explicará o impacto:

    * **Alternar para Bloquear Todos (Lista de Permissões):** Todos os modelos serão bloqueados por padrão. Todos os modelos atualmente disponíveis serão adicionados à lista de permissões como ponto de partida, então nada muda imediatamente — mas qualquer novo modelo adicionado ao Krea no futuro será bloqueado até que você o permita.
    * **Alternar para Permitir Todos (Lista de Bloqueio):** Todos os modelos serão permitidos por padrão. Sua lista de permissões atual será apagada.

    Clique em **Confirm** para aplicar.
  </Step>
</Steps>

<Warning>
  Alternar os modos apaga todas as políticas em nível de membro. Apenas as regras em nível de workspace são preservadas (ou redefinidas). Certifique-se de coordenar com sua equipe antes de alternar.
</Warning>

## Gerenciar Acesso em Nível de Workspace

Depois de escolher um modo, você pode configurar quais modelos bloquear ou permitir no nível do workspace.

<img src="https://mintcdn.com/krea/yXUnvYlVwIGpwFus/images/model-access-table.png?fit=max&auto=format&n=yXUnvYlVwIGpwFus&q=85&s=d007c9b10a8a752d7d448352785080bd" alt="Tabela de acesso a modelos mostrando modelos, provedores e status de acesso" width="1274" height="1014" data-path="images/model-access-table.png" />

<Steps>
  <Step title="Abra as Configurações de Acesso a Modelos">
    Em [Workspace Settings ↗](https://www.krea.ai/settings/workspace-settings), expanda o cartão **Model Access**.
  </Step>

  <Step title="Encontre Modelos">
    Use a **barra de busca** para filtrar modelos por nome ou provedor. A tabela mostra o nome de cada modelo, o provedor, o custo estimado de computação e o status atual de acesso.
  </Step>

  <Step title="Selecione Modelos">
    Marque as caixas ao lado dos modelos que você deseja alterar.
  </Step>

  <Step title="Aplique as Alterações">
    * **No modo Lista de Bloqueio:** Clique em **Block** para restringir os modelos selecionados, ou **Allow** para desbloqueá-los.
    * **No modo Lista de Permissões:** Clique em **Allow** para conceder acesso aos modelos selecionados, ou **Block** para removê-los da lista de permissões.
  </Step>
</Steps>

## Gerenciar Acesso em Nível de Membro

Você pode personalizar o acesso a modelos para membros individuais do workspace.

<Steps>
  <Step title="Vá até Membros">
    Navegue até [Members ↗](https://www.krea.ai/settings/members).
  </Step>

  <Step title="Abra o Menu do Membro">
    Encontre o membro que você quer configurar e clique no **menu de três pontos** na linha dele.

    <img src="https://mintcdn.com/krea/yXUnvYlVwIGpwFus/images/model-access-member-menu.png?fit=max&auto=format&n=yXUnvYlVwIGpwFus&q=85&s=43978f6445ffc087cc3175f88a9c8494" alt="Menu de três pontos do membro com a opção Manage Feature Access" width="454" height="242" data-path="images/model-access-member-menu.png" />
  </Step>

  <Step title="Selecione Manage Model Access">
    Clique em **Manage Model Access**. A tabela de modelos será automaticamente expandida inline abaixo da linha do membro.
  </Step>

  <Step title="Configure Modelos">
    Bloqueie ou permita modelos para esse membro. Modelos bloqueados no nível do workspace aparecerão acinzentados.
  </Step>
</Steps>

## Como Novos Modelos São Tratados

Essa é a diferença mais importante entre os dois modos:

| Cenário                           | Permitir Todos (Lista de Bloqueio)                | Bloquear Todos (Lista de Permissões)                         |
| --------------------------------- | ------------------------------------------------- | ------------------------------------------------------------ |
| Novo modelo adicionado ao Krea    | Automaticamente **disponível** a todos os membros | Automaticamente **bloqueado** para todos os membros          |
| Ação do administrador necessária? | Apenas se você quiser **bloqueá-lo**              | Sim — é preciso **permiti-lo** antes que alguém possa usá-lo |

<Warning>
  Se você precisa que novos modelos sejam bloqueados por padrão — por exemplo, para impedir que modelos não aprovados de fornecedores fiquem disponíveis para sua equipe — certifique-se de que seu workspace esteja no modo **Bloquear Todos (Lista de Permissões)**.
</Warning>

## Downgrade do Seu Plano

Se o seu workspace fizer downgrade para um plano que não inclui Controles de Acesso a Modelos, todas as políticas de acesso são removidas automaticamente e o seu workspace volta ao comportamento padrão em que todos os modelos estão disponíveis.

<Note>
  Fazer upgrade novamente não restaurará suas políticas anteriores. Você precisará reconfigurá-las.
</Note>

## Solução de Problemas

<AccordionGroup>
  <Accordion title="Não vejo a seção Model Access em Workspace Settings">
    Os Controles de Acesso a Modelos só estão disponíveis nos planos **Business** e **Enterprise**. Se você estiver em outro plano, verá um aviso de upgrade. [Gerencie sua assinatura ↗](https://www.krea.ai/settings/workspace-settings) ou [entre em contato com vendas](mailto:sales@krea.ai) para fazer upgrade.
  </Accordion>

  <Accordion title="Novos modelos continuam aparecendo como disponíveis">
    Seu workspace está no modo **Permitir Todos (Lista de Bloqueio)**. Nesse modo, novos modelos ficam disponíveis por padrão. Alterne para o modo **Bloquear Todos (Lista de Permissões)** para garantir que novos modelos sejam bloqueados até que você os permita explicitamente. Veja [Escolher um Modo de Controle de Acesso](#choose-an-access-control-mode).
  </Accordion>

  <Accordion title="Um membro ainda consegue usar um modelo que eu bloqueei">
    * Verifique se o bloqueio foi aplicado no nível correto (workspace ou membro).
    * Verifique se o modo do workspace está correto — no modo Lista de Permissões, o modelo precisa estar ausente da lista de permissões para ser bloqueado.
  </Accordion>

  <Accordion title="Não consigo permitir um modelo que está acinzentado">
    O modelo está bloqueado no nível do workspace. Uma política em nível de membro não pode sobrescrever restrições do nível acima. Peça a um administrador do workspace que permita o modelo no nível do workspace primeiro.
  </Accordion>

  <Accordion title="Eu alternei os modos e perdi minhas políticas de membro">
    Alternar entre os modos Lista de Bloqueio e Lista de Permissões apaga todas as políticas em nível de membro. Isso é esperado porque a semântica das regras muda entre os modos. Você precisará reconfigurar as políticas de membro depois de alternar.
  </Accordion>
</AccordionGroup>

## Precisa de Ajuda?

<CardGroup cols={2}>
  <Card title="Suporte Enterprise" icon="headset" href="mailto:support@krea.ai">
    Entre em contato com nossa equipe de suporte enterprise em **[support@krea.ai](mailto:support@krea.ai)**
  </Card>

  <Card title="Equipe de Vendas" icon="envelope" href="mailto:sales@krea.ai">
    Dúvidas sobre planos Business ou Enterprise? Envie um email para **[sales@krea.ai](mailto:sales@krea.ai)**
  </Card>
</CardGroup>