Aumo Docs

Organizações e Workspaces

Os dois níveis em que tudo na AUMO é criado, compartilhado e cobrado.

Toda configuração da AUMO pertence a um de dois níveis. A Organização representa a empresa; o Workspace representa um time, produto ou projeto dentro dela.

Saber em qual nível uma coisa mora explica três perguntas que aparecem o tempo todo: quem pode alterá-la, quem a enxerga e onde o consumo dela é contabilizado.

Organização

Uma Organização é o limite externo da sua empresa na plataforma. Ela guarda o catálogo do que é permitido usar e as regras que valem para todo mundo.

Pertencem à Organização:

  • Provedores e Credenciais: as contas de modelos de IA e os segredos de acesso a sistemas externos.
  • SuperAgentes: os agentes externos registrados para a empresa.
  • MCPs e Integrações: o registro do que os workspaces podem instalar.
  • Membros e Quotas: quem entra na empresa e quanto ela pode gastar.

Uma pessoa pode participar de mais de uma Organização, com papel diferente em cada. Trocar de Organização troca o contexto inteiro.

Workspace

Um Workspace é onde o trabalho acontece. Ele consome o catálogo da Organização e monta coisas próprias em cima dele.

Pertencem ao Workspace:

  • Coleções: os documentos que alimentam as respostas.
  • Agentes e Workflows: o que as pessoas usam no Chat.
  • MCPs e Integrações instaladas: as ferramentas efetivamente ligadas.
  • Modelos, Variáveis, Membros, Quotas e Chaves de API.

Workspaces não enxergam um ao outro. Uma Coleção de um workspace não aparece para o Agente de outro, mesmo dentro da mesma Organização.

Até a versão 3 os workspaces se chamavam Projetos. O nome mudou em toda a plataforma na v4; o conceito é o mesmo.

Catálogo e instalação

Provedores de IA, MCPs, Integrações e SuperAgentes existem nos dois níveis, e isso é proposital. São dois passos diferentes:

  1. A Organização registra o item uma vez: a conta do provedor, o servidor MCP, a URL do SuperAgente. É aqui que segredos e aprovação vivem.
  2. O Workspace instala o que vai usar daquele catálogo, com nome e configuração próprios.

O mesmo item do registro pode ser instalado várias vezes no mesmo workspace, desde que cada instalação tenha um nome diferente. A configuração pertence à instalação, não ao registro.

Esse desenho existe para que uma credencial fique guardada em um lugar só, enquanto cada time decide o que ligar. Um workspace nunca cria uma conta de provedor por conta própria.

Onde isso aparece na prática

Três consequências que valem lembrar:

  • Permissão: o seu papel na Organização e o seu papel em cada Workspace são independentes. Você pode ser Admin da empresa e não ser membro de um workspace específico.
  • Consumo: o gasto de tokens é atribuído ao workspace que fez a chamada, e sobe para a Organização no total.
  • Isolamento: mover conhecimento entre workspaces significa recriar a Coleção, não compartilhá-la.

Próximos passos

Nesta página