O que é Studio
Uma plataforma extensível para conectar contexto, organizar trabalho e executar agentes
Studio é a plataforma para organizar e executar trabalho com agentes de IA. Conecte ferramentas e dados, transforme solicitações em tarefas e dê aos agentes um ambiente para produzir resultados que sua equipe possa revisar.
Studio atende equipes de software, automações internas e fluxos personalizados. Storefront é uma aplicação dessa plataforma: seu Editor de Sites roda dentro do Studio, enquanto a documentação do framework e da edição pertence a Storefront.
A plataforma não determina o que você deve criar. Uma equipe pode usar o mesmo workspace para investigar um pedido de suporte, desenvolver um app interno ou alterar um repositório. As conexões fornecem o contexto; agentes e tarefas conduzem o trabalho; MCP Apps oferecem uma interface quando a conversa, por si só, não é suficiente.
Três partes conectadas
Trazer contexto para o trabalho
Conexões disponibilizam sistemas externos por MCP. Uma conexão pode expor um repositório, um sistema de negócio, uma fonte de dados ou um servidor que você criou. Associe as ferramentas e os arquivos relevantes ao agente para que ele tenha o contexto necessário.
Você escolhe quais ferramentas o agente pode usar. Assim, cada fluxo fica próximo dos sistemas de que precisa, com as credenciais e o acesso da conexão gerenciados na sua organização. Consulte Agentes para definir uma função e selecionar suas ferramentas.
Sinais e objetivos descrevem a parte inicial do fluxo: encontrar algo que merece atenção e decidir como isso se relaciona às suas metas. A disponibilidade de cada parte aparece abaixo.
Organizar e interagir com o trabalho
Tarefas oferecem um lugar para descrever o resultado desejado, acompanhar o progresso e orientar a execução. Os comentários preservam decisões e feedback junto do trabalho.
Studio também suporta interfaces ricas por MCP Apps. Crie um app quando seu fluxo precisar de um painel, um editor ou uma revisão interativa. O guia de MCP Apps explica o modelo de extensão reutilizável.
Executar e entregar
Os agentes usam ferramentas e ambientes de execução adequados à tarefa. Em trabalhos com repositórios, um sandbox pode oferecer checkout, servidor de desenvolvimento e preview. O resultado pode ser uma branch e um pull request que a equipe revisa antes da publicação.
Leia Arquitetura para entender os ambientes de execução e Revisões e QA para conhecer o fluxo de entrega.
O ciclo completo sinais → objetivos → tarefas está evoluindo. Tarefas já são usadas diariamente; sinais estão se tornando contínuos; objetivos estão planejados. Fluxos e entrega explicita essas diferenças.
Uma tarefa, do contexto à revisão
Considere uma equipe criando uma interface de triagem de suporte. Esse trabalho precisa de um repositório, uma base de conhecimento e ferramentas para ler os pedidos de suporte originais.
- Conecte o contexto. Adicione as conexões MCP relevantes e dê ao agente as ferramentas e os documentos necessários para a tarefa.
- Descreva o resultado. Peça uma interface que agrupe os pedidos urgentes primeiro e preserve os links dos registros originais. Defina quem vai usá-la e como a equipe verificará seu funcionamento.
- Trabalhe com o agente. Acompanhe a tarefa no quadro e adicione comentários quando os requisitos precisarem de esclarecimento. Para mudanças no código, o ambiente de execução fornece o checkout e as ferramentas para rodar o app.
- Revise o resultado. Confira o preview em execução, os checks e a branch ou o pull request. Sua equipe decide quando a mudança está pronta para entrega.
A tarefa reúne o pedido e a conversa, permitindo que a próxima pessoa entenda as decisões por trás do resultado. Escrever uma tarefa explica como definir resultados verificáveis, e Revisões e QA descreve o processo de entrega.
Ferramentas podem ter uma interface
Um agente pode usar diretamente o resultado estruturado de uma ferramenta. Pessoas costumam precisar de outra forma de trabalhar com os mesmos dados: uma tabela com filtros, um editor ou uma revisão interativa.
Um MCP App conecta essas duas formas de interação:
- Uma ferramenta fornece uma funcionalidade e seu resultado estruturado.
- Um recurso serve a interface HTML do app. A ferramenta identifica esse recurso nos seus metadados de interface.
- O Studio, como host, carrega o app e transmite a entrada e o resultado da ferramenta. O app também pode enviar mensagens para a conversa.
| Pedido | Prioridade | Status |
|---|---|---|
| Acesso à conta | Alta | Em revisão |
| Dúvida de cobrança | Normal | Atribuído |
| Ajuda na configuração | Normal | Novo |
Resultado estruturado da ferramentaJSON
{
"requests": [
{
"subject": "Acesso à conta",
"priority": "Alta",
"status": "Em revisão"
},
{
"subject": "Dúvida de cobrança",
"priority": "Normal",
"status": "Atribuído"
},
{
"subject": "Ajuda na configuração",
"priority": "Normal",
"status": "Novo"
}
]
}A triagem de suporte é um exemplo; o modelo de extensão também atende painéis, ferramentas de revisão e fluxos internos personalizados. Comece por Criar ferramentas, depois consulte Resources e Criar MCP Apps para conectar uma ferramenta à sua interface.
O Editor de Sites usa esse modelo de extensão para websites. Seus guias de configuração com Blocks, edição visual e publicação ficam em Storefront, junto do framework que executa o site.
Os conceitos principais
- Organização: membros, acesso, conexões e configurações compartilhadas.
- Projeto: o contexto de um site, repositório, integração ou outro trabalho.
- Tarefa: um resultado a executar, revisar e concluir.
- Conexão: uma integração MCP que disponibiliza ferramentas e contexto.
- MCP App: uma interface rica para interagir com ferramentas ou fluxos dentro do Studio.
Consulte Conceitos principais para entender as telas do produto e Estrutura do projeto para conhecer o código de uma extensão.
Escolha por onde começar
| Objetivo | Comece aqui |
|---|---|
| Usar Studio e conectar uma ferramenta | Quickstart |
| Criar um agente com uma função específica | Agentes |
| Organizar trabalho e entregar mudanças | Tarefas e o quadro |
| Criar uma integração ou interface rica | Criar MCP Apps |
| Rodar Studio na sua infraestrutura | Hospedagem própria |
| Criar ou operar um site com Blocks | Storefront |
Executar Studio
Use studio.decocms.com, o aplicativo desktop descrito no Quickstart ou uma instalação própria. O repositório aberto contém a implementação da plataforma.