Claude Code CLI: Programação com IA · Capítulo 22 de 23 · 18 min
O painel que se atualiza sozinho e o processo que roda sem você (Artifacts e Agent SDK)
Do relatório que se atualiza sozinho ao processo que roda sem ninguém no comando: o degrau de automação com Artifacts, Agent SDK, Managed Agents e skills, e a régua de quando subir.
Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA. Para marcar como concluído e salvar o progresso, abra este capítulo na página do curso.
Chega um ponto em que o uso assistido cansa. Você já sabe pedir ao Claude que leia a planilha, cruze com o histórico e escreva o parecer. Funciona, mas depende de você abrir a sessão, digitar o pedido e esperar a resposta. Duas frustrações costumam aparecer quase juntas. Na primeira, o gestor quer que o número da operação chegue vivo, atualizado, sem alguém rodar o relatório toda segunda-feira. Na segunda, existe uma rotina que se repete idêntica todo dia, e manter uma pessoa no comando dela virou desperdício. Este capítulo trata do degrau seguinte, quando a saída deixa de ser um texto que você lê e passa a ser uma página que se atualiza sozinha ou um processo que roda sem ninguém apertando o botão.
Dois movimentos diferentes moram nesse mesmo degrau. Um é tornar a saída viva: em vez de um relatório congelado no horário em que foi gerado, uma página que se reescreve conforme os dados mudam. O outro é tornar o processo autônomo: em vez de você conduzir a sessão passo a passo, um agente em código conduz sozinho. Os dois elevam a régua de responsabilidade, porque agora algo acontece sem a sua supervisão direta a cada movimento.
Comece pelo mais simples de operar, que é o número vivo. No claude.ai, a saída de uma sessão pode virar um Artifact: uma página compartilhável que se atualiza no próprio lugar conforme a sessão trabalha. O recurso está em beta nos planos Team e Enterprise. A diferença que importa para gestão está no que uma versão publicada consegue fazer sozinha: ela puxa dados ao vivo e age pelos conectores MCP de cada pessoa que abre a página. É isso que transforma um Artifact em dashboard vivo ou em ferramenta interativa, em vez de uma foto estática do momento em que foi criado.
Um Artifact publicado que puxa dados ao vivo age pelos conectores MCP de cada pessoa que abre a página, e não pelos seus. Isso é vantagem e risco ao mesmo tempo. A vantagem: cada leitor enxerga a sua fatia legítima, com as próprias credenciais, sem você intermediar acesso. O risco: você precisa saber a quais fontes o painel se conecta antes de espalhar o link, porque a página vai agir com o crachá de quem estiver do outro lado.
Um dashboard vivo com dado sensível merece o mesmo cuidado de um relatório financeiro que sai da sala de reunião. Use os papéis de editor e controle o alcance dos links de compartilhamento disponíveis em Team e Enterprise. Link público é para número que você mostraria a qualquer pessoa. Painel de receita, pipeline ou folha de pagamento fica restrito a quem tem direito de ver.
Mostrar o número vivo é uma coisa. Fazer o processo rodar sozinho é outra, e aqui a interface para de ser o caminho. O Cowork é produto de interface: você conversa com ele e ele executa dentro do aplicativo, mas não existe API pública para acioná-lo de fora. Quando a automação precisa virar código, surgem dois caminhos oficiais. O Claude Agent SDK, em Python e TypeScript, é a mesma base sobre a qual o Claude Code e o próprio Cowork foram construídos: com ele, o seu time monta um agente sob medida em código. Os Managed Agents são agentes hospedados pela Anthropic e acionados via Claude API, para quando o agente precisa rodar no servidor, dentro de um processo de produção, sem depender de alguém com o app aberto.
Cowork
produto de interface, sem API pública
você conversa e ele executa dentro do app
Agent SDK (Python / TypeScript)
seu time monta um agente próprio em código
mesma base do Claude Code e do Cowork
Managed Agents
agente hospedado pela Anthropic, via Claude API
roda no servidor, dentro de um processo de produçãoPense assim. O Cowork é o profissional que trabalha ao seu lado na mesa, ótimo enquanto você está ali conversando com ele. O Agent SDK é contratar a engenharia para construir um robô próprio, que executa exatamente o seu fluxo e roda na sua infraestrutura. Os Managed Agents são alugar esse robô já montado e hospedado, plugado direto no seu sistema pela API. Os dois últimos são degraus de desenvolvimento e quase sempre envolvem o seu TI ou um desenvolvedor. Se você não programa, o seu papel aqui é desenhar a regra de negócio e o critério de sucesso, e deixar quem programa cuidar da montagem.
Antes de partir para um agente autônomo, padronize o que já se repete. Uma skill é uma tarefa recorrente empacotada em uma pasta com um arquivo SKILL.md, carregada sob demanda quando o contexto pede. Os antigos comandos de barra customizados foram unificados nesse formato, e já existe uma skill embutida, a /dataviz, para gerar gráficos. Na prática, quase toda empresa tem de cinco a dez tarefas que valem virar skill: o fechamento semanal, o padrão de resposta para um tipo de chamado, a checagem de uma cláusula de contrato. Quando o volume cresce, o Claude chega a escrever um script que orquestra dezenas a centenas de sub-agentes, cada um cuidando de um pedaço. Os sub-agentes rodam em segundo plano por padrão e podem, eles mesmos, abrir novos sub-agentes, com o encadeamento limitado a cinco níveis.
A tarefa se repete igual?
|
+-------------+-------------+
| |
NAO SIM
| |
Mantenha assistido E reversivel e de baixo risco?
(voce conduz a sessao) |
+-------------+-------------+
| |
NAO SIM
| |
Tem julgamento, risco ou Automatize de ponta a ponta
dado sensivel? (Agent SDK ou Managed Agents)
|
Humano no laco:
Claude propoe, pessoa aprovaMantenha o humano no laço quando a tarefa envolve julgamento, risco ou dado sensível: aqui o Claude propõe e a pessoa aprova. Automatize de ponta a ponta quando a tarefa é repetível, reversível e de baixo risco, o tipo de trabalho que, se sair errado, você desfaz sem estrago. Na dúvida, comece com a pessoa aprovando cada rodada e só remova esse aval depois de ver o agente acertar muitas vezes seguidas.
Suba um degrau de cada vez. O dashboard vivo com Artifacts entrega valor sem exigir uma linha de código do seu lado e ensina você a confiar na saída automática. Só depois que o painel virou rotina confiável vale acionar o TI para um agente que roda sozinho -- retomando as seis perguntas do capítulo de governança, que nesta altura do curso você já respondeu.
Escolha uma entrega que hoje você refaz na mão toda semana. Decida primeiro a natureza dela: pede um número vivo (candidata a dashboard com Artifacts) ou um processo autônomo (candidata a Agent SDK ou Managed Agents, com o TI ao lado)? Depois passe-a pela régua: repetível, reversível e de baixo risco vai para automação total; julgamento, risco ou dado sensível fica com humano no laço. Escreva em uma linha qual degrau ela merece e por quê.