Qwen-Agent

Descrição

Qwen-Agent é um framework poderoso e open-source projetado para o desenvolvimento de aplicações sofisticadas de Large Language Model (LLM). Construído sobre as capacidades dos modelos Qwen versão 3.0 e posteriores, ele fornece uma base robusta para a criação de agentes inteligentes que podem entender instruções, utilizar ferramentas, planejar tarefas complexas e manter memória entre interações. O framework é projetado para ser modular, oferecendo componentes atômicos como LLMs com chamada de função e Ferramentas versáteis que podem ser estendidas. Componentes de alto nível como Agentes, derivados de uma classe base, permitem que os desenvolvedores criem implementações de agentes personalizadas.

As principais funcionalidades do Qwen-Agent incluem suporte para Chamada de Função (Function Calling), permitindo que os agentes interajam com serviços e APIs externas. Ele também integra um Interpretador de Código (Code Interpreter), que permite aos agentes executar código de forma segura dentro de um ambiente sandbox baseado em Docker, processar dados e retornar resultados. A Geração Aumentada por Recuperação (Retrieval-Augmented Generation - RAG) é suportada, aprimorando a capacidade do agente de acessar e sintetizar informações de grandes conjuntos de documentos. O framework também apresenta suporte ao Protocolo de Conversa Multi-turno (Multi-turn Conversation Protocol - MCP), facilitando fluxos de diálogo mais naturais e complexos. Aplicações de exemplo como Browser Assistant, Code Interpreter e Custom Assistant são fornecidas, demonstrando a versatilidade do framework.

Qwen-Agent é ativamente utilizado como backend para Qwen Chat, demonstrando sua aplicabilidade no mundo real. O framework é projetado para desenvolvedores que buscam construir aplicações de IA avançadas, desde chatbots simples até sistemas complexos que exigem integração de ferramentas e raciocínio. Sua extensibilidade permite a criação de ferramentas e comportamentos de agente personalizados, atendendo a uma ampla gama de casos de uso. O projeto também fornece documentação e exemplos abrangentes para facilitar a adoção e o desenvolvimento.

O processo de instalação é direto, com opções para instalar a partir do PyPI com conjuntos de recursos específicos como GUI, RAG ou Code Interpreter, ou para instalar diretamente do código fonte para a versão de desenvolvimento mais recente. Os usuários podem aproveitar os serviços de modelo da DashScope da Alibaba Cloud ou implantar seus próprios serviços de modelo usando modelos Qwen open-source. A flexibilidade do framework se estende à configuração de parâmetros de LLM e à integração com vários métodos de implantação, incluindo vLLM para implantação de GPU de alta vazão e Ollama para implantação local de CPU/GPU.

Recursos principais de Qwen-Agent

• Framework de Agente para aplicações LLM

• Construído sobre modelos Qwen>=3.0

• Suporta Chamada de Função (Tool Calling)

• Inclui Interpretador de Código com sandbox Docker

• Geração Aumentada por Recuperação (RAG) integrada

• Suporta Protocolo de Conversa Multi-turno (MCP)

• Fornece aplicações de exemplo (Browser Assistant, Custom Assistant)

• Componentes modulares para LLMs e Ferramentas

• Permite implementação de agente personalizada

• Oferece uma interface GUI baseada em Gradio

• Suporta chamadas de ferramenta paralelas e multi-etapas

• Lida com perguntas e respostas sobre documentos de longo contexto

Primeiros passos com Qwen-Agent

1. 1

   Clonar repositório: Obtenha o código Qwen-Agent do GitHub.

2. 2

   Instalar dependências: Use pip para instalar o pacote com os recursos desejados (ex: `pip install -U "qwen-agent[gui,rag,code_interpreter,mcp]"`).

3. 3

   Configurar serviço de modelo: Configure a chave API do DashScope ou implante um serviço de modelo local.

4. 4

   Desenvolver agente: Crie agentes personalizados herdando de `Agent` ou use implementações integradas como `Assistant`.

5. 5

   Integrar ferramentas: Defina e registre ferramentas personalizadas ou use as integradas como `code_interpreter`.

6. 6

   Executar agente: Execute o agente programaticamente ou inicie a GUI Gradio.

7. 7

   Interagir: Envie consultas para o agente e receba respostas.

Casos de uso de Qwen-Agent

• Desenvolvimento de Assistente Personalizado
• Execução e Análise de Código
• Respostas a Perguntas sobre Documentos
• Automação de Navegador
• Integração de Ferramentas
• Planejamento de Tarefas Complexas
• Backend de Chatbot de IA

Perguntas frequentes de Qwen-Agent

• O que é Qwen-Agent?

  Qwen-Agent é um framework open-source para construir aplicações LLM, utilizando modelos Qwen para capacidades como chamada de função, interpretação de código e RAG.

• Quais são as principais funcionalidades do Qwen-Agent?

  As principais funcionalidades incluem chamada de função, interpretador de código, RAG, suporte a MCP, integração de ferramentas personalizadas e aplicações de exemplo como Browser Assistant.

• Como instalo o Qwen-Agent?

  Você pode instalar o Qwen-Agent usando pip: `pip install -U "qwen-agent[gui,rag,code_interpreter,mcp]"` ou instalar a partir do código fonte.

• O Qwen-Agent pode usar ferramentas personalizadas?

  Sim, o Qwen-Agent permite que os desenvolvedores definam e registrem ferramentas personalizadas herdando de `BaseTool`.

• Como funciona a ferramenta Code Interpreter?

  A ferramenta Code Interpreter é implementada usando contêineres Docker locais para execução segura de código dentro de um ambiente sandbox isolado.

• Quais modelos LLM são suportados pelo Qwen-Agent?

  Qwen-Agent é construído sobre modelos Qwen versão 3.0 e posteriores, e também pode se integrar a serviços de modelo compatíveis com a API OpenAI.

• Como posso usar o Qwen-Agent para responder perguntas sobre documentos longos?

  Qwen-Agent oferece uma solução RAG rápida e um agente competitivo para responder perguntas sobre documentos super longos, superando modelos de contexto longo nativos.

• O Qwen-Agent suporta chamada de função?

  Sim, o Qwen-Agent fornece capacidades de chamada de função, e suas classes de agente são construídas sobre essa funcionalidade, suportando chamadas de função paralelas.

• Como configuro o LLM para o Qwen-Agent?

  A configuração do LLM é feita através de um dicionário (`llm_cfg`) especificando o nome do modelo, tipo, chave API e hiperparâmetros de geração opcionais.

• O que é MCP no contexto do Qwen-Agent?

  MCP significa Multi-turn Conversation Protocol (Protocolo de Conversa Multi-turno), que o Qwen-Agent suporta para facilitar fluxos de diálogo mais complexos e naturais.

• Existe uma GUI disponível para o Qwen-Agent?

  Sim, o Qwen-Agent fornece uma interface GUI conveniente usando Gradio, permitindo a implantação rápida de demonstrações de agentes.

• Quais são as dependências para usar MCP?

  As dependências para MCP incluem Node.js, uv 0.4.18+, Git e SQLite. As instruções de instalação são fornecidas para macOS e Windows.