Modo interactivo de Pi Agent
Este capítulo presenta en detalle las operaciones principales del modo interactivo de Pi Agent, incluyendo comandos Slash, gestión de modelos y atajos de teclado.
Referencia completa de comandos Slash
Escriba en el área de edición/Se activará el autocompletado de comandos.
Los siguientes son los comandos integrados más comunes en el modo interactivo de Pi Agent:
| Comando | Función | Descripción |
|---|---|---|
| /login | Iniciar sesión en el proveedor | Seleccione una suscripción OAuth o un proveedor de API Key para autenticarse. |
| /logout | Cerrar sesión | Elimina las credenciales de autenticación almacenadas. |
| /model | Cambiar de modelo | Abre el selector de modelos y permite buscar por nombre; dentro del selector, presione Ctrl+S para guardarlo como predeterminado de inicio. |
| /thinking | Cambiar el nivel de razonamiento | Abre el selector de nivel de razonamiento; dentro del selector, presione Ctrl+S para guardarlo como predeterminado de inicio. |
| /scoped-models | Gestión del ámbito de modelos | Establece la lista de modelos disponibles para el cambio cíclico con Ctrl+P. |
| /settings | Panel de configuración | Abre la interfaz de configuración integrada: nivel de razonamiento, tema, envío de mensajes, protocolo de transferencia, etc. |
| /resume | Restaurar sesión | Selecciona y restaura una sesión del historial. |
| /new | Nueva sesión | Inicia una conversación completamente nueva. |
| /name | Nombrar sesión | Establece un nombre legible para la sesión actual. |
| /session | Información de la sesión | Muestra la ruta del archivo de sesión, ID, número de mensajes, uso de tokens y coste. |
| /tree | Navegación por el árbol de sesión | Salta a cualquier nodo del árbol de conversación para continuar la conversación. |
| /trust | Confiar en el proyecto | Guarda la decisión de confianza del proyecto para evitar que pregunte en cada inicio. |
| /fork | Bifurcar sesión | Bifurca un nuevo archivo de sesión a partir de un mensaje de usuario anterior. |
| /clone | Clonar sesión | Copia la rama activa actual a un nuevo archivo de sesión. |
| /compact | Comprimir contexto | Comprime manualmente el historial de conversación para liberar espacio en la ventana de contexto. |
| /copy | Copiar respuesta | Copia la última respuesta de la IA al portapapeles. |
| /export | Exportar sesión | Exporta a un archivo HTML o JSONL. |
| /import | Importar sesión | Importa y restaura una sesión desde un archivo JSONL. |
| /share | Compartir sesión | Sube como GitHub Gist privado y genera un enlace HTML compartible. |
| /reload | Recarga en caliente | Recarga extensiones, Skills, plantillas de indicaciones, temas, archivos de contexto y configuración de atajos de teclado. |
| /hotkeys | Ayuda de atajos de teclado | Muestra la lista de todos los atajos de teclado. |
| /changelog | Registro de cambios | Muestra el historial de actualizaciones de versiones. |
| /quit | Salir | Sale de Pi Agent. |
Además de los comandos integrados, las extensiones también pueden registrar comandos personalizados.
Las Skills se registran automáticamente como/skill:nombrecomando; las plantillas de indicaciones se invocan mediante/nombre_plantillapara invocarlas.
Gestión de modelos
La gestión de modelos abarca tres aspectos: cambiar de modelo, configurar el alcance del cambio cíclico y ajustar el nivel de razonamiento.
A continuación se presentan los comandos y atajos correspondientes.
Cambiar de modelo (/model y Ctrl+L)
Use/modelel comando oCtrl+Labra el selector de modelos para explorar todos los modelos de IA disponibles.
En el selector de modelos, puede buscar por nombre; tras seleccionarlo, presione Ctrl+S para guardarlo como predeterminado de inicio.
A continuación se muestra el proceso de abrir el selector de modelos y cambiar de modelo:
/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
Los modelos de la lista dependen de los proveedores que haya configurado; la visualización real puede diferir del ejemplo.
Cambio cíclico rápido (Ctrl+P)
Ctrl+PCambio cíclico hacia adelante entre modelos,Shift+Ctrl+Pcambio hacia atrás.
El alcance del cambio está controlado por/scoped-modelsel comando oenabledModelsla configuración.
Nivel de razonamiento (Shift+Tab)
Shift+TabCambia cíclicamente el nivel de razonamiento.
El color del borde del editor cambia según el nivel, lo que le permite percibir visualmente la profundidad de razonamiento actual:
| Nivel | Escenario de uso |
|---|---|
| off | Sin razonamiento (tareas generales) |
| minimal / low | Razonamiento ligero (programación habitual) |
| medium | Razonamiento medio |
| high / xhigh | Razonamiento profundo (problemas complejos) |
| max | Máximo razonamiento (lógica extremadamente compleja) |
En el selector /thinking, presione Ctrl+S para guardar el nivel actual como predeterminado de inicio.
Los niveles de razonamiento no soportados por el modelo no se aplicarán ni aparecerán en la lista de cambio.
La capacidad del modelo determina el límite superior del nivel de razonamiento.
Integración de comandos Shell
Puede ejecutar comandos shell directamente en el área de edición sin salir de Pi Agent:
| Prefijo | Comportamiento | Procesamiento de la salida | Escenarios de uso |
|---|---|---|---|
| ! | Ejecuta el comando y envía la salida a la IA | Visible para la IA | Permite que la IA vea resultados de pruebas, salida de lint, estado de git |
| !! | Ejecuta el comando sin enviar la salida a la IA | Solo se muestra localmente | Abrir archivos, ver el entorno, comprobaciones rápidas |
Ejemplos de uso:
!npm test !git diff --stat !python -m pytest -v !!cat ~/.zshrc !!ls -la
A continuación se ejecuta!npm testEl efecto real después de ejecutar: la salida se muestra localmente y también se entrega a la 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 salida del comando ocupa la ventana de contexto de la IA.
Si la salida es muy grande (como registros completos), considere usar!!o redirija la salida a un archivo para que la IA lo lea.
Cola de mensajes en profundidad
La cola de mensajes le permite enviar instrucciones mientras la IA está trabajando, mejorando enormemente la eficiencia de la interacción:
| Tipo de mensaje | Atajo de teclado | Momento de activación | Escenario típico |
|---|---|---|---|
| Steering (dirección) | Enter | Se inserta después de que todas las llamadas a herramientas de la ronda actual se hayan ejecutado y antes de la siguiente llamada al LLM. | Cuando la IA está ejecutando una secuencia de llamadas read → edit → bash y desea corregir la dirección a mitad de camino. |
| Follow-up (seguimiento) | Alt+Enter | Se inserta solo después de que la IA haya terminado todo el trabajo (no hay más llamadas a herramientas pendientes). | Añadir nuevos requisitos después de que la IA complete la tarea actual. |
| Cancelar y recuperar | Escape | Detiene la operación actual y recupera los mensajes en cola al área de edición. | Cuando la IA se desvía, deténgala de inmediato y recupere las instrucciones en cola. |
| Solo recuperar mensajes en cola | Alt+Up | No detiene la operación actual; solo recupera los mensajes en cola al área de edición. | Cuando desea reescribir el contenido en cola sin interrumpir a la IA. |
A través de la configuración,steeringModeyfollowUpModepuede controlar la estrategia de envío de mensajes.
En Windows y WSL, Alt+Enter suele estar ocupado por la terminal (por ejemplo, Windows Terminal lo asigna de forma predeterminada a alternar pantalla completa); en ese caso, Ctrl+Q está disponible como predeterminado para enviar mensajes follow-up.
Funciones del editor
El área de edición ofrece capacidades mejoradas como referencia de archivos, autocompletado de rutas y entrada multilínea, lo que reduce la necesidad de cambiar de herramienta constantemente.
| Función | Método de operación |
|---|---|
| Búsqueda de referencia de archivos | Escriba @ para activar la búsqueda difusa de archivos del proyecto. |
| Autocompletado de rutas | Presione Tab para autocompletar la ruta. |
| Entrada multilínea | Shift+Enter para nueva línea (en Windows Terminal use Ctrl+Enter) |
| Pegar imagen | Ctrl+V (en Windows use Alt+V; WSL también usa Alt+V), o arrastre la imagen al terminal. |
| Copiar respuesta de la IA | Ctrl+X copia el mensaje seleccionado actualmente en /tree; en otros casos copia la última respuesta de la IA. |
| Editor externo | Ctrl+G abre un editor externo para editar el contenido actual. |
Otras extensionesLa "Windows Terminal usa Ctrl+Enter" en la entrada multilínea es una adaptación automática bajo Windows Terminal, no un valor predeterminado en keybindings.json.