smartagent-sf 0.1.1

Biblioteca Python para criar agentes de IA com execução determinística

SmartAgent 🤖

Biblioteca Python leve para criar agentes de IA com execução determinística em 3 fases.

Características ✨

• Multi-Provider: Suporta Groq, OpenAI, Gemini, Grok, Ollama e Llama
• Sem Schemas: Não precisa de Pydantic ou definições complexas
• 3 Fases: Análise → Execução → Resposta
• Econômico: Minimiza uso de tokens
• Simples: Menos de 500 linhas de código

Instalação

# Instalar dependências
pip install requests

Uso Rápido

from agent import Agent

# Criar agente
agent = Agent(model="groq")

# Registrar ferramentas
@agent.tool
def get_products(max_price=100):
    return [{"nome": "Mouse", "preço": 50}]

# Executar
response = agent.chat("Quais produtos baratos?")
print(response)

Instruções Customizadas

Você pode adicionar instruções personalizadas ao agente:

agent = Agent(
    model="groq",
    info="""
    Você é um assistente especializado em e-commerce.
    - Sempre sugira produtos relacionados
    - Use tom amigável e profissional
    - Destaque promoções quando disponíveis
    """
)

Providers Suportados

• Groq: Agent(model="groq", api_key="...")
• OpenAI: Agent(model="openai", api_key="...")
• Gemini: Agent(model="gemini", api_key="...")
• Grok: Agent(model="grok", api_key="...")
• Ollama: Agent(model="ollama") (local)
• Llama: Agent(model="llama", api_key="...")

Variáveis de Ambiente

export GROQ_API_KEY="your-key"
export OPENAI_API_KEY="your-key"
export GEMINI_API_KEY="your-key"
export XAI_API_KEY="your-key"
export LLAMA_API_KEY="your-key"

export LLM="modelo-ai"

Arquitetura

1. Analyzer: Determina quais ferramentas executar
2. Executor: Executa ferramentas com parâmetros
3. Responder: Gera resposta humanizada

Exemplo Completo

Veja examples/minimal_agent.py