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

Pi Agent: DeepSeek Configuration

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

--- title: "Configuracao do DeepSeek" description: "Aprofunde-se na configuracao do DeepSeek como provedor LLM do Pi Agent, incluindo parametros de API, selecao de modelo, otimizacao de custos e opcoes avancadas." order: 3 lang: pt-br

DeepSeek é o provedor mais recomendado do Pi Agent — barato, capaz, excelente com chinês. Esta lição cobre a configuração completa do DeepSeek.

1. Por que DeepSeek

Vantagem Descrição
Alto custo-benefício Entrada ¥1/milhão de tokens, Saída ¥2/milhão de tokens
Excelente em chinês Treinamento nativo em chinês, compreensão e geração superiores
Function Calling Suporta chamada de ferramentas
Contexto longo Janela de contexto de 64K
Resposta rápida Baixa latência do primeiro token

2. Obtendo uma Chave API

  1. Acesse https://platform.deepseek.com/
  2. Registre-se e faça login
  3. Vá para a página "API Keys"
  4. Clique em "Create API Key"
  5. Copie a chave (formato: sk-xxxxxxxxxxxxxxxx)

Nota: A chave é exibida apenas uma vez. Salve-a com segurança. Se for comprometida, exclua-a imediatamente e crie uma nova.

3. Configuração Básica

(1) Configuração Mínima

YAML 
providers:
  deepseek:
    api_key: "sk-xxxxxxxx"

(2) Configuração Completa

YAML 
providers:
  deepseek:
    api_key: "sk-xxxxxxxx"
    base_url: "https://api.deepseek.com"
    model: "deepseek-chat"
    temperature: 0.7
    max_tokens: 4096
    top_p: 0.95
    timeout: 60

default_provider: deepseek

(3) Variáveis de Ambiente

BASH 
export PI_DEEPSEEK_API_KEY="sk-xxxxxxxx"
export PI_DEEPSEEK_BASE_URL="https://api.deepseek.com"

4. Seleção de Modelo

Modelo Caso de Uso Contexto Preço (por milhão de tokens)
deepseek-chat Conversação geral 64K Entrada ¥1 / Saída ¥2
deepseek-reasoner Raciocínio complexo 64K Entrada ¥4 / Saída ¥16

Exemplo 1: Comparando Modelos (Dificuldade: ⭐)

PYTHON 
from pi_agent import Agent

chat_agent = Agent(name="quick", provider="deepseek", model="deepseek-chat")
reasoner_agent = Agent(name="thinker", provider="deepseek", model="deepseek-reasoner")

print(chat_agent.chat("1+1=?"))
print(reasoner_agent.chat("Prove that the square root of 2 is irrational"))

5. Ajuste de Parâmetros

(1) temperature

Controla a aleatoriedade da saída; valores mais baixos são mais determinísticos:

PYTHON 
code_agent = Agent(model="deepseek-chat", temperature=0.1)     # Código: preciso
creative_agent = Agent(model="deepseek-chat", temperature=1.0) # Criativo: diverso

(2) max_tokens

Controla o comprimento máximo da resposta:

PYTHON 
brief_agent = Agent(model="deepseek-chat", max_tokens=256)     # Respostas curtas
essay_agent = Agent(model="deepseek-chat", max_tokens=8192)    # Textos longos

(3) Configuração de Chamada de Ferramentas

PYTHON 
agent = Agent(
    provider="deepseek",
    model="deepseek-chat",
    tools=["search", "calculator"],
    tool_choice="auto"  # auto | required | none
)
tool_choice Comportamento
auto O Agent decide se chama ferramentas
required Deve chamar uma ferramenta
none Não permite chamadas de ferramentas

6. Otimização de Custos

Alice processa milhares de requisições diariamente. Ela usa estas estratégias:

PYTHON 
agent = Agent(
    provider="deepseek",
    model="deepseek-chat",
    max_tokens=2048,
    temperature=0.3,
    context_window=4096
)

Bob aconselha: "Use deepseek-chat para perguntas simples, deepseek-reasoner apenas para raciocínio complexo. Chat cobre 90% dos cenários."

❓ Perguntas Frequentes

P: API do DeepSeek retorna erro 401? R: A chave API é inválida ou expirou. Verifique na plataforma — certifique-se de que não há espaços ou quebras de linha extras. P: Respostas estão lentas? R: Verifique sua conexão de rede, reduza max_tokens, diminua o tamanho da janela de contexto. Horários de pico podem ter latência aumentada. P: A API do DeepSeek é compatível com OpenAI? R: Sim. O formato da API do DeepSeek é compatível com OpenAI. Você pode definir base_url para DeepSeek e usar o SDK OpenAI. Pi Agent já tem isso integrado.

❓ Resumo

📝 Exercícios

  1. Básico (Dificuldade: ⭐): Registre uma conta DeepSeek, obtenha uma chave API, configure o Pi Agent e envie uma mensagem.
  2. Intermediário (Dificuldade: ⭐⭐): Compare deepseek-chat e deepseek-reasoner no mesmo problema de matemática.
  3. Avançado (Dificuldade: ⭐⭐⭐): Construa uma ferramenta de monitoramento de custos que registre o uso de tokens e despesas por chamada de API.
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%