Passer au contenu principal

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.

Le Claude Agent SDK est Claude Code sous forme de 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 construisez un agent qui organise une boîte de réception Todoist — récupérant des tâches, appliquant des étiquettes et 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
  • Primitives fondamentales : agents, outils, serveurs MCP, compétences et permissions
  • Comment construire un agent d’automatisation de tâches sur Replit en utilisant Integrations
  • Comment publier votre agent selon un calendrier avec les Déploiements planifiés

​
Prérequis

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

​
Fonctionnement du Claude Agent SDK

Un agent est une boucle : vous envoyez une invite, l’agent sélectionne des outils à exécuter, observe les résultats et recommence jusqu’à ce que la tâche soit terminée. Vous fournissez l’invite. Le SDK gère la boucle. Mais le SDK va plus loin. Il vous permet de construire 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 gardent chaque agent concentré. Les sous-agents reçoivent uniquement les outils et le contexte dont ils ont besoin, ce qui évite la surcharge de contexte et améliore les performances.

​
Primitives fondamentales

PrimitiveRôle
Boucle de requêteLa fondation : invite, sélectionner des outils, exécuter, observer, recommencer
AgentsConfigurations spécialisées avec leurs propres outils et instructions
OutilsActions que les agents peuvent effectuer — exécuter des commandes, appeler des API, modifier des fichiers
Serveurs MCPProcessus externes qui exposent des collections d’outils (gourmands en contexte, chargés à l’avance)
CompétencesFichiers d’instructions Markdown qui apprennent aux agents comment faire les choses (efficaces en contexte, chargées à la demande)
PermissionsContrôles granulaires sur ce à quoi chaque agent peut accéder et exécuter

​
Compétences vs. serveurs MCP

Voici 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’à invocation, 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 matériaux de référence (modèles d’API, guides de style)
  • Les invites réutilisables déclenchées par nom
Les serveurs MCP sont des processus qui exposent des outils. Toutes les descriptions d’outils se chargent à l’avance, les rendant gourmands en contexte. Utilisez les serveurs MCP pour :
  • Se connecter à 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, et pas seulement qui instruisent
Les compétences définissent comment votre agent doit fonctionner. Les serveurs MCP définissent ce à quoi votre agent peut accéder. Les deux fonctionnent pour les agents de codage (comme Replit Agent) et les agents que vous construisez avec le SDK.

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

Cas d’utilisationChoisir
Automatiser des tâches multi-étapesClaude Agent SDK
Flux de travail multi-agentsClaude Agent SDK
Applications de chat simplesAPI Anthropic
Tâches à tour uniqueAPI Anthropic

​
Construire un agent organisateur Todoist

Ce tutoriel utilise un modèle Replit qui génère un projet Claude Agent SDK avec la bonne structure — les répertoires d’agents, d’outils, de serveurs MCP, de compétences et de permissions sont déjà en place.

​
Étape 1 : Remixer le modèle

1

Ouvrir le modèle

Ouvrez le modèle Claude Agent SDK sur Replit et sélectionnez Remixer 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 apprennent à Replit Agent comment construire des applications Claude Agent SDK
  • src/agents/ — Définitions des agents
  • src/mcpServers/ — Configurations des serveurs MCP
  • src/permissions/ — Définitions des permissions
  • 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 apprend à Replit Agent comment construire des applications Claude Agent SDK. Cela signifie qu’Agent comprend déjà le framework lorsque vous l’invitez.

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

Avant d’inviter Agent, connectez le service avec lequel votre agent doit interagir.
  1. Allez sur 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 directement les jetons. C’est plus simple que de configurer un serveur MCP séparé qui nécessite son propre flux OAuth.

​
Étape 3 : Inviter Agent à construire votre agent

Passez Replit Agent en Mode Plan pour de meilleurs résultats — il examine le plan avant de construire, vous donnant l’occasion de vérifier l’approche.
Les deux derniers paragraphes de cette invite ont été ajoutés après débogage. Être précis sur comment s’authentifier (Intégrations Replit, pas OAuth MCP) 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 permissions 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 volet Secrets dans l’éditeur de projet.
  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 des ajustements. Vérifiez que l’agent filtre les tâches par projet de boîte de réception, et non par une propriété différente.
  • Les tâches reçoivent des étiquettes mais ne se déplacent pas vers les projets — Soyez explicite dans votre invite que l’agent doit récupérer les projets disponibles et assigner chaque tâche à l’un d’eux.
  • 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 (et non un flux OAuth séparé).
Le débogage fait partie de la construction avec l’IA. Quand quelque chose ne fonctionne pas, examinez la sortie, identifiez ce que l’agent a fait différemment de ce qui était attendu, et fournissez une invite 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 l’éditeur de projet, sélectionnez l’onglet Publier.
2

Choisir le Déploiement planifié

Sélectionnez Déploiement planifié pour l’automatisation basée sur le temps. Entrez votre 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é.

​
Étendre votre agent

Une fois les bases fonctionnelles, vous pouvez construire des agents plus sophistiqués sur Replit :
  • Ajouter une mémoire persistante — Utilisez Replit Database pour stocker l’état entre les exécutions
  • Stocker des fichiers — Utilisez App Storage pour les données basées sur des fichiers
  • Connecter plus de services — Ajoutez plus d’Intégrations (Slack, Linear, GitHub, Notion) pour les 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