Instalação e Configuração
Configure seu ambiente virtual em Python, instale o chatflow-agent e prepare as credenciais de provedores.
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.
Instale o pacote publicado e configure um runner multiagente persistente em menos de um minuto.
pip install chatflow-agentimport 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())
Guias abrangentes, visão geral da arquitetura e exemplos verificados em Python para cada estágio do seu fluxo conversacional.
Configure seu ambiente virtual em Python, instale o chatflow-agent e prepare as credenciais de provedores.
Projete agentes especializados, configure o ciclo de vida do Runner e delegue turnos de conversação deterministicamente.
Integre webhooks com assinaturas criptográficas HMAC, implante com FastAPI e conecte canais em tempo real.
Tudo o que você precisa para implantar aplicações multiagentes confiáveis sem a sobrecarga de orquestradores pesados.
Delegação contextual perfeita entre agentes especializados, preservando o histórico e o estado da conversa.
Conectores integrados para WhatsApp, Telegram, Webhooks com validação de assinatura HMAC e CLI interativo.
Compatibilidade imediata com Google Gemini, Gemma, OpenAI, Anthropic Claude e xAI Grok com configuração unificada.
Persistência integrada em SQLite, histórico de conversação, reversão de turnos e execução sequencial que evita condições de corrida.
Construído sobre o asyncio do Python para lidar com tráfego simultâneo de mensagens e webhooks em tempo real com baixo consumo.
Equipe seus agentes com funções personalizadas em Python, geração automática de esquemas e execução segura em múltiplos turnos.
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.