ConnectOnion

ConnectOnion é um framework de agente de IA para Python, poderoso e simples, construído sobre a filosofia de "Manter as coisas simples, simples, e tornar as coisas complicadas possíveis". Ele permite que os desenvolvedores entreguem agentes de IA funcionais em minutos, em vez de dias, reduzindo drasticamente o código repetitivo. O conceito central é direto: um agente de IA é criado combinando um prompt em Markdown com funções Python que atuam como ferramentas. Essa abordagem permite a criação de um assistente útil com uma ferramenta de calculadora em apenas 8 linhas de código, uma tarefa que pode exigir cerca de 50 linhas em outros frameworks populares como o LangChain.

Como usar ConnectOnion

Começar a usar o ConnectOnion é projetado para ser rápido e intuitivo.
1. Instalação: Comece instalando o framework via pip: pip install connectonion.
2. Criação de Projeto: Use a CLI integrada para criar um novo projeto com co create my-agent. Este comando configura automaticamente a estrutura do projeto, incluindo um arquivo de agente de exemplo, um arquivo de ambiente para chaves de API e a documentação completa do framework para assistentes de IA.
3. Definir Componentes: Em seu script Python, defina um prompt (por exemplo, "Você é um assistente prestativo") e as funções Python que servirão como ferramentas do agente (por exemplo, uma função `calculate`).
4. Criar Agente: Instancie o agente com agent = Agent(prompt, tools=[your_function]).
5. Interagir: Use o agente chamando o método .input(), como result = agent.input("Quanto é 42 * 17?").
Para um fluxo de trabalho ainda mais rápido, o ConnectOnion promove o "Vibe Coding", onde você pode colar toda a documentação em um assistente de codificação de IA como o Cursor, descrever o agente que você precisa e deixar a IA gerar o código completo.

Recursos principais do ConnectOnion

• Sintaxe Minimalista: Reduz a complexidade do código em até 85%, permitindo a criação de agentes em apenas algumas linhas.
• Markdown + Funções = Agente: Um modelo intuitivo onde os prompts são escritos em Markdown e as ferramentas são funções Python padrão.
• CLI Poderosa: Uma interface de linha de comando (co) para criação rápida de projetos, gerenciamento de ambiente e melhores práticas integradas.
• Vibe Coding: Um método de desenvolvimento rápido usando assistentes de IA como o Cursor para escrever código ConnectOnion perfeito, fornecendo a eles a documentação do framework.
• Depuração Integrada: O decorador @xray fornece insights em tempo real, rastreamento de iterações e métricas de desempenho para ver exatamente o que um agente está fazendo.
• Registro Automático: Toda interação do agente é registrada automaticamente para fácil monitoramento e revisão.
• Ferramentas com Estado: Suporta tanto funções simples sem estado quanto ferramentas complexas baseadas em classes com estado (por exemplo, uma classe `Browser` para automação web).
• Geração Automática de Esquemas: Converte automaticamente as dicas de tipo do Python em esquemas de função compatíveis com a OpenAI, eliminando a escrita manual de esquemas.

Casos de uso para ConnectOnion

O ConnectOnion é versátil e pode ser usado para construir uma ampla gama de agentes de IA, incluindo:
Agentes de Tarefas Simples: Crie agentes para tarefas específicas como cálculos matemáticos, como mostrado nos exemplos básicos.
Web Scrapers e Pesquisadores: Construa agentes que podem extrair conteúdo de URLs, extrair links e coletar informações da web. A CLI inclui um template `web-research`.
Bots de Automação: Desenvolva agentes para automação web usando o template Playwright, que inclui ferramentas pré-construídas para iniciar um navegador, navegar em páginas, preencher formulários и tirar screenshots.
Assistentes de E-mail: Gere agentes capazes de enviar notificações por e-mail com base em gatilhos ou condições específicas.
Agentes Personalizados Gerados por IA: Use o recurso de template personalizado alimentado por IA da CLI para descrever um agente desejado (por exemplo, "um agente que monitora repositórios do GitHub para novas issues"), e a CLI gerará o projeto completo.

Vantagens do ConnectOnion

A principal vantagem do ConnectOnion é sua simplicidade e velocidade radicais. Ao abstrair a complexidade e eliminar o código repetitivo, ele permite que os desenvolvedores se concentrem na lógica central de seus agentes. Isso leva a um ciclo de desenvolvimento significativamente mais rápido. O framework é amigável para iniciantes, com complexidade de configuração zero, e poderoso o suficiente para aplicações prontas para produção. Sua abordagem inovadora de "Vibe Coding" aproveita o poder dos assistentes de IA modernos, acelerando ainda mais o desenvolvimento. As ferramentas integradas de depuração e registro fornecem visibilidade e controle de nível profissional sobre o comportamento do agente.

Preços e planos

Com base na documentação fornecida, o ConnectOnion é uma biblioteca Python gratuita e de código aberto. É instalado usando `pip`, e não há menção de preços, planos ou licenças comerciais. Os usuários podem começar a construir imediatamente sem nenhum custo associado ao framework em si.

Perguntas frequentes (FAQ)

O que é ConnectOnion?

ConnectOnion é um framework Python minimalista para construir agentes de IA. Sua filosofia central é simplificar o processo de desenvolvimento, permitindo a criação de agentes poderosos com o mínimo de código repetitivo, combinando prompts em Markdown com funções Python como ferramentas.

O ConnectOnion é gratuito?

Sim, a documentação indica que o ConnectOnion é uma biblioteca gratuita e de código aberto. Pode ser instalado diretamente do Python Package Index (PyPI) usando `pip install connectonion`, e não há menção de custos ou planos pagos.

Como o ConnectOnion reduz o código em comparação com outros frameworks?

O ConnectOnion abstrai a configuração complexa exigida por outros frameworks. Ele lida automaticamente com a geração de esquemas a partir de dicas de tipo e fornece uma classe `Agent` simples. Isso resulta na criação de um agente funcional em apenas 8 linhas de código, em comparação com aproximadamente 50 linhas para um agente semelhante em frameworks como o LangChain, representando uma redução de 85% no código repetitivo.

O que é "Vibe Coding"?

"Vibe Coding" é um fluxo de trabalho de desenvolvimento promovido pelo ConnectOnion. Envolve fornecer a documentação completa do framework a um assistente de codificação de IA (como o Cursor). O desenvolvedor então descreve o agente desejado em linguagem natural, e o assistente de IA gera o código ConnectOnion completo e correto, permitindo prototipagem e desenvolvimento extremamente rápidos.

Como posso depurar um agente construído com ConnectOnion?

O ConnectOnion inclui uma ferramenta de depuração integrada chamada `@xray`. Ao aplicar este decorador às suas funções de ferramenta (por exemplo, `@xray def my_tool(...)`), você pode obter insights detalhados e em tempo real sobre a execução do agente, incluindo qual ferramenta está sendo chamada, a tarefa original do usuário e o número da iteração atual.

Que tipo de ferramentas um agente pode usar?

Um agente pode usar qualquer função Python como ferramenta. O ConnectOnion também suporta ferramentas com estado, permitindo que você passe uma instância de classe inteira para o agente. Quando uma instância de classe é fornecida, o ConnectOnion descobre automaticamente todos os seus métodos públicos com dicas de tipo e os torna disponíveis como ferramentas para o agente, o que é ideal para tarefas complexas como automação de navegador da web.