Choisir un type d’intégration
| Type | Utilité |
|---|---|
| Exécutable (fire-and-forget) | Lance une autre application sans attendre la fin de son exécution ni récupérer sa sortie |
| Filtre stdio (stdin → stdout) | Transmet du texte à un programme et récupère le résultat converti |
| API REST (HTTP POST) | Envoie du JSON et récupère le corps de la réponse |
| Client MCP | Appelle un outil sur un serveur MCP et récupère le texte de la réponse |
Enregistrer un outil et l’exécuter
- Choisissez Paramètres → Outils externes → + Ajouter un outil.
- Saisissez un nom, choisissez le type d’outil et renseignez les champs propres à ce type, comme le chemin de l’exécutable ou l’URL du point de terminaison.
- Si l’outil accepte du texte, choisissez l’entrée à envoyer. S’il renvoie un résultat, choisissez le traitement à appliquer à la sortie.
- Réglez Nécessite un fichier ouvert et Nécessite du texte sélectionné selon vos besoins.
- Enregistrez les paramètres et exécutez
/<nom de l'outil>dans le terminal.
Vous pouvez aussi exécuter les outils depuis l’icône en forme de prise de la barre de mise en forme. Chaque outil enregistré apparaît dans les onglets de paramètres Raccourcis et Gestes, où vous pouvez lui attribuer un raccourci ou un geste.
Transmettre le document actuel à un outil
Utilisez les variables ci-dessous dans les arguments et ailleurs.
| Variable | Contenu |
|---|---|
{file} / {dir} | Le chemin du fichier et le dossier qui le contient |
{selection} | Le texte sélectionné |
{workspace} | La racine de l’espace de travail |
{input} | Ce que vous avez saisi après le nom de l’outil dans le terminal |
{full_document} | Le document entier. Disponible dans le corps d’une requête REST et dans le JSON des arguments MCP |
{token} | Le jeton enregistré. Disponible dans les en-têtes et le corps REST, ainsi que dans le JSON des arguments MCP |
Dans du JSON, utilisez les variables se terminant par _json. Elles échappent les guillemets et les sauts de ligne et incluent les guillemets qui les entourent : le résultat est donc une chaîne JSON valide. N’ajoutez pas d’autres guillemets autour de la variable.
{"text": {selection_json}, "instruction": {input_json}}Points à vérifier selon le type
- Filtre stdio : choisissez ce qui est transmis, par exemple la sélection, le document entier ou l’argument du terminal. Vérifiez le chemin de l’exécutable et son dossier de travail.
- API REST : un point de terminaison externe doit utiliser HTTPS. Le corps de la réponse est repris tel quel ; il n’est donc pas possible d’extraire un seul champ d’un JSON. Les jetons s’enregistrent avec Définir le jeton….
- MCP : en entrée/sortie standard, indiquez la commande, ses arguments et ses variables d’environnement ; en HTTP, indiquez le point de terminaison. Définissez ensuite le nom de l’outil et le JSON des arguments. Pour utiliser
npxouuvx, installez séparément l’environnement d’exécution dont ils ont besoin.
Choisir la destination du résultat
Le résultat peut remplacer la sélection, être inséré à la position du curseur, remplacer le document entier, être copié dans le presse-papiers, devenir un nouveau fichier ou être affiché dans le terminal. Le remplacement du document entier n’est pas enregistré automatiquement ; vérifiez le résultat avant d’enregistrer.
Changer d’onglet après le lancement d’une exécution ne déplace pas sa sortie : elle est appliquée à l’onglet depuis lequel l’exécution a démarré. Si cet onglet a été fermé, la sortie s’ouvre dans un nouvel onglet. Une exécution en cours peut être annulée depuis la fenêtre de progression ou depuis le terminal.
Transférer vos définitions sur une autre machine
Utilisez Exporter en JSON… / Importer depuis JSON… dans l’onglet Outils externes. Vérifiez les chemins des exécutables et les URL avant d’importer. Les valeurs des jetons ne sont pas exportées : enregistrez-les de nouveau sur l’autre machine.
Les outils externes ne peuvent pas être exécutés lorsque la licence ne permet pas l’édition. Vérifiez l’état dans Licence et activation.