Pular para o conteúdo
chatflow-agent logochatflow-agent
chatflow-agent v0.3.4 • Python >= 3.10

Construa Sistemas Multiagentes Contextuais em Python

Framework leve e assíncrono em Python para agentes de IA conversacional com handoffs nativos, persistencia de sessões em SQLite e integrações de canais prontas para produção.

Instalação e Início Rápido

Instale o pacote publicado e configure um runner multiagente persistente em menos de um minuto.

$pip install chatflow-agent
quickstart.py
import asyncio
from chatflow_agent import Agent, Runner, SQLiteSessionStore

# 1. Define a specialized conversational agent
support_agent = Agent(
    name="SupportAgent",
    instructions="You are a helpful customer support agent. Answer questions or delegate.",
    model="gemini-2.5-flash",
)

# 2. Initialize Runner with persistent SQLite session store
runner = Runner(
    starting_agent=support_agent,
    session_store=SQLiteSessionStore("chatflow_sessions.db"),
)

# 3. Process conversation turn asynchronously
async def main():
    response = await runner.run_async(
        session_id="user_session_42",
        user_message="Hello! How do I connect this agent to WhatsApp?",
    )
    print(response.content)

if __name__ == "__main__":
    asyncio.run(main())
Native asyncioSQLite State & Rollback
Python >= 3.10

Explore a Documentação

Guias abrangentes, visão geral da arquitetura e exemplos verificados em Python para cada estágio do seu fluxo conversacional.

Instalação e Configuração

Configure seu ambiente virtual em Python, instale o chatflow-agent e prepare as credenciais de provedores.

Handoffs Multiagentes

Projete agentes especializados, configure o ciclo de vida do Runner e delegue turnos de conversação deterministicamente.

Webhooks e API em Produção

Integre webhooks com assinaturas criptográficas HMAC, implante com FastAPI e conecte canais em tempo real.

Projetado para Fluxos Conversacionais do Mundo Real

Tudo o que você precisa para implantar aplicações multiagentes confiáveis sem a sobrecarga de orquestradores pesados.

Handoffs Nativos entre Agentes

Delegação contextual perfeita entre agentes especializados, preservando o histórico e o estado da conversa.

Canais Prontos para Produção

Conectores integrados para WhatsApp, Telegram, Webhooks com validação de assinatura HMAC e CLI interativo.

Motores LLM Multiprovedor

Compatibilidade imediata com Google Gemini, Gemma, OpenAI, Anthropic Claude e xAI Grok com configuração unificada.

Estado em SQLite e Memória

Persistência integrada em SQLite, histórico de conversação, reversão de turnos e execução sequencial que evita condições de corrida.

Desempenho Assíncrono Nativo

Construído sobre o asyncio do Python para lidar com tráfego simultâneo de mensagens e webhooks em tempo real com baixo consumo.

Chamada Extensível de Ferramentas

Equipe seus agentes com funções personalizadas em Python, geração automática de esquemas e execução segura em múltiplos turnos.

Open Source

Código Aberto e Movido pela Comunidade

O chatflow-agent é um projeto de código aberto distribuído sob a Licença MIT, criado e liderado por Gustavo Baranda com a colaboração de desenvolvedores do mundo todo.