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

BASH
pi-agent chat

Entre no REPL interativo:

TEXT 📖 Somente leitura
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

BASH
pi-agent chat --provider openai --model gpt-4o --system "You are a code review expert"

(2) Carregar Contexto de Arquivo

BASH
pi-agent chat --context ./project_context.json

2. Operações Básicas

(1) Enviar Mensagens

Digite texto e pressione Enter:

TEXT 📖 Somente leitura
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:

TEXT 📖 Somente leitura
you> """
Please review the following code:
def add(a, b):
    return a + b
"""

(3) Sair

TEXT 📖 Somente leitura
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: ⭐)

TEXT 📖 Somente leitura
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:

TEXT 📖 Somente leitura
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

TEXT 📖 Somente leitura
you> /save chat_20260828.json
Conversation saved to chat_20260828.json

(2) Carregar Conversa

TEXT 📖 Somente leitura
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

TEXT 📖 Somente leitura
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 /load para 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


📝 Exercícios

  1. Básico (Dificuldade: ⭐): Inicie o modo interativo, faça 3 rodadas de conversa, use /history para revisar.
  2. Intermediário (Dificuldade: ⭐⭐): Troque modelos e ferramentas dentro de uma sessão, complete uma tarefa combinada de "busca + cálculo".
  3. Avançado (Dificuldade: ⭐⭐⭐): Complete um workflow completo de revisão de código: carregar código → revisar → modificar → verificar.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%