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

# Workspace

> Organize seu time, gerencie membros, API keys e o plano do seu workspace

O workspace é o espaço compartilhado onde você e seu time criam agentes, gerenciam clientes e operam o hub. Cada workspace tem seus próprios agentes, canais, integrações, membros e configurações.

<Note>
  Cada workspace tem **apenas um hub**. Se você precisa gerenciar múltiplos hubs com marcas diferentes, crie um workspace para cada um.
</Note>

## Criando e gerenciando workspaces

Você pode ter múltiplos workspaces na sua conta. No seletor de workspace, você alterna entre eles ou cria um novo:

* **Criar Workspace** — Abre o formulário para criar um novo workspace
* **Atalho** — `Ctrl+C` abre rapidamente o formulário de criação

Cada workspace é isolado dos outros — dados, agentes e clientes não são compartilhados entre workspaces diferentes.

## Membros e permissões

Adicione colaboradores para trabalhar com você no workspace. Cada membro tem um papel que define o que pode fazer.

### Papéis

| Papel      | Permissões                                                      |
| ---------- | --------------------------------------------------------------- |
| **Owner**  | Controle total: billing, exclusão do workspace, tudo            |
| **Admin**  | Gerencia agentes, canais, integrações, membros e configurações  |
| **Editor** | Cria e edita agentes, mas não gerencia membros ou configurações |
| **Viewer** | Apenas visualiza                                                |

### Convidando membros

Na aba **Membros** das configurações:

<Steps>
  <Step title="Preencha o e-mail">
    Digite o e-mail da pessoa que deseja convidar.
  </Step>

  <Step title="Escolha o papel">
    Selecione Owner, Admin, Editor ou Viewer.
  </Step>

  <Step title="Envie o convite">
    A pessoa recebe um e-mail com link para aceitar e entrar no workspace.
  </Step>
</Steps>

### Gerenciando membros

Na mesma aba você vê:

* **Seats utilizados** — Quantos membros você tem vs. o limite do seu plano (ex: 2/5)
* **Membros ativos** — Lista com nome, e-mail e papel. Botão "Remover" para revogar acesso
* **Convites pendentes** — Convites enviados mas não aceitos. Botão "Cancelar" para invalidar

## API Keys (Bring Your Own Key)

Por padrão, você usa os créditos da Gennia para consumir os modelos de IA. Mas se preferir, você pode conectar suas próprias API keys e pagar o provedor diretamente.

### Como funciona

Quando você configura a API key de um provedor:

* Os agentes que usam modelos desse provedor consomem a sua API key
* A cobrança vai direto para a sua conta no provedor (OpenAI, Anthropic, etc.)
* Você ainda consome **operações** da Gennia (tools, knowledge, mensagens), mas **não** consome créditos de tokens

### Provedores suportados

* **OpenAI** — GPT-4, GPT-4o, GPT-3.5 Turbo
* **Anthropic** — Claude 3.5 Sonnet, Opus, Haiku
* **Google** — Gemini
* **Together AI** — Modelos open-source
* **Inworld**

### Configurando uma API key

Na aba **API Keys** das configurações:

1. Encontre o card do provedor desejado
2. Clique em **Configurar** (ou **Editar** se já tem uma key)
3. Cole a sua API key
4. Clique em **Salvar**

Após salvar, o card mostra o status **Configurada** com os últimos caracteres da key visíveis e a data de configuração.

### Removendo uma key

Clique em **Remover** no card do provedor. Atenção: a ação é permanente e você precisará configurar uma nova key se quiser voltar a usar aquele provedor.

<Tip>
  Use BYOK quando o volume de consumo dos modelos justifica pagar direto aos provedores — geralmente é mais barato que créditos da Gennia em escala alta.
</Tip>

## Plano do workspace

O workspace tem um plano da Gennia que define os limites de uso. Esse plano é diferente dos planos que você cria para seus clientes no [Hub](/pt/hub).

O plano do workspace define:

* **Operações mensais** — Quantas ações os agentes podem executar (tools, knowledge, mensagens)
* **Seats** — Quantos membros podem fazer parte do workspace
* **Recursos habilitados** — Alguns recursos avançados podem depender do plano

### Consumo

Acompanhe o uso do seu plano no [Painel > Consumo](/pt/gestao/painel):

* Operações restantes vs. limite do mês
* Operações extras (avulsas, sem vencimento)
* Créditos de tokens (quando não usando BYOK)

### Atualizando o plano

Para mudar de plano ou comprar operações extras, acesse as configurações do workspace na aba de **Plano**.