O Claude Agent SDK é o Claude Code como uma biblioteca. Ele permite que você crie programaticamente os mesmos agentes que potencializam o Claude Code e os execute como código. Transforme tarefas repetitivas em fluxos de trabalho automatizados e publique-os no Replit. Neste tutorial, você cria um agente que organiza uma caixa de entrada do Todoist — buscando tarefas, aplicando etiquetas e classificando-as em projetos — e então o publica para ser executado em um cronograma.Documentation Index
Fetch the complete documentation index at: https://docs.replit.com/llms.txt
Use this file to discover all available pages before exploring further.
O que você aprenderá
- Como o Claude Agent SDK funciona e quando usá-lo
- Primitivas principais: agentes, ferramentas, servidores MCP, skills e permissões
- Como criar um agente de automação de tarefas no Replit usando Integrações
- Como publicar seu agente em um cronograma com Implantações Programadas
Pré-requisitos
- Uma conta no Replit (plano Core ou Pro recomendado para Implantações)
- Uma chave de API da Anthropic
- Uma conta no Todoist (ou outro serviço que você deseja automatizar)
Como o Claude Agent SDK funciona
Um agente é um loop: você envia um prompt, o agente escolhe ferramentas para executar, observa os resultados e repete até que a tarefa seja concluída. Você fornece o prompt. O SDK cuida do loop. Mas o SDK vai além. Ele permite que você crie arquiteturas multi-agente onde um agente orquestrador delega tarefas a sub-agentes especializados, cada um com suas próprias ferramentas e janelas de contexto.Primitivas principais
| Primitiva | O que faz |
|---|---|
| Loop de consulta | A base: prompt, escolher ferramentas, executar, observar, repetir |
| Agentes | Configurações especializadas com suas próprias ferramentas e instruções |
| Ferramentas | Ações que os agentes podem realizar — executar comandos, chamar APIs, editar arquivos |
| Servidores MCP | Processos externos que expõem coleções de ferramentas (pesados em contexto, carregados antecipadamente) |
| Skills | Arquivos de instrução em Markdown que ensinam os agentes a fazer coisas (eficientes em contexto, carregados sob demanda) |
| Permissões | Controles granulares sobre o que cada agente pode acessar e executar |
Skills vs. servidores MCP
Estas são as duas principais maneiras de estender seus agentes: Skills são arquivos markdown com instruções que seu agente segue. Apenas uma breve descrição é carregada até ser invocada, mantendo a janela de contexto enxuta. Use skills para:- Fluxos de trabalho e convenções (“como fazer implantação”, “checklist de revisão de código”)
- Materiais de referência (padrões de API, guias de estilo)
- Prompts reutilizáveis acionados por nome
- Conectar-se a serviços externos (Notion, Linear, bancos de dados)
- Ações que precisam de acesso à API (criar tarefas, consultar dados)
- Ferramentas que fazem coisas, não apenas instruem
As skills definem como seu agente deve trabalhar. Os servidores MCP definem o que seu agente pode acessar. Ambos funcionam para agentes de codificação (como o Replit Agent) e agentes que você cria com o SDK.
Quando usar o SDK vs. a API
| Caso de uso | Escolha |
|---|---|
| Automatizar tarefas de várias etapas | Claude Agent SDK |
| Fluxos de trabalho multi-agente | Claude Agent SDK |
| Aplicativos de chat simples | API da Anthropic |
| Tarefas de turno único | API da Anthropic |
Crie um agente organizador do Todoist
Este guia usa um template do Replit que estrutura um projeto do Claude Agent SDK com a estrutura certa — diretórios de agentes, ferramentas, servidores MCP, skills e permissões já prontos.Etapa 1: Faça remix do template
Abra o template
Abra o template do Claude Agent SDK no Replit e selecione Remix para criar sua própria cópia.
Nomeie seu projeto
Dê a ele um nome descritivo (ex.: “Meu Agente Todoist”) e selecione Usar Template.
Revise a estrutura do projeto
Quando o ambiente carregar, abra a barra lateral de arquivos. Ative Mostrar Arquivos Ocultos se necessário para ver a estrutura completa:
.agents/skills/— Skills que ensinam o Replit Agent a criar aplicativos com o Claude Agent SDKsrc/agents/— Definições de agentessrc/mcpServers/— Configurações de servidores MCPsrc/permissions/— Definições de permissõessrc/skills/— Skills para seus agentes (arquivos markdown)src/tools/— Definições de ferramentas personalizadas
Etapa 2: Conecte o Todoist via Integrações do Replit
Antes de criar prompts para o Agent, conecte o serviço com o qual seu agente precisa interagir.- Vá para replit.com/integrations na sua conta do Replit.
- Encontre o Todoist e conecte sua conta.
- Autorize o Replit a acessar seus dados do Todoist.
As Integrações do Replit gerenciam OAuth e autenticação para você. Seu agente pode acessar a API do Todoist sem gerenciar tokens diretamente. Isso é mais simples do que configurar um servidor MCP separado que requer seu próprio fluxo OAuth.
Etapa 3: Crie prompts para o Agent construir seu agente
Mude o Replit Agent para o Modo Plan para melhores resultados — ele revisa o plano antes de construir, dando a você a chance de verificar a abordagem.Os dois últimos parágrafos deste prompt foram adicionados após a depuração. Ser específico sobre como autenticar (Integrações do Replit, não OAuth MCP) e qual deve ser o estado final (caixa de entrada completamente limpa) economiza tempo de iteração.
Etapa 4: Revise o plano e construa
Quando o Agent apresentar seu plano, verifique se ele inclui:- Ferramentas personalizadas para a API do Todoist (não o servidor MCP do Todoist)
- Um agente organizador que busca tarefas, etiquetas e projetos
- Permissões adequadas com escopo para as ferramentas que seu agente precisa
- Um ponto de entrada que aciona o fluxo de trabalho
Etapa 5: Adicione sua chave de API da Anthropic
O Claude Agent SDK requer uma chave de API da Anthropic para chamar o Claude.- Abra o painel Secrets no Editor de projeto.
- Adicione um secret chamado
ANTHROPIC_API_KEYcom o valor da sua chave de API.
Se você salvou sua chave de API da Anthropic no seu cofre do Replit em Configurações, ela fica disponível automaticamente em todos os seus projetos.
Etapa 6: Teste e depure
Execute o agente e verifique se ele processa sua caixa de entrada do Todoist corretamente. Problemas comuns a observar:- “Caixa de entrada vazia” quando não está — O formato de resposta da API para detectar tarefas na caixa de entrada pode precisar de ajuste. Verifique se o agente filtra tarefas pelo projeto da caixa de entrada, não por outra propriedade.
- Tarefas recebem etiquetas, mas não são movidas para projetos — Seja explícito no seu prompt de que o agente deve buscar projetos disponíveis e atribuir cada tarefa a um.
- Erros de autenticação — Verifique se a integração do Todoist está conectada nas Integrações do Replit e se o código do seu agente a usa (não um fluxo OAuth separado).
Publique seu agente
Quando seu agente funcionar corretamente, publique-o para execução automática.Escolha Implantação Programada
Selecione Implantação Programada para automação baseada em tempo. Insira o cronograma desejado (ex.: “Todo dia às 17h PST”).
Verifique a configuração
Confirme se o comando de execução aponta para o arquivo de ponto de entrada principal e se seu secret
ANTHROPIC_API_KEY está incluído nos secrets de implantação.Estenda seu agente
Quando o básico funcionar, você pode criar agentes mais sofisticados no Replit:- Adicione memória persistente — Use o Banco de Dados do Replit para armazenar estado entre execuções
- Armazene arquivos — Use o Armazenamento de Aplicativos para dados baseados em arquivos
- Conecte mais serviços — Adicione mais Integrações (Slack, Linear, GitHub, Notion) para fluxos de trabalho com múltiplos serviços
- Use skills — Adicione arquivos de skill em markdown para dar aos seus agentes conhecimento especializado e instruções
Próximos passos
- Explore a documentação do Claude Agent SDK para a referência completa da API
- Aprenda sobre Agentes e Automações para criar chatbots e fluxos de trabalho orientados a eventos no Replit
- Leia sobre Implantações Programadas e Implantações de VM Reservada para opções de implantação
- Confira o template do Claude Agent SDK para começar a criar