Outils d’agent de la CLI de Cortex Code

Cortex Code a accès à un ensemble complet d’outils pour les opérations sur les fichiers, les commandes shell, l’accès Web, etc. Vous n’avez pas besoin d’installer quoi que ce soit d’autre, ces outils sont intégrés à la CLI Cortex Code et prêts à l’emploi. Cortex Code utilise automatiquement les outils appropriés en fonction de vos requêtes. Il n’est pas nécessaire de les appeler manuellement ; décrivez simplement ce que vous voulez. Par exemple :

Read the first 10 lines of the file src/main.py
Search for TODO comments in all Python files
Execute a bash command to list running processes
Copy

Lorsque vous créez des compétences personnalisées, vous devez spécifier les outils que la compétence peut utiliser. Voir Compétences.

Outils de fichiers

Lire

Lire le contenu des fichiers à partir du système de fichiers local. Prend en charge :

  • Fichiers texte avec des numéros de ligne

  • Image (PNG, JPG, etc.) - affichées visuellement

  • PDFs - extraction page par page

  • Jupyter Notebooks : cellules avec sorties

  • Plages de lignes : @file.py$10-20

Écriture

Créer ou remplacer des fichiers. Prend en charge :

  • Crée automatiquement des répertoires parents

  • Suivi des changements de ligne pour les statistiques de session

  • Remplace les fichiers existants

Modifier

Rechercher et remplacer dans des fichiers. Prend en charge :

  • Remplacement exact de la chaîne

  • Aperçu de la différence avant les modifications

  • Prise en charge de replace_all (remplacer tout) pour le remplacement global

Glob

Rechercher des fichiers par correspondance de modèles. Exemples :

Motif

Description

**/*.py

Tous les fichiers Python

src/**/*.ts

TypeScript fichiers dans le répertoire src/

**/test_*.py

Fichiers de test Python

!node_modules

Exclure les modèles

Grep

Rechercher le contenu des fichiers à l’aide d’une expression régulière. Prend en charge :

  • Recherche récursive

  • Modèles regex

  • Détection de fichiers binaires

  • Modes de sortie : contenu, fichiers, nombre

Outils Shell

Bash

Exécuter des commandes shell. Prend en charge :

  • Sortie en streaming

  • Exécution en arrière-plan (run_in_background)

  • Contrôle du délai d’attente (par défaut 2 minutes, max 10 minutes)

  • Prise en charge de l’environnement d’exécution sandbox

BashOutput

Récupérer la sortie d’un processus shell en arrière-plan.

  • Filtrer la sortie par regex

  • Vérification du statut

  • Utiliser avec run_in_background

KillShell

Arrêter les shells d’arrière-plan en cours d’exécution.

Outils d’agent

RunSubagent

Lancer des sous-agents pour des tâches spécialisées. Types :

  • usage général : Tous les outils, tâches de recherche

  • Explorer : Exploration rapide de la base de code

  • Plan : Architecture et planification

  • Agents personnalisés de .cortex/agents/

Voir Sous-agents pour plus de détails.

AskUserQuestion

Demander des informations à l’utilisateur lors de l’exécution. Prend en charge :

  • Questions à choix multiples

  • Saisie sous forme libre

  • Sélectionner des options multiples

Examiner

Lancer un sous-agent de révision pour l’assurance qualité.

Outils Web

WebSearch

Rechercher sur le Web à l’aide de plusieurs moteurs. Prend en charge :

  • Moteurs de recherche de secours

  • Extraction d’extraits

  • Mise en cache des résultats

  • Expiration de 30 secondes

Note

WebSearch nécessite l’activation de la recherche Web dans les paramètres Cortex Code dans Snowsight. Voir Recherche Web.

WebFetch

Récupérer du contenu depuis des URLs Web. Prend en charge :

  • HTML en conversion de texte

  • Extraction de contenu

  • 10 000 caractères max

  • Expiration de 30 secondes

Outils Snowflake

SnowflakeSqlExecute

Exécuter des requêtes SQL dans Snowflake. Prend en charge :

  • Contrôles d’autorisation

  • Mise en cache des résultats

  • Actualisation du jeton

  • Déchargement de grands résultats

SnowflakeObjectSearch

Recherche sémantique d’objets de base de données.

Recherches

tables, vues, schémas, bases de données, fonctions

Renvoie

noms, colonnes, descriptions

SnowflakeProductDocs

Recherche dans la documentation Snowflake. Catégories prises en charge :

  • Guide de l’utilisateur

  • Référence SQL

  • Guide du développeur

  • Rubriques Cortex Code

ReflectSemanticModel

Valider les modèles sémantiques Cortex Analyst. Zones de préparation de validation :

  • Existence du fichier

  • Syntaxe YAML

  • Validation du schéma

  • Validation côté serveur

SnowflakeMultiCortexAnalyst

Exécuter des requêtes Cortex Analyst. Prend en charge :

  • Langage naturel pour SQL

  • Prise en charge des modèles sémantiques

  • Récupération des requêtes vérifiées

Outils de données

DataDiff

Comparer des données entre des bases de données/tables. Prend en charge :

  • Gestion des connexions Snowflake

  • Dérivation de l’identificateur du compte

  • Expiration de 300 secondes

NotebookExecute

Exécuter des notebooks Jupyter. Prend en charge :

  • Contrôle du délai d’expiration

  • Gestion des noyaux

  • Injection de paramètres

  • Environnements Python personnalisés

NotebookEdit

Modifier les cellules d’un notebook Jupyter. Modèles pris en charge :

  • remplacer : Remplacer le contenu de cellule

  • Insérer : Ajouter nouvelle cellule

  • supprimer : Supprimer la cellule

Outils du mode de plan

EnterPlanMode

Mode de plan de demande pour les tâches complexes. Prend en charge :

  • Workflow d’approbation des utilisateurs

  • Appel automatique pour les tâches à plusieurs étapes

ExitPlanMode

Présenter le plan à l’utilisateur et quitter le mode de plan. Prend en charge :

  • Confirmation du plan

  • Contrôle du streaming

Outils de mémoire

Mémoire

Stocker et récupérer des informations des sessions. Commandes prises en charge :

  • vue : Voir les mémoires stockées

  • créer : Stocker de nouvelles mémoires

  • str_replace (remplacer la chaîne) : Mettre à jour la mémoire

  • Insérer : Ajouter à la mémoire

  • supprimer : Supprimer la mémoire

  • renommer : Renommer un fichier en mémoire

Note

L’outil Mémoire doit être activé en définissant la variable d’environnement CORTEX_ENABLE_MEMORY.

Niveaux d’autorisation

Les outils ont des exigences d’autorisation différentes :

Niveau

Outils

Comportement

Sûr

Lire, Glob, Grep

Approuvé automatiquement

Faible

Écriture (nouveaux fichiers)

Généralement approuvée automatiquement

Medium

Modifier, Bash (sécurisé)

Invites en mode Confirmation

Élevé

Bash (risqué), écriture SQL

Invite toujours

Critique

rm -rf, sudo

Confirmation supplémentaire

Voir Sécurité pour plus de détails.