Passer au contenu principal
Le Claude Agent SDK est Claude Code en tant que bibliothèque. Il vous permet de créer par programmation les mêmes agents qui alimentent Claude Code, puis de les exécuter sous forme de code. Transformez les tâches répétitives en flux de travail automatisés et publiez-les sur Replit. Dans ce tutoriel, vous créez un agent qui organise une boîte de réception Todoist — en récupérant les tâches, en appliquant des étiquettes et en les triant dans des projets — puis vous le publiez pour qu’il s’exécute selon un calendrier.

​
Ce que vous apprendrez

  • Comment fonctionne le Claude Agent SDK et quand l’utiliser
  • Les primitives fondamentales : agents, outils, serveurs MCP, compétences et autorisations
  • Comment créer un agent d’automatisation de tâches sur Replit en utilisant les Intégrations
  • Comment publier votre agent selon un calendrier avec les Déploiements planifiés

​
Prérequis

  • Un compte Replit (plan Core ou Pro recommandé pour les déploiements)
  • Une clé API Anthropic
  • Un compte Todoist (ou un autre service que vous souhaitez automatiser)

​
Comment fonctionne le Claude Agent SDK

Un agent est une boucle : vous envoyez un prompt, l’agent choisit des outils à exécuter, observe les résultats et répète jusqu’à ce que la tâche soit terminée. Vous fournissez le prompt. Le SDK gère la boucle. Mais le SDK va plus loin. Il vous permet de créer des architectures multi-agents où un agent orchestrateur délègue des tâches à des sous-agents spécialisés, chacun avec ses propres outils et fenêtres de contexte.
Les architectures multi-agents permettent à chaque agent de rester concentré. Les sous-agents ne reçoivent que les outils et le contexte dont ils ont besoin, ce qui évite la surcharge de contexte et améliore les performances.

​
Primitives fondamentales

PrimitiveCe qu’elle fait
Boucle de requêteLa base : prompt, choisir des outils, exécuter, observer, répéter
AgentsConfigurations spécialisées avec leurs propres outils et instructions
OutilsActions que les agents peuvent effectuer — exécuter des commandes, appeler des API, éditer des fichiers
Serveurs MCPProcessus externes qui exposent des collections d’outils (riches en contexte, chargés à l’avance)
CompétencesFichiers d’instructions Markdown qui enseignent aux agents comment faire des choses (efficaces en contexte, chargées à la demande)
AutorisationsContrôles granulaires sur ce à quoi chaque agent peut accéder et exécuter

​
Compétences versus serveurs MCP

Ce sont les deux principales façons d’étendre vos agents : Les compétences sont des fichiers Markdown avec des instructions que votre agent suit. Seule une brève description se charge jusqu’à ce qu’elles soient invoquées, gardant la fenêtre de contexte légère. Utilisez les compétences pour :
  • Les flux de travail et conventions (« comment déployer », « liste de vérification pour la révision de code »)
  • Les documents de référence (modèles d’API, guides de style)
  • Les prompts réutilisables déclenchés par leur nom
Les serveurs MCP sont des processus qui exposent des outils. Toutes les descriptions d’outils se chargent à l’avance, ce qui les rend riches en contexte. Utilisez les serveurs MCP pour :
  • La connexion à des services externes (Notion, Linear, bases de données)
  • Les actions nécessitant un accès API (créer des tâches, interroger des données)
  • Les outils qui font des choses, pas seulement qui instruisent
Les compétences définissent comment votre agent doit travailler. Les serveurs MCP définissent à quoi votre agent peut accéder. Les deux fonctionnent pour les agents de codage (comme Replit Agent) et les agents que vous créez avec le SDK.

​
Quand utiliser le SDK plutôt que l’API

Cas d’utilisationChoisir
Automatiser des tâches à plusieurs étapesClaude Agent SDK
Flux de travail multi-agentsClaude Agent SDK
Applications de chat simplesAPI Anthropic
Tâches en une seule étapeAPI Anthropic

​
Créer un agent organisateur Todoist

Cette démonstration utilise un modèle Replit qui structure un projet Claude Agent SDK avec la bonne architecture — les répertoires agents, outils, serveurs MCP, compétences et autorisations sont déjà en place.

​
Étape 1 : Dupliquer le modèle

1

Ouvrir le modèle

Ouvrez le modèle Claude Agent SDK sur Replit et sélectionnez Dupliquer pour créer votre propre copie.
2

Nommer votre projet

Donnez-lui un nom descriptif (par ex., « Mon agent Todoist ») et sélectionnez Utiliser le modèle.
3

Examiner la structure du projet

Une fois l’environnement chargé, ouvrez la barre latérale des fichiers. Activez Afficher les fichiers cachés si nécessaire pour voir la structure complète :
  • .agents/skills/ — Compétences qui enseignent à Replit Agent comment créer des applications Claude Agent SDK
  • src/agents/ — Définitions des agents
  • src/mcpServers/ — Configurations des serveurs MCP
  • src/permissions/ — Définitions des autorisations
  • src/skills/ — Compétences pour vos agents (fichiers Markdown)
  • src/tools/ — Définitions d’outils personnalisés
Le modèle inclut une compétence qui enseigne à Replit Agent comment créer des applications Claude Agent SDK. Cela signifie qu’Agent comprend déjà le framework lorsque vous lui soumettez un prompt.

​
Étape 2 : Connecter Todoist via les Intégrations Replit

Avant de soumettre un prompt à Agent, connectez le service avec lequel votre agent doit interagir.
  1. Accédez à replit.com/integrations dans votre compte Replit.
  2. Trouvez Todoist et connectez votre compte.
  3. Autorisez Replit à accéder à vos données Todoist.
Les Intégrations Replit gèrent OAuth et l’authentification pour vous. Votre agent peut accéder à l’API Todoist sans gérer les tokens directement. C’est plus simple que de configurer un serveur MCP séparé qui nécessite son propre flux OAuth.

​
Étape 3 : Soumettre un prompt à Agent pour créer votre agent

Basculez Replit Agent en Mode Plan pour de meilleurs résultats — il examine le plan avant de construire, vous donnant la possibilité de vérifier l’approche.
Les deux derniers paragraphes de ce prompt ont été ajoutés après le débogage. Être précis sur comment s’authentifier (Intégrations Replit, pas MCP OAuth) et quel devrait être l’état final (boîte de réception complètement vidée) économise du temps d’itération.

​
Étape 4 : Examiner le plan et construire

Lorsqu’Agent présente son plan, vérifiez qu’il inclut :
  1. Des outils personnalisés pour l’API Todoist (pas le serveur MCP Todoist)
  2. Un agent organisateur qui récupère les tâches, les étiquettes et les projets
  3. Des autorisations appropriées limitées aux outils dont votre agent a besoin
  4. Un point d’entrée qui déclenche le flux de travail
Une fois satisfait, approuvez le plan, réglez Agent sur haute autonomie et laissez-le construire.

​
Étape 5 : Ajouter votre clé API Anthropic

Le Claude Agent SDK nécessite une clé API Anthropic pour appeler Claude.
  1. Ouvrez le panneau Secrets dans votre Workspace Replit.
  2. Ajoutez un secret nommé ANTHROPIC_API_KEY avec la valeur de votre clé API.
Si vous avez sauvegardé votre clé API Anthropic dans votre coffre Replit dans les Paramètres, elle est automatiquement disponible dans tous vos projets.

​
Étape 6 : Tester et déboguer

Exécutez l’agent et vérifiez qu’il traite correctement votre boîte de réception Todoist. Problèmes courants à surveiller :
  • « La boîte de réception est vide » alors qu’elle ne l’est pas — Le format de réponse de l’API pour détecter les tâches de la boîte de réception peut nécessiter un ajustement. Vérifiez que l’agent filtre les tâches par le projet de la boîte de réception, pas par une autre propriété.
  • Les tâches reçoivent des étiquettes mais ne sont pas déplacées vers des projets — Soyez explicite dans votre prompt que l’agent doit récupérer les projets disponibles et en assigner un à chaque tâche.
  • Erreurs d’authentification — Vérifiez que l’intégration Todoist est connectée dans les Intégrations Replit et que le code de votre agent l’utilise (pas un flux OAuth séparé).
Le débogage fait partie de la création avec l’IA. Lorsque quelque chose ne fonctionne pas, examinez la sortie, identifiez ce que l’agent a fait différemment de ce qui était attendu, et fournissez un prompt plus spécifique. Chaque correction vous apprend ce qu’il faut inclure dès le départ la prochaine fois.

​
Publier votre agent

Une fois que votre agent fonctionne correctement, publiez-le pour qu’il s’exécute automatiquement.
1

Ouvrir l'onglet Publier

Dans votre Workspace Replit, sélectionnez l’onglet Publier.
2

Choisir un déploiement planifié

Sélectionnez Déploiement planifié pour une automatisation basée sur le temps. Saisissez le calendrier souhaité (par ex., « Tous les jours à 17h PST »).
3

Vérifier la configuration

Confirmez que la commande d’exécution pointe vers votre fichier de point d’entrée principal et que votre secret ANTHROPIC_API_KEY est inclus dans les secrets de déploiement.
4

Publier

Sélectionnez Publier. Votre agent est maintenant en ligne et s’exécute selon le calendrier.
Pour les agents qui doivent répondre à des événements (webhooks, messages entrants), utilisez plutôt un Déploiement VM réservée.

​
Étendre votre agent

Une fois les bases fonctionnelles, vous pouvez créer des agents plus sophistiqués sur Replit :
  • Ajouter une mémoire persistante — Utilisez la Base de données Replit pour stocker l’état entre les exécutions
  • Stocker des fichiers — Utilisez le Stockage d’application pour les données basées sur des fichiers
  • Connecter d’autres services — Ajoutez d’autres Intégrations (Slack, Linear, GitHub, Notion) pour des flux de travail multi-services
  • Utiliser des compétences — Ajoutez des fichiers de compétences Markdown pour donner à vos agents des connaissances et des instructions spécialisées

​
Prochaines étapes