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.

Pi Agent 交互界面四个区域布局

L'interface est divisée en quatre zones principales :

ZonePositionContenu affiché
En-tête de démarrageTopIndications de raccourcis, fichiers de contexte chargés, modèles de prompt, Skills, extensions
Zone de messagesMiddleMessages utilisateur, réponses de l'IA, détails des appels d'outils, notifications et erreurs
Zone d’éditionLigne de saisie en basVotre emplacement de saisie ; la couleur de la bordure indique le niveau de raisonnement actuel
Barre d'état inférieureBottomRé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.

PlateformeOpérationDescription
macOS / LinuxCtrl+VColler une image depuis le presse-papiers
WindowsAlt+VColler une image depuis le presse-papiers
Terminaux pris en chargeFaites glisser et déposez une image dans la fenêtre du terminalTransmettez-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érationRaccourci
Insérer un saut de ligneShift+Enter (utilisez Ctrl+Enter dans Windows Terminal)
Ouvrir l'éditeur externeCtrl+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é :

RaccourciComportementDescription
EntréeEnvoyer un message de guidageEnvoyé à l'IA immédiatement après que l'outil en cours a fini de s'exécuter
Alt+EntréeEnvoyer un message de suiviEnvoyé après que l'IA a terminé tout son travail
ÉchapAnnuler les messages en file d'attenteRestaurer les messages en file d'attente dans la zone d'édition
Alt+UpRécupérer un message en file d'attenteRemettre 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

# Questions-réponses ponctuelles, se ferme après la sortie
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

# Instructions du projet

- 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érationRaccourciDescription
Soumettre l’entréeEntréeEnvoyer 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èleCtrl+LOuvrir le sélecteur de modèle
Changer de modèleCtrl+P / Shift+Ctrl+PParcourir les modèles vers l’avant/vers l’arrière
Niveau de raisonnementShift+TabParcourir les niveaux de raisonnement
Développer/réduire la sortie des outilsCtrl+OBasculer l’affichage des résultats des appels d’outils
Développer/réduire le processus de raisonnementCtrl+TBasculer l’affichage du processus de raisonnement de l’IA
Interrompre l'opérationÉchapAnnuler l'opération IA en cours (voir File d'attente des messages)
Effacer la zone d'éditionCtrl+CEffacer le contenu actuel de la zone d'édition
Copier la dernière réponse de l'IACtrl+XCopier le contenu de la réponse dans le presse-papiers
Autocomplétion des cheminsOngletCompléter les chemins de fichiers
Quitter le programmeCtrl+DQuitter le programme lorsque la zone d'édition est vide
Quitter le programme (direct)/quitQuitter immédiatement
Autres extensions