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 :
| Commande | Fonction | Description |
|---|---|---|
| /login | Fournisseur de connexion | Sélectionner un abonnement OAuth ou un fournisseur de clé API pour l'authentification |
| /logout | Déconnexion | Effacer les identifiants d'authentification stockés |
| /model | Changer de modèle | Ouvrir 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 |
| /thinking | Changer le niveau de raisonnement | Ouvrir 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-models | Gestion de la portée des modèles | Définir la liste des modèles disponibles pour la commutation cyclique avec Ctrl+P |
| /settings | Panneau de paramètres | Ouvrir l'interface de paramètres intégrée : niveau de raisonnement, thème, livraison des messages, protocole de transport, etc. |
| /resume | Reprendre la session | Sélectionner et restaurer à partir d'une session historique |
| /new | Nouvelle session | Démarrer une toute nouvelle conversation |
| /name | Nommer la session | Définir un nom lisible pour la session actuelle |
| /session | Informations sur la session | Afficher le chemin du fichier de session, l'ID, le nombre de messages, l'utilisation des tokens et le coût |
| /tree | Navigation dans l'arborescence de session | Accéder à n'importe quel nœud de l'arbre de conversation pour continuer la conversation |
| /trust | Faire confiance au projet | Enregistrer les décisions de confiance du projet pour éviter d'avoir à répondre à chaque démarrage |
| /fork | Dupliquer la session | Créer un nouveau fichier de session dérivé d'un message utilisateur précédent |
| /clone | Cloner la session | Copier la branche active courante vers un nouveau fichier de session |
| /compact | Compacter le contexte | Compacter manuellement l'historique de conversation pour libérer de l'espace dans la fenêtre de contexte |
| /copy | Copier la réponse | Copier la dernière réponse de l'IA dans le presse-papiers |
| /export | Exporter la session | Exporter en fichier HTML ou JSONL |
| /import | Importer la session | Importer et restaurer la session à partir d'un fichier JSONL |
| /share | Partager la session | Téléverser en tant que Gist GitHub privé, générer un lien HTML partageable |
| /reload | Rechargement à chaud | Recharger les extensions, les Skills, les modèles de prompt, les thèmes, les fichiers de contexte et les configurations de raccourcis clavier |
| /hotkeys | Aide sur les raccourcis clavier | Afficher une liste de tous les raccourcis clavier |
| /changelog | Journal des modifications | Afficher l'historique des mises à jour de version |
| /quit | Quitter | Quitter 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 :
| Niveau | Scénario d'application |
|---|---|
| off | Aucun raisonnement (tâches générales) |
| minimal / faible | Raisonnement léger (codage courant) |
| moyen | Raisonnement modéré |
| élevé / xhigh | Raisonnement approfondi (problèmes complexes) |
| max | Raisonnement 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éfixe | Comportement | Gestion de la sortie | Cas d'utilisation |
|---|---|---|---|
| ! | Exécuter la commande et envoyer la sortie à l'IA | Visible par l'IA | Permettre à 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'IA | Affichage local uniquement | Ouvrir 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 message | Raccourci | Moment du déclenchement | Scénario typique |
|---|---|---|---|
| Orientation | Entrée | Inséré après la fin de l'exécution de tous les appels d'outils du cycle en cours, avant l'appel LLM suivant | Lorsque l'IA exécute une séquence d'appels read → edit → bash et que vous souhaitez corriger sa direction en cours de route |
| Suivi | Alt+Entrée | Insé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 | Échap | Interrompre l'opération en cours et récupérer les messages en file d'attente pour les renvoyer dans la zone d'édition | Arrê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’attente | Alt+Up | N’interrompez pas l’opération en cours, renvoyez uniquement les messages en file d’attente dans la zone de l’éditeur | Lorsque 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 fichiers | Tapez @ pour déclencher la recherche floue des fichiers du projet |
| Complétion automatique des chemins | Appuyez sur Tab pour auto-compléter les chemins |
| Saisie multiligne | Maj+Entrée pour un saut de ligne (utilisez Ctrl+Entrée dans Windows Terminal) |
| Coller une image | Ctrl+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'IA | Ctrl+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 externe | Ctrl+G ouvre un éditeur externe pour modifier le contenu actuel |
Autres extensionsDans 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.