Première conversation avec Pi Agent
Après avoir terminé l'installation et la configuration de l'authentification, ce chapitre vous fait découvrir votre première expérience de conversation complète.
Vous vous familiariserez avec la disposition de l'interface et les opérations de base.
Lancer Pi Agent
Entrez dans le répertoire de votre projet et lancez Pi Agent :
$ cd ~/projects/example-demo $ pi
Vous verrez l'interface interactive de Pi Agent apparaître dans le terminal.
L'interface est divisée en quatre zones principales :
| Zone | Position | Contenu affiché |
|---|---|---|
| En-tête de démarrage | Top | Indications de raccourcis, fichiers de contexte chargés, modèles de prompt, Skills, extensions |
| Zone de messages | Middle | Messages utilisateur, réponses de l'IA, détails des appels d'outils, notifications et erreurs |
| Zone d’édition | Ligne de saisie en bas | Votre emplacement de saisie ; la couleur de la bordure indique le niveau de raisonnement actuel |
| Barre d'état inférieure | Bottom | Répertoire de travail, nom de session, utilisation des jetons/cache, utilisation du contexte, coût, nom du modèle actuel (le total inclut les réponses de l’IA, l’utilisation signalée par les outils et la consommation liée à la génération du résumé) |
Si vous trouvez que les informations d’en-tête affichées au démarrage sont trop nombreuses, vous pouvez activer dans les paramètresquietStartupl’option pour les masquer.
Première tâche
Après avoir accédé à l’interface, saisissez votre première requête et appuyez sur Entrée :
Help me summarize the structure and main functions of this project.
Pi Agent utilisera des outils intégrés pour lire les fichiers de votre projet, analyser la structure du code, puis renvoyer un résumé.
Vous pouvez voir dans la zone des messages ce que fait l’IA — y compris les outils qu’elle a appelés et les fichiers qu’elle a lus.
La sortie d’une conversation complète ressemble à :
> read README.md(1.2k 字符) > read src/main.ts(3.4k 字符) 这是一个基于 TypeScript 的终端编程助手,主要功能分为会话管理、工具调度和扩展加载三部分。 Tokens: 2.4k 输入 / 410 输出 | 费用 $0.0152
Pi Agent fournit par défaut quatre outils intégrés : read, write, edit et bash. Pour plus de détails, consultez le chapitre « Aperçu des concepts fondamentaux ».
Référencer des fichiers
Vous pouvez référencer des fichiers spécifiques dans une conversation ; il existe deux façons :
Méthode 1 : syntaxe @ (recherche dans l'éditeur)
Saisissez dans la zone d'édition@Une recherche floue des fichiers du projet s'affichera automatiquement :
@src/app.ts 解释这个文件的功能
Méthode 2 : arguments de ligne de commande
Passez les références de fichiers directement au démarrage :
$ pi @README.md "总结一下这个文档" $ pi @src/app.ts @src/app.test.ts "对比这两个文件"
Vous pouvez également référencer des fichiers image :
$ pi -p @screenshot.png "这张截图里显示了什么"
Collage d'images
Pi Agent prend en charge l'envoi d'images dans les conversations ; les méthodes d'utilisation varient légèrement selon les plateformes.
| Plateforme | Opération | Description |
|---|---|---|
| macOS / Linux | Ctrl+V | Coller une image depuis le presse-papiers |
| Windows | Alt+V | Coller une image depuis le presse-papiers |
| Terminaux pris en charge | Faites glisser et déposez une image dans la fenêtre du terminal | Transmettez-le dans la conversation en tant que fichier |
Exécution de commandes dans la conversation
Vous pouvez exécuter des commandes shell directement depuis la zone d'édition sans quitter Pi Agent :
!npm run lint !git diff
avec!Les commandes commençant par le préfixe seront exécutées, et la sortie sera automatiquement envoyée à l'IA pour examen.
Exécutez!npm run lintLe résultat est similaire à :
> pi-agent@1.0.0 lint > eslint . 0 errors, 0 warnings
avec!!Les commandes commençant par le préfixe s'exécuteront aussi, maisn'enverront pas la sortie à l'IA :
!!echo "这只在本地显示" 这只在本地显示
Utiliser!!le préfixe pour exécuter des commandes qui n'ont pas besoin d'une révision par l'IA (comme l'ouverture de fichiers, la consultation des variables d'environnement) peut éviter de gaspiller la fenêtre de contexte.
Saisie multiligne et éditeur externe
De grands blocs de texte peuvent être écrits en utilisant la saisie multiligne ou un éditeur externe ; voici les raccourcis pertinents.
| Opération | Raccourci |
|---|---|
| Insérer un saut de ligne | Shift+Enter (utilisez Ctrl+Enter dans Windows Terminal) |
| Ouvrir l'éditeur externe | Ctrl+G |
Lorsque vous devez saisir un grand bloc de texte, appuyez surCtrl+Get l'éditeur par défaut du système s'ouvrira (comme nano, vim ou VS Code) ; après enregistrement, le contenu sera automatiquement inséré dans la zone d'édition de Pi Agent.
File de messages
Pi Agent vous permet d'envoyer des messages pendant que l'IA travaille, sans avoir à attendre qu'elle ait terminé :
| Raccourci | Comportement | Description |
|---|---|---|
| Entrée | Envoyer un message de guidage | Envoyé à l'IA immédiatement après que l'outil en cours a fini de s'exécuter |
| Alt+Entrée | Envoyer un message de suivi | Envoyé après que l'IA a terminé tout son travail |
| Échap | Annuler les messages en file d'attente | Restaurer les messages en file d'attente dans la zone d'édition |
| Alt+Up | Récupérer un message en file d'attente | Remettre un message en file d'attente dans la zone d'édition pour modification |
Dans Windows Terminal, Alt+Enter est le raccourci plein écran par défaut. Si vous voulez que Pi Agent reçoive ce raccourci, consultezDéploiement multiplateformepour les instructions de remappage.
Mode non interactif
En plus des conversations interactives, vous pouvez également utiliser Pi Agent rapidement de la manière suivante :
Exemples
pi -p "Résume cette base de code"
# Entrée par pipe : transmettre le contenu du fichier à l'IA
cat README.md | pi -p "Résume ce texte"
# Questions-réponses ponctuelles avec une image
pi -p @screenshot.png "Que contient cette image ?"
# Session nommée (pour reprendre facilement plus tard)
pi --name "Revue de code" -p "Examinez le code dans le répertoire src/"
# Mode lecture seule (modifications de fichiers non autorisées)
pi --tools read,grep,find,ls -p "Examinez le code sans le modifier"
Le mode d'impression (-p) est idéal pour l'intégration dans des scripts et des pipelines CI.
Création d'un fichier d'instructions de projet
Pour aider l'IA à mieux comprendre votre projet, il est recommandé de créer un fichier AGENTS.md.
Enregistrez le contenu suivant en tant que fichier Markdown avec le cheminracine du projet/AGENTS.md:
Exemples
- Exécutez `npm run check` après avoir modifié le code
- Ne pas exécuter les migrations de production directement sur votre machine locale
- Gardez des réponses concises, sans explications excessives
- Écrivez du code en utilisant le mode strict de TypeScript
- Suivez le style de code existant du projet
Pi Agent chargera automatiquement ce fichier au démarrage.
Il chargera également depuis~/.pi/agent/AGENTS.mdles instructions globales et les fichiers d'instructions dans les répertoires parents.
Après avoir mis à jour AGENTS.md, utilisez la commande/reloadpour recharger à chaud, aucun redémarrage nécessaire.
Si vous avez déjà utilisé Claude Code, les fichiers CLAUDE.md existants peuvent être directement reconnus et utilisés par Pi Agent sans les renommer.
Aperçu de l'interface
Voici une référence rapide pour les principaux raccourcis du mode interactif de Pi Agent :
| Opération | Raccourci | Description |
|---|---|---|
| Soumettre l’entrée | Entrée | Envoyer le contenu actuel de la zone d’édition ; lorsque l’IA travaille, il entre dans la file de messages (voir File de messages) |
| Sélection du modèle | Ctrl+L | Ouvrir le sélecteur de modèle |
| Changer de modèle | Ctrl+P / Shift+Ctrl+P | Parcourir les modèles vers l’avant/vers l’arrière |
| Niveau de raisonnement | Shift+Tab | Parcourir les niveaux de raisonnement |
| Développer/réduire la sortie des outils | Ctrl+O | Basculer l’affichage des résultats des appels d’outils |
| Développer/réduire le processus de raisonnement | Ctrl+T | Basculer l’affichage du processus de raisonnement de l’IA |
| Interrompre l'opération | Échap | Annuler l'opération IA en cours (voir File d'attente des messages) |
| Effacer la zone d'édition | Ctrl+C | Effacer le contenu actuel de la zone d'édition |
| Copier la dernière réponse de l'IA | Ctrl+X | Copier le contenu de la réponse dans le presse-papiers |
| Autocomplétion des chemins | Onglet | Compléter les chemins de fichiers |
| Quitter le programme | Ctrl+D | Quitter le programme lorsque la zone d'édition est vide |
| Quitter le programme (direct) | /quit | Quitter immédiatement |