English 中文 العربية 日本語 Português

Pi Agent: Installation & Authentication

Última atualização: 2026-08-31

--- title: "Instalacao e Autenticacao" description: "Aprenda a instalar o Pi Agent, configurar ambientes Python, definir chaves API e provedores de modelos, e concluir o primeiro lancamento." order: 2 lang: pt-br

Ferramentas afiadas fazem bom trabalho. Esta lição deixa seu ambiente de desenvolvimento Pi Agent funcionando em 5 minutos.

1. Requisitos

Item Mínimo Recomendado
Python 3.9+ 3.11+
pip Mais recente Mais recente
SO Windows / macOS / Linux Qualquer
RAM 512MB livres 2GB+
Disco 200MB 1GB+

Verifique a versão do Python:

BASH 
python --version
# Python 3.11.8

2. Instalando o Pi Agent

(1) Instalação via pip (Recomendado)

BASH 
pip install pi-agent

(2) Instalar a partir do Código-Fonte

BASH 
git clone https://github.com/pi-agent/pi-agent.git
cd pi-agent
pip install -e .

(3) Verificar Instalação

BASH 
pi-agent --version
# Pi Agent v0.8.0

(4) Dependências Opcionais

BASH 
pip install pi-agent[all]          # Instalar todas as dependências opcionais
pip install pi-agent[deepseek]     # Suporte ao DeepSeek
pip install pi-agent[local]        # Suporte a modelo local (llama.cpp)
pip install pi-agent[tools]        # Conjunto estendido de ferramentas

3. Autenticação e Configuração de Modelo

Pi Agent suporta múltiplos provedores de LLM. Você precisa configurar chaves API antes de usar.

(1) Variáveis de Ambiente (Recomendado)

BASH 
# DeepSeek
export PI_DEEPSEEK_API_KEY="sk-xxxxxxxx"

# OpenAI
export PI_OPENAI_API_KEY="sk-xxxxxxxx"

# Anthropic
export PI_ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"

Windows PowerShell:

POWERSHELL 
$env:PI_DEEPSEEK_API_KEY = "sk-xxxxxxxx"

(2) Arquivo de Configuração

Crie ~/.pi-agent/config.yaml:

YAML 
providers:
  deepseek:
    api_key: "sk-xxxxxxxx"
    base_url: "https://api.deepseek.com"
    model: "deepseek-chat"

  openai:
    api_key: "sk-xxxxxxxx"
    model: "gpt-4o"

  anthropic:
    api_key: "sk-ant-xxxxxxxx"
    model: "claude-sonnet-4-20250514"

default_provider: deepseek

(3) Configuração no Código

PYTHON 
from pi_agent import Agent

agent = Agent(
    name="my_agent",
    provider="deepseek",
    api_key="sk-xxxxxxxx",
    model="deepseek-chat"
)

4. Visão Geral dos Provedores de Modelo

Provedor Exemplo de Modelo Pontos Fortes Preço
DeepSeek deepseek-chat Alto custo-benefício, excelente em chinês Baixo
OpenAI gpt-4o Capacidade geral forte Médio-Alto
Anthropic claude-sonnet-4-20250514 Texto longo, código forte Médio
Modelos locais llama.cpp Privacidade, offline Grátis
Ollama llama3, mistral Deploy local fácil Grátis

Exemplo 1: Alternância entre Provedores (Dificuldade: ⭐)

PYTHON 
from pi_agent import Agent

deepseek_agent = Agent(provider="deepseek", model="deepseek-chat")
openai_agent = Agent(provider="openai", model="gpt-4o")

result_d = deepseek_agent.chat("Explain quantum computing in one sentence")
result_o = openai_agent.chat("Explain quantum computing in one sentence")

print(f"DeepSeek: {result_d}")
print(f"OpenAI: {result_o}")

5. Teste de Primeiro Lançamento

Após a instalação e configuração, execute um teste rápido:

BASH 
pi-agent chat "Hello, Pi Agent!"

Saída esperada:

TEXT 📖 Somente leitura 
Pi Agent v0.8.0
Provider: deepseek (deepseek-chat)
Hello! I'm Pi Agent, how can I help you?

Alice completou sua configuração em 3 minutos seguindo estes passos. Bob diz: "A instalação do Pi Agent é mais simples que a maioria das ferramentas Python — instale, configure uma chave e pronto."

❓ Perguntas Frequentes

P: pip install falha? R: Atualize o pip primeiro (pip install --upgrade pip). Se for problema de rede, use um mirror: pip install pi-agent -i https://pypi.tuna.tsinghua.edu.cn/simple. P: Chave API configurada mas não funciona? R: Verifique o nome da variável de ambiente (deve ter o prefixo PI_) e o caminho do arquivo de configuração (~/.pi-agent/config.yaml). Configuração no código tem prioridade máxima. P: Posso usar o Pi Agent sem chave API? R: Sim. Instale pi-agent[local] e use llama.cpp ou Ollama para rodar modelos locais sem nenhuma chave API. Veja a Lição 18.

❓ Resumo

📝 Exercícios

  1. Básico (Dificuldade: ⭐): Instale o Pi Agent e verifique com pi-agent --version.
  2. Intermediário (Dificuldade: ⭐⭐): Configure pelo menos dois provedores de LLM, crie instâncias de Agent para cada e verifique a conectividade.
  3. Avançado (Dificuldade: ⭐⭐⭐): Escreva um script que detecte automaticamente as chaves API disponíveis e liste os provedores atualmente acessíveis.
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%