Agent Builder

Conseils pour configurer la build d'un agent n8n cible. Chaque section ci-dessous dispose d'un fichier de référence dédié avec la procédure opérationnelle complète. Associez la demande de l'utilisateur à la section, puis chargez cette référence avec load_skill({ skillId: "agent-builder", filePath: "references/<file>.md" }) avant d'agir — ne pas agir sur une section de mémoire.

Outils

Toutes les actions du builder s'exécutent via un unique outil agent_builder. Invoquez une action comme agent_builder({ action: "<name>", ...args }). Actions disponibles : create_agent, read_config, write_config, patch_config, search_nodes, get_node_types, get_resource_locator_options, create_skill, create_task, build_custom_tool, list_integration_types, list_sub_agents, list_workflows, search_mcp_servers, verify_mcp_server, resolve_llm.

Les credentials sont listées via l'outil natif credentials (pas une action agent_builder) — appelez credentials({ action: "list", type?, name? }).

Quand une référence ci-dessous nomme une action (ex. « appelez write_config »), invoquez-la comme agent_builder({ action: "write_config", ... }).

Demander à l'utilisateur, credentials, et le LLM

Il n'y a pas de carte picker spécifique au builder. Quand vous avez besoin d'une entrée de l'utilisateur :

• Une question ou un choix — utilisez l'outil natif ask-user.
• Une credential pour un outil node, serveur MCP, ou intégration — appelez l'outil natif credentials : credentials({ action: "list", type: "<credentialType>" }) (passez name pour une recherche ciblée par nom de credential). Si exactement une correspond, utilisez son id. Si plusieurs correspondent, demandez à l'utilisateur de choisir avec ask-user (présentez les noms) et utilisez l'id de la credential choisie. Construisez la map des credentials comme { "<credentialType>": { "id": "<id>", "name": "<name>" } }. Si aucune n'existe, dites à l'utilisateur de la créer d'abord dans n8n — ne jamais inventer un id.
• Le LLM principal de l'agent — appelez agent_builder({ action: "resolve_llm", provider?, model? }). S'il retourne ok: true, utilisez le provider/model/credentialId retourné. S'il retourne ok: false (manquant/ambigu/non supporté), demandez à l'utilisateur avec ask-user en utilisant les options retournées, puis écrivez le choix via write_config.

D'abord : s'assurer qu'un agent est en cours de build

Chaque action ci-dessous opère sur un unique agent cible. Si aucun agent n'est ciblé encore (une demande nouvelle de build d'agent, ou read_config / write_config / patch_config rapporte qu'aucun agent n'est en cours de build), appelez agent_builder({ action: "create_agent", name: "<short name>" }) une fois pour le créer. Cela lie le reste de la conversation au nouvel agent ; puis appelez agent_builder({ action: "read_config" }) et procédez. Ne créez pas l'agent à nouveau si un agent est déjà en cours de build ou d'édition.

Routage

• Intégrations — Utilisez pour décider si Slack, Linear, Telegram, ou une autre plateforme externe doit être une intégration/trigger de chat d'agent cible versus un outil node, et quand ajouter ou changer des intégrations de chat ; pas pour le comportement natif du Build chat ou Preview chat. Chargez references/integrations.md.

• Serveurs MCP — Utilisez quand ajouter, supprimer, ou mettre à jour des serveurs MCP (Model Context Protocol) sur l'agent cible. Chargez references/mcp.md.

• Resource locators — Utilisez quand ajouter ou changer des outils node avec des champs de sélecteur dynamique stable : resourceLocator, loadOptionsMethod, routage loadOptions, paramètres « Name or ID », teamId, channelId, projectId, calendarId, databaseId, tableId, sélecteurs de modèle, ou quand write_config/patch_config rejette $fromAI sur un sélecteur dynamique. Chargez references/resource-locators.md.

• Sub-agents — Utilisez quand configurer la délégation de sub-agent inline ou sauvegardée pour l'agent cible, sélectionner des sub-agents publiés du même projet, ou changer subAgents.maxChildren. Chargez references/sub-agents.md.

• Target skills — Utilisez quand créer des skills d'agent cible réutilisables, playbooks, politiques, guides de style, ou instructions de domaine avec create_skill qui devraient charger seulement pour les demandes futures pertinentes ; pas pour la guidance du builder ou les instructions ponctuelles. Chargez references/target-skills.md.

• Target tasks — Utilisez quand l'utilisateur souhaite que l'agent cible exécute quelque chose sur un calendrier récurrent (une « task ») : un objectif quotidien/hebdomadaire/horaire que l'agent effectue seul avec create_task. Pas pour les demandes ponctuelles, les déclencheurs de chat/événement, ou les éditions de config/outil/skill/modèle. Chargez references/target-tasks.md.