Mode interactif de Pi Agent

Ce chapitre présente de manière complète les opérations essentielles du mode interactif de Pi Agent, notamment les commandes Slash, la gestion des modèles et les opérations au clavier.


Référence des commandes Slash

La saisie dans la zone d'édition/déclenche la complétion automatique des commandes.

Voici les commandes intégrées courantes en mode interactif de Pi Agent :

CommandeFonctionDescription
/loginFournisseur de connexionSélectionner un abonnement OAuth ou un fournisseur de clé API pour l'authentification
/logoutDéconnexionEffacer les identifiants d'authentification stockés
/modelChanger de modèleOuvrir le sélecteur de modèle et rechercher par nom ; appuyer sur Ctrl+S dans le sélecteur pour l'enregistrer comme valeur par défaut au démarrage
/thinkingChanger le niveau de raisonnementOuvrir le sélecteur de niveau de raisonnement ; appuyer sur Ctrl+S dans le sélecteur pour l'enregistrer comme valeur par défaut au démarrage
/scoped-modelsGestion de la portée des modèlesDéfinir la liste des modèles disponibles pour la commutation cyclique avec Ctrl+P
/settingsPanneau de paramètresOuvrir l'interface de paramètres intégrée : niveau de raisonnement, thème, livraison des messages, protocole de transport, etc.
/resumeReprendre la sessionSélectionner et restaurer à partir d'une session historique
/newNouvelle sessionDémarrer une toute nouvelle conversation
/nameNommer la sessionDéfinir un nom lisible pour la session actuelle
/sessionInformations sur la sessionAfficher le chemin du fichier de session, l'ID, le nombre de messages, l'utilisation des tokens et le coût
/treeNavigation dans l'arborescence de sessionAccéder à n'importe quel nœud de l'arbre de conversation pour continuer la conversation
/trustFaire confiance au projetEnregistrer les décisions de confiance du projet pour éviter d'avoir à répondre à chaque démarrage
/forkDupliquer la sessionCréer un nouveau fichier de session dérivé d'un message utilisateur précédent
/cloneCloner la sessionCopier la branche active courante vers un nouveau fichier de session
/compactCompacter le contexteCompacter manuellement l'historique de conversation pour libérer de l'espace dans la fenêtre de contexte
/copyCopier la réponseCopier la dernière réponse de l'IA dans le presse-papiers
/exportExporter la sessionExporter en fichier HTML ou JSONL
/importImporter la sessionImporter et restaurer la session à partir d'un fichier JSONL
/sharePartager la sessionTéléverser en tant que Gist GitHub privé, générer un lien HTML partageable
/reloadRechargement à chaudRecharger les extensions, les Skills, les modèles de prompt, les thèmes, les fichiers de contexte et les configurations de raccourcis clavier
/hotkeysAide sur les raccourcis clavierAfficher une liste de tous les raccourcis clavier
/changelogJournal des modificationsAfficher l'historique des mises à jour de version
/quitQuitterQuitter Pi Agent

Outre les commandes intégrées, les extensions peuvent également enregistrer des commandes personnalisées.

Les compétences sont automatiquement enregistrées en tant que commande/skill:name, tandis que les modèles de prompt sont appelés via/template-name.


Gestion des modèles

La gestion des modèles couvre trois aspects : changer de modèle, définir la portée de commutation cyclique et ajuster les niveaux de raisonnement.

Les commandes et raccourcis correspondants sont présentés ci-dessous.

Changer de modèle (/model et Ctrl+L)

Utilisez/modella commande ouCtrl+Lpour ouvrir le sélecteur de modèle et parcourir tous les modèles d'IA disponibles.

Dans le sélecteur de modèle, vous pouvez rechercher par nom ; après avoir sélectionné, appuyez sur Ctrl+S pour l'enregistrer comme valeur par défaut au démarrage.

Voici un processus d'ouverture du sélecteur de modèle et de changement de modèle :

/model
┌ 选择模型(输入关键词过滤,↑/↓ 移动,Enter 确认):
│ > anthropic/claude-sonnet-4-5
│   anthropic/claude-opus-4-1
│   openai/gpt-4o
│   google/gemini-2.5-pro
└
已切换到 anthropic/claude-sonnet-4-5

Les modèles de la liste dépendent des fournisseurs que vous avez configurés ; l'affichage réel peut différer de l'exemple.

Commutation cyclique rapide (Ctrl+P)

Ctrl+Pfaire défiler les modèles vers l'avant,Shift+Ctrl+Prevenir en arrière.

La portée de commutation est/scoped-modelscontrôlée par la commande ou les paramètresenabledModels.

Niveau de raisonnement (Shift+Tab)

Shift+TabParcourir les niveaux de raisonnement.

La couleur de bordure de l’éditeur change selon le niveau, vous donnant une idée intuitive de la profondeur de raisonnement actuelle :

NiveauScénario d'application
offAucun raisonnement (tâches générales)
minimal / faibleRaisonnement léger (codage courant)
moyenRaisonnement modéré
élevé / xhighRaisonnement approfondi (problèmes complexes)
maxRaisonnement maximal (logique extrêmement complexe)

Appuyez sur Ctrl+S dans le sélecteur /thinking pour enregistrer le niveau actuel comme valeur par défaut au démarrage.

Les niveaux de raisonnement non pris en charge par le modèle ne prendront pas effet et n’apparaîtront pas dans la liste de commutation.

Les capacités du modèle déterminent la limite supérieure des niveaux de raisonnement.


Intégration des commandes Shell

Vous pouvez exécuter des commandes shell directement dans la zone de l'éditeur sans quitter Pi Agent :

PréfixeComportementGestion de la sortieCas d'utilisation
!Exécuter la commande et envoyer la sortie à l'IAVisible par l'IAPermettre à l'IA de voir les résultats de test, la sortie de lint, git status
!!Exécuter la commande, ne pas envoyer la sortie à l'IAAffichage local uniquementOuvrir des fichiers, afficher l'environnement, vérifications rapides

Exemple d'utilisation :

!npm test
!git diff --stat
!python -m pytest -v

!!cat ~/.zshrc
!!ls -la

Ci-dessous, exécuter!npm testl'effet réel après exécution : la sortie sera affichée localement et également transmise à l'IA.

!npm test
> pi-demo@1.0.0 test
> vitest run

 PASS  src/utils/format.test.ts (6 tests) 12ms
 PASS  src/utils/parse.test.ts (4 tests) 8ms

 Test Files  2 passed (2)
      Tests  10 passed (10)

!La sortie de commande consomme la fenêtre de contexte de l'IA.

Si la sortie est volumineuse (par ex., des logs complets), envisagez d'utiliser!!ou de rediriger la sortie vers un fichier, puis de laisser l'IA le lire.


Analyse approfondie de la file d'attente de messages

La file d'attente de messages vous permet d'envoyer des instructions pendant que l'IA travaille, ce qui améliore grandement l'efficacité des interactions :

Type de messageRaccourciMoment du déclenchementScénario typique
OrientationEntréeInséré après la fin de l'exécution de tous les appels d'outils du cycle en cours, avant l'appel LLM suivantLorsque l'IA exécute une séquence d'appels read → edit → bash et que vous souhaitez corriger sa direction en cours de route
SuiviAlt+EntréeInséré uniquement après que l'IA a terminé tout le travail (plus aucun appel d'outil à exécuter)Ajouter de nouvelles exigences après que l'IA a terminé la tâche en cours
Interrompre et récupérerÉchapInterrompre l'opération en cours et récupérer les messages en file d'attente pour les renvoyer dans la zone d'éditionArrêtez immédiatement lorsque l’IA s’écarte du sujet, et récupérez les instructions en file d’attente
Récupérer uniquement les messages en file d’attenteAlt+UpN’interrompez pas l’opération en cours, renvoyez uniquement les messages en file d’attente dans la zone de l’éditeurLorsque vous voulez réécrire le contenu en file d’attente mais sans avoir besoin d’interrompre l’IA

Vous pouvez, dans les paramètres,steeringModeetfollowUpModecontrôler la stratégie d’envoi des messages.

Sous Windows et WSL, Alt+Enter est souvent occupé par le terminal (par exemple, Windows Terminal l’associe par défaut au basculement en plein écran). Dans ce cas, Ctrl+Q est en fait la combinaison par défaut pour envoyer des messages de suivi.


Fonctionnalités de l’éditeur

La zone de l’éditeur offre des capacités améliorées telles que les références de fichiers, la complétion de chemin et la saisie multiligne, ce qui réduit le besoin de passer d’un outil à l’autre.

FonctionnalitéMéthode d’utilisation
Recherche de références de fichiersTapez @ pour déclencher la recherche floue des fichiers du projet
Complétion automatique des cheminsAppuyez sur Tab pour auto-compléter les chemins
Saisie multiligneMaj+Entrée pour un saut de ligne (utilisez Ctrl+Entrée dans Windows Terminal)
Coller une imageCtrl+V (Windows utilise Alt+V, WSL utilise aussi Alt+V), ou glissez-déposez une image dans le terminal
Copier la réponse de l'IACtrl+X copie le message actuellement sélectionné dans /tree, et copie la dernière réponse de l'IA dans les autres scénarios
Éditeur externeCtrl+G ouvre un éditeur externe pour modifier le contenu actuel

Dans une saisie multiligne, "Windows Terminal utilise Ctrl+Entrée" est une adaptation automatique sous Windows Terminal, et non la valeur par défaut dans keybindings.json.

Autres extensions