Fundamentos de workspace

Um workspace guarda um conjunto de sistemas de IA: os workflows que você constrói e os recursos que eles usam — tabelas, arquivos, bases de conhecimento, integrações e secrets. Ele também define quem os vê. Todo recurso pertence a exatamente um workspace, e só os membros desse workspace têm acesso a ele. Um workflow de um workspace não consegue ler uma tabela de outro.

Pense em um workspace como uma pasta de projeto para sistemas de IA. Abra e tudo o que uma equipe precisa está em um só lugar: os procedimentos, os dados, as contas conectadas, o histórico de execuções e as configurações.

O que um workspace contém

A sidebar é o mapa de um workspace. Cada seção é um tipo de recurso:

Workflows

Um workflow é um procedimento salvo e repetível, feito de blocks: o principal recurso de um workspace. Você o edita, faz deploy dele em superfícies como uma API ou um chat, e o versiona. Veja Workflows para o modelo completo.

Tables

Uma tabela é dado estruturado no workspace, usada como fonte ou como saída dentro dos workflows.

Files

Um arquivo é um documento ou binário armazenado no workspace, legível pelos workflows e organizado em pastas.

Bases de conhecimento

Uma base de conhecimento é uma coleção de documentos ou dados estruturados que os workflows consultam para dar contexto a um modelo em tempo de execução.

Integrações

Uma integração é uma conta conectada de um serviço de terceiros (Gmail, Slack, GitHub e assim por diante). Cada uma tem o próprio controle de acesso, então a equipe compartilha uma única conexão. Veja Integrations.

Secrets

Um secret é uma chave de API ou variável de ambiente guardada com segurança no workspace. Os secrets têm dois escopos: os de Workspace são compartilhados com o workspace, e os Personal são privados seus. Veja Secrets.

Logs

Um log é o rastro de execução de uma execução de workflow: o trigger, os blocks que rodaram e a entrada, a saída e o erro de cada block. Os logs são como você verifica o que aconteceu.

Deployments não são uma seção da sidebar. Um deployment é um snapshot versionado de um workflow, disponibilizado para uso externo por meio de uma API, de um chat ou de um servidor MCP. Editar um workflow não altera um deployment ativo até você promover a nova versão, e fazer rollback significa promover uma versão anterior. Veja Deployments.

Acesso e isolamento

Tudo é delimitado pelo workspace, então acesso, configurações e isolamento funcionam da mesma forma:

  • Acesso. A participação é por workspace. Um membro vê todos os recursos dele, no nível que a permissão dele permite.
  • Configurações. Cada workspace tem a própria configuração: integrações, secrets, controle de acesso, chaves de API e mais. A página Settings lista o menu completo.
  • Isolamento. Recursos nunca atravessam workspaces. Para reutilizar um workflow em outro lugar, mova-o ou copie-o para aquele workspace.

Os membros entram com um de três níveis de permissão: Read, Write ou Admin (quem cria é Owner). Read pode visualizar, Write pode construir e executar, Admin também pode gerenciar membros e configurações. Veja Funções e permissões para o detalhamento completo.

Workspaces pessoais e de organização

Quase todo workspace é de um de dois tipos.

Um workspace pessoal fica sob a sua própria conta. Use para experimentação e trabalho individual. Seu plano define quantos você pode criar. Quando você entra em uma organização como membro interno, os workspaces pessoais que você possui passam para ela — a tela de aceite lista quais são antes de você aceitar.

Um workspace de organização (também chamado de workspace compartilhado) fica sob uma organização e está disponível nos planos Team e Enterprise. Você convida pessoas para um ou mais workspaces de uma vez, cada um com um nível de permissão, e escolhe se elas entram como membros ou como colaboradores externos. Membros internos entram na organização, contam no total de assentos e levam os próprios workspaces com eles. Membros externos ficam fora da organização — sem assento, e tudo o que possuem continua sendo deles — é assim que parceiros e clientes ganham acesso, e para isso eles já precisam ter um plano pago do Studio. Para agências e grandes empresas, é este o workspace que você entrega ao cliente: o app que ele usa, possui e mantém.

Limites de plano, contagem de assentos e a distinção entre interno e externo estão em Funções e permissões. Esta página explica o que é um workspace, não como a cobrança funciona.

Próximos passos