Ir para o conteúdo
decodecodeveloper docs
Studio

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.

  1. Conecte o contexto. Adicione as conexões MCP relevantes e dê ao agente as ferramentas e os documentos necessários para a tarefa.
  2. 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.
  3. 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.
  4. 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.
Triagem de suporte · Exemplo de MCP App
Triagem de suporte3 pedidos
PedidoPrioridadeStatus
Acesso à contaAltaEm revisão
Dúvida de cobrançaNormalAtribuído
Ajuda na configuraçãoNormalNovo
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 ferramenta fornece dados estruturados. Um recurso MCP fornece a interface. Experimente o filtro de prioridade para ver como o app apresenta o mesmo resultado a uma pessoa. Este exemplo usa dados ilustrativos.

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

ObjetivoComece aqui
Usar Studio e conectar uma ferramentaQuickstart
Criar um agente com uma função específicaAgentes
Organizar trabalho e entregar mudançasTarefas e o quadro
Criar uma integração ou interface ricaCriar MCP Apps
Rodar Studio na sua infraestruturaHospedagem própria
Criar ou operar um site com BlocksStorefront

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.