Visão Geral da Documentação

Documentação oficial estável do chatflow-agent v0.3.4: um framework leve e assíncrono para múltiplos agentes com handoffs nativos em Python.

Linha de Versão Estável (v0.3.4)

Você está visualizando a documentação oficial estável do chatflow-agent v0.3.4, recomendada para implantações em produção.

Bem-vindo à documentação oficial do chatflow-agent, um framework assíncrono e leve em Python projetado para construir agentes conversacionais modulares e enxames multiagente com transferências (handoffs) nativas e fortemente tipadas.

Criado e liderado por Gustavo Baranda junto a uma comunidade internacional de código aberto, o chatflow-agent foi concebido para eliminar o excesso de complexidade de frameworks monolíticos e a dependência de fornecedores (vendor lock-in), oferecendo concorrência de nível empresarial, memória resiliente e conectividade multicanal.

Destaques da Arquitetura

Zero Bloqueio de SDKs (Vendor Lock-In)

Conecta-se a modelos LLM através de REST HTTP assíncrono puro usando httpx. Sem necessidade de SDKs pesados ou dependências desnecessárias em tempo de execução.

Handoffs Multiagente Nativos

Declare enxames colaborativos. Os agentes delegam tarefas dinamicamente usando ferramentas sintetizadas transfer_to_* com prevenção automática de ciclos.

Memória Transacional e Resiliente

Cada turno realiza uma captura atômica de estado. Em caso de erro ou estouro de tempo limite, o estado é revertido automaticamente. As operações SQLite rodam em pools de threads dedicados.

Pronto para Múltiplos Canais

Implante seus agentes facilmente em terminais REPL, bots do Telegram ou na API do WhatsApp Business Cloud com verificação de assinatura HMAC SHA-256.

Estratégia de Lançamentos e Versionamento

O chatflow-agent segue rigorosamente o Versionamento Semântico (SemVer). A documentação é organizada por faixas de versão:

Stable (0.3.4) Versão Estável Atual (Padrão): Recomendada para todas as implantações em produção. Publicada no PyPI em 23 de outubro de 2026.
Prerelease (0.4.0rc1) Versão Candidata 1 (Pré-lançamento): Disponível no PyPI para testes de novos aprimoramentos arquiteturais, incluindo execução nativa do Gemini via REST e validação de nomes duplicados em enxames.

# Instalar a versão estável atual (padrão)
pip install chatflow-agent

# Instalar a versão candidata de pré-lançamento
pip install "chatflow-agent==0.4.0rc1"

Documentação Orientada à Versão Estável

Todos os trechos de código e assinaturas de API nesta documentação correspondem por padrão à versão estável v0.3.4. Aprimoramentos ou mudanças disruptivas introduzidas na versão v0.4.0rc1 são explicitamente destacados com a insígnia Prerelease (0.4.0rc1).

Trilha de Primeiros Passos

Siga nosso guia passo a passo estruturado para ir da instalação a um agente rodando em produção em poucos minutos:

Instalação: Verifique seu ambiente Python (>=3.10), instale os pacotes principais e configure dependências extras opcionais para canais.
Início Rápido: Construa seu primeiro agente em menos de 5 minutos, registre ferramentas com @tool e explore a execução assíncrona.
Conceitos Fundamentais: Conheça os pilares da arquitetura: Agent, Runner, Engines, Tools, Memory e Handoffs.

Visão Geral da Documentação

Destaques da ArquiteturaCopy Anchor Link