Gestion des outils

Présentation

Les outils sont les « mains et pieds » qui permettent à l'Agent d'exécuter des opérations. Le système fournit 19 outils intégrés et prend en charge l'extension de l'ensemble d'outils via le protocole MCP, les définitions OpenAPI et les compétences. La page de gestion des outils sert à configurer et à gérer tous les outils disponibles.

19 outils intégrés

Opérations sur les fichiers (7 outils)

Exécution de commandes (1 outil)

Réseau (1 outil)

Gestion des tâches (1 outil)

Appel de compétences (1 outil)

Interaction utilisateur (1 outil)

Sous-agents (3 outils)

Mémoire (4 outils)

Explication des niveaux de sécurité

L'administrateur peut ajuster le niveau d'autorisation des outils non verrouillés (plancher de l'organisation) dans les Garde-fous de sécurité, et chaque utilisateur peut le renforcer davantage dans la sécurité d'exécution de l'APP.

Protocole d'outils MCP

Le MCP (Model Context Protocol) est un protocole standardisé de communication d'outils pour l'IA, permettant d'étendre l'ensemble d'outils via des services externes.

Trois modes de transport

Cinq modes d'authentification

Interface de gestion MCP

Gérez les serveurs MCP via le composant McpManager :

• Ajouter un serveur : configurez le nom, le mode de transport, les paramètres de connexion et le mode d'authentification
• Modifier / Supprimer : modifiez ou retirez une configuration existante
• Activer / Désactiver : basculez l'état de disponibilité du serveur
• Découverte des outils : après connexion, découvre automatiquement la liste des outils fournis par le serveur

Isolation de sécurité

Le sous-processus MCP ne transmet que les variables d'environnement en liste blanche, afin d'éviter la fuite d'informations sensibles telles que les API Key.

Outils API

Prend en charge l'analyse automatique et la création d'outils à partir de documents OpenAPI/Swagger :

Répertoire d'outils personnalisés NEW

Le système ajoute le ToolDirectoryManager — il gère les outils personnalisés situés dans le répertoire {dataDir}/TOOLs/{orgId}/_custom/, chargeables sans redémarrer l'APP.

Structure du répertoire

                      
                      {dataDir}/TOOLs/{orgId}/_custom/
├── my-tool-1/
│   ├── metadata.json
│   └── ...
└── my-tool-2/
    ├── metadata.json
    └── ...

                    

Exemple de metadata.json

                      
                      {
  "id": "my-tool-1",
  "name": "My Custom Tool",
  "description": "自定义工具说明",
  "type": "API",
  "enabled": true,
  "createdAt": 1776921208476,
  "updatedAt": 1776921208476
}

                    

Mécanisme de chargement

• Méthode de scan : scanAndLoad(orgId)
• Types pris en charge : API / MCP
• Isolation par organisation : répertoires séparés par orgId, sans interférence mutuelle
• Chargement à chaud : sans redémarrage de l'APP

Pipeline de chargement des outils

Tous les outils sont chargés et fusionnés dans l'ordre suivant :

                      
                      ① Outils intégrés (19 outils)
    ↓
② Outils MCP (découverts depuis les serveurs MCP configurés)
    ↓
③ Outils API (analysés depuis les définitions OpenAPI)
    ↓
④ Outils personnalisés (le ToolDirectoryManager scanne le répertoire _custom/)
    ↓
⑤ Outils de compétence (execute_skill_{id} injecté depuis les Skills activées)
    ↓
⑥ Fusion et déduplication → liste finale des outils → envoi au LLM

                    

Cas d'usage des outils courants

Guide pratique : ajouter un outil MCP

1. Ouvrez l'APP → Paramètres → Outils → zone Outils MCP
2. Cliquez sur Ajouter un serveur MCP
3. Renseignez la configuration :
   • Nom : donnez un nom d'identification à ce serveur MCP
   • Mode de transport : choisissez stdio / SSE / HTTP
   • Pour stdio : renseignez la commande (par ex. npx) et les arguments (par ex. @anthropic/mcp-server-filesystem)
   • Pour SSE/HTTP : renseignez l'URL du serveur
4. Si une authentification est nécessaire, choisissez le mode d'authentification et renseignez les identifiants
5. Cliquez sur Enregistrer
6. Le système se connecte automatiquement au serveur et découvre les outils disponibles
7. Les outils découverts apparaissent dans la liste des outils, activés par défaut

Conseil : le sous-processus MCP ne transmet que les variables d'environnement en liste blanche. Si un outil MCP nécessite des variables d'environnement telles qu'une API Key, vous devez les déclarer explicitement dans le champ env de la configuration.

Conséquences de la désactivation d'un outil

Une fois un outil désactivé, l'Agent ignore totalement son existence dans la conversation. Cela signifie que :

Recommandation : sauf raison de sécurité explicite, il est déconseillé de désactiver les outils fondamentaux d'opération sur les fichiers (Read / Write / Edit / Glob / Search), faute de quoi la capacité de l'Agent à exécuter des tâches serait fortement limitée.

Questions fréquentes

L'Agent dit « je ne peux pas effectuer d'opérations sur les fichiers »

Vérifiez si les outils d'opération sur les fichiers (Read File, Write File, Edit, etc.) ont été désactivés. Sur la page de gestion des outils, confirmez que ces outils sont bien activés.

Échec de connexion d'un outil MCP

1. Vérifiez que la commande/l'URL du serveur MCP est correcte
2. En mode stdio, vérifiez que la commande correspondante est installée (par ex. npx nécessite un environnement Node.js)
3. Vérifiez si des variables d'environnement sont requises (API Key, etc.)
4. Consultez les journaux de l'APP pour obtenir des informations d'erreur détaillées

L'Agent n'utilise pas l'outil que j'attendais

L'Agent choisit ses outils de manière autonome en fonction des besoins de la tâche. Si l'Agent choisit un « mauvais » outil, vous pouvez le lui indiquer clairement dans la conversation : « Utilise l'outil Bash pour exécuter cette commande. »

Documents connexes

• Gestion des compétences — le système de compétences
• Sécurité d'exécution — configuration des autorisations des outils
• Garde-fous de sécurité — gestion des autorisations d'outils au niveau entreprise