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:

ComandoFunciónDescripción
/loginIniciar sesión en el proveedorSeleccione una suscripción OAuth o un proveedor de API Key para autenticarse.
/logoutCerrar sesiónElimina las credenciales de autenticación almacenadas.
/modelCambiar de modeloAbre el selector de modelos y permite buscar por nombre; dentro del selector, presione Ctrl+S para guardarlo como predeterminado de inicio.
/thinkingCambiar el nivel de razonamientoAbre el selector de nivel de razonamiento; dentro del selector, presione Ctrl+S para guardarlo como predeterminado de inicio.
/scoped-modelsGestión del ámbito de modelosEstablece la lista de modelos disponibles para el cambio cíclico con Ctrl+P.
/settingsPanel de configuraciónAbre la interfaz de configuración integrada: nivel de razonamiento, tema, envío de mensajes, protocolo de transferencia, etc.
/resumeRestaurar sesiónSelecciona y restaura una sesión del historial.
/newNueva sesiónInicia una conversación completamente nueva.
/nameNombrar sesiónEstablece un nombre legible para la sesión actual.
/sessionInformación de la sesiónMuestra la ruta del archivo de sesión, ID, número de mensajes, uso de tokens y coste.
/treeNavegación por el árbol de sesiónSalta a cualquier nodo del árbol de conversación para continuar la conversación.
/trustConfiar en el proyectoGuarda la decisión de confianza del proyecto para evitar que pregunte en cada inicio.
/forkBifurcar sesiónBifurca un nuevo archivo de sesión a partir de un mensaje de usuario anterior.
/cloneClonar sesiónCopia la rama activa actual a un nuevo archivo de sesión.
/compactComprimir contextoComprime manualmente el historial de conversación para liberar espacio en la ventana de contexto.
/copyCopiar respuestaCopia la última respuesta de la IA al portapapeles.
/exportExportar sesiónExporta a un archivo HTML o JSONL.
/importImportar sesiónImporta y restaura una sesión desde un archivo JSONL.
/shareCompartir sesiónSube como GitHub Gist privado y genera un enlace HTML compartible.
/reloadRecarga en calienteRecarga extensiones, Skills, plantillas de indicaciones, temas, archivos de contexto y configuración de atajos de teclado.
/hotkeysAyuda de atajos de tecladoMuestra la lista de todos los atajos de teclado.
/changelogRegistro de cambiosMuestra el historial de actualizaciones de versiones.
/quitSalirSale 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:

NivelEscenario de uso
offSin razonamiento (tareas generales)
minimal / lowRazonamiento ligero (programación habitual)
mediumRazonamiento medio
high / xhighRazonamiento profundo (problemas complejos)
maxMá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:

PrefijoComportamientoProcesamiento de la salidaEscenarios de uso
!Ejecuta el comando y envía la salida a la IAVisible para la IAPermite que la IA vea resultados de pruebas, salida de lint, estado de git
!!Ejecuta el comando sin enviar la salida a la IASolo se muestra localmenteAbrir 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 mensajeAtajo de tecladoMomento de activaciónEscenario típico
Steering (dirección)EnterSe 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+EnterSe 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 recuperarEscapeDetiene 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 colaAlt+UpNo 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ónMétodo de operación
Búsqueda de referencia de archivosEscriba @ para activar la búsqueda difusa de archivos del proyecto.
Autocompletado de rutasPresione Tab para autocompletar la ruta.
Entrada multilíneaShift+Enter para nueva línea (en Windows Terminal use Ctrl+Enter)
Pegar imagenCtrl+V (en Windows use Alt+V; WSL también usa Alt+V), o arrastre la imagen al terminal.
Copiar respuesta de la IACtrl+X copia el mensaje seleccionado actualmente en /tree; en otros casos copia la última respuesta de la IA.
Editor externoCtrl+G abre un editor externo para editar el contenido actual.

La "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.

Otras extensiones