Ir para o conteúdo
decodecodeveloper docs
Studio

Quickstart

Do zero a um agente funcionando em 5 minutos

Coloque o Studio para rodar

Cadastre-se em studio.decocms.com e está tudo pronto.

  1. Crie sua conta (email, GitHub ou Google)
  2. Crie uma organização — seu workspace de nível mais alto
  3. Pronto, você está dentro.

App desktop (recomendado para agents locais)

O app desktop nativo permite que agents rodem na sua máquina — com seus arquivos, suas ferramentas e sua assinatura existente do Claude Code ou Codex como harness. O Studio continua cuidando do chat, das connections e dos logs.

brew tap decocms/studio https://github.com/decocms/studio
brew install --cask deco-studio

Por enquanto, macOS (Apple Silicon). Veja onde um agent roda para entender como runtimes locais funcionam.

Quer rodar o servidor do Studio na sua própria infraestrutura? Veja Self-hosting.

AI provider (já configurado para você)

Novas organizações começam com créditos no Deco AI Gateway, então você pode começar a conversar com agentes imediatamente — sem nenhuma configuração.

Quando quiser usar suas próprias keys (Anthropic, Google, OpenRouter, etc.) ou verificar quanto resta do crédito do gateway, vá em Settings → AI Providers. Veja AI Providers para a lista completa.

Comece a conversar (Decopilot)

Você não precisa construir nada para começar. A tela inicial é um composer de chat — "O que você precisa?" — alimentado pelo Decopilot, o assistente embutido do Studio. Digite um pedido e ele põe mãos à obra, usando quaisquer tools que você tenha conectado. Cada conversa fica salva em Decopilot, na sidebar à esquerda.

Quando estiver pronto para criar um worker focado e reutilizável, crie um agent dedicado.

Crie um agent

Use o botão + / "Browse agents" na sidebar para criar um novo agent. Assim que ele abrir, a tela se divide em duas partes:

  • Esquerda — o chat. Acima do input ficam o model-tier picker e o runtime picker (onde o agent roda — na cloud ou na sua própria máquina; veja Agents).
  • Direita — um painel com abas. A aba Settings guarda instruções, connections e arquivos; Automations guarda schedules e triggers. Outras abas (Preview, Content, Review changes) aparecem apenas para agents vinculados a um repo ou site.

Abra a aba Settings e escreva uma instrução de uma linha descrevendo o que este agent deve fazer.

Anexe uma connection

Connections são as tools que seu agent pode usar — GitHub, Slack, Shopify, seu banco de dados, seu próprio MCP server. Você pode adicioná-las diretamente a partir do agent que acabou de criar:

  1. No painel direito do agent, em Settings, abra a seção Connections
  2. Clique em Add connection
  3. Pesquise no catálogo (ex.: Gmail) ou escolha Custom Connection para adicionar um MCP server não listado
  4. Clique em Connect e siga o fluxo de sign-in ou cole uma key
  5. Escolha quais tools dessa connection este agent deve ter

As credenciais são criptografadas e nunca expostas ao seu time. Connections adicionadas dessa forma ficam armazenadas no nível da org — aparecem em Settings → Connections e podem ser anexadas a outros agents também.

Você também pode começar por Settings → Connections e instalar uma connection antecipadamente, e depois anexá-la aos agents. O resultado é o mesmo — escolha a ordem que fizer mais sentido.

O catálogo lista os MCPs do registry da Deco.

Converse com ele

Basta digitar. O agent usa as tools que você anexou.

Send an email to me@example.com with a poem about MCP.

Acompanhe a execução no chat. Cada chamada de tool é registrada em Settings → Monitor.

Tudo pronto! A partir daqui, configure Automations para rodar agents em um schedule ou evento, convide members do time, ou construa mais agents.

Próximos passos

  • Key concepts — Anatomia do Studio: o shell do agent vs. Settings
  • Agents — Como desenhar e configurar agents
  • Decopilot — O assistente de IA embutido no Studio
  • Self-hosting — Deploy em Docker Compose ou Kubernetes