Pi Agent: Interactive Mode
Última atualização: 2026-08-31
--- title: "Modo Interativo" description: "Domine o modo REPL interativo do Pi Agent, incluindo comandos, atalhos, gerenciamento de contexto e operacoes em sessao." order: 5 lang: pt-br
O modo interativo é como conversar face a face com a IA — pergunte, receba respostas, continue, mude de assunto a qualquer momento.
1. Iniciando o Modo Interativo
pi-agent chat
Entre no REPL interativo:
Pi Agent v0.8.0
Provider: deepseek (deepseek-chat)
Interactive mode started. Type a message to begin, /help for commands
you>
(1) Iniciar com Parâmetros
pi-agent chat --provider openai --model gpt-4o --system "You are a code review expert"
(2) Carregar Contexto de Arquivo
pi-agent chat --context ./project_context.json
2. Operações Básicas
(1) Enviar Mensagens
Digite texto e pressione Enter:
you> Help me explain what decorators are
Decorators are a syntactic sugar in Python, using the @ symbol...
(2) Entrada Multi-Linha
Envolva o conteúdo em aspas triplas:
you> """
Please review the following code:
def add(a, b):
return a + b
"""
(3) Sair
you> /exit
Goodbye!
Ou pressione Ctrl+C / Ctrl+D.
3. Comandos com Barra
O modo interativo possui comandos integrados que começam com /:
| Comando | Descrição |
|---|---|
| /help | Mostrar ajuda |
| /exit | Sair do modo interativo |
| /clear | Limpar histórico de conversa |
| /model | Trocar modelo |
| /provider | Trocar provedor |
| /tools | Listar ferramentas disponíveis |
| /use |
Habilitar uma ferramenta |
| /unuse |
Desabilitar uma ferramenta |
| /skill |
Carregar uma skill |
| /save |
Salvar conversa em arquivo |
| /load |
Carregar arquivo de conversa |
| /context | Mostrar informações de contexto atual |
| /history | Mostrar histórico de conversa |
| /retry | Regenerar última resposta |
| /edit | Editar última mensagem do usuário |
Exemplo 1: Troca de Modelo na Sessão (Dificuldade: ⭐)
you> /model deepseek-reasoner
Model switched to deepseek-reasoner
you> Prove there are infinitely many primes
[Reasoning...] Assume primes are finite, let the largest be p...
you> /model deepseek-chat
Model switched to deepseek-chat
you> Say it simply
Simply put, primes are infinite...
4. Interação com Ferramentas
Habilite/desabilite ferramentas dinamicamente no modo interativo:
you> /tools
Available tools:
[ON] calculator - Math calculations
[ON] search - Web search
[OFF] file_reader - File reading
[OFF] shell - System commands
you> /use file_reader
Tool enabled: file_reader
you> /use shell
Tool enabled: shell
you> Read main.py and run it
[Calling file_reader] -> Reading main.py
[Calling shell] -> Executing python main.py
main.py output: Hello, World!
5. Gerenciamento de Conversas
(1) Salvar Conversa
you> /save chat_20260828.json
Conversation saved to chat_20260828.json
(2) Carregar Conversa
you> /load chat_20260828.json
Loaded conversation (8 messages)
you> /history
[1] user: Help me explain decorators
[2] assistant: Decorators are...
[3] user: Give me example
...
(3) Editar e Tentar Novamente
you> Write a sorting algorithm
[Gave bubble sort]
you> /edit
Edit your message: Write a quicksort algorithm
[Regenerated] Quicksort's core idea is divide-and-conquer...
❓ Perguntas Frequentes
P: Como inserir código longo no modo interativo? R: Envolva em aspas triplas
""", ou use/loadpara carregar um arquivo de código, depois peça ao Agent para analisá-lo. P: /retry consome tokens extras? R: Sim. Cada tentativa é uma nova chamada de API. Mensagens anteriores permanecem no contexto. P: Posso rodar múltiplas sessões interativas simultaneamente? R: Sim. Cada janela de terminal é uma sessão independente.
❓ Resumo
pi-agent chatentra no modo interativo; digite texto para conversar- Comandos com barra gerenciam modelos, ferramentas, histórico de conversa
/usee/unusealternam ferramentas dinamicamente/savee/loadpersistem conversas;/edite/retryrefinam interações
📝 Exercícios
- Básico (Dificuldade: ⭐): Inicie o modo interativo, faça 3 rodadas de conversa, use /history para revisar.
- Intermediário (Dificuldade: ⭐⭐): Troque modelos e ferramentas dentro de uma sessão, complete uma tarefa combinada de "busca + cálculo".
- Avançado (Dificuldade: ⭐⭐⭐): Complete um workflow completo de revisão de código: carregar código → revisar → modificar → verificar.