Qwen-Agent工具系统详解：使用与开发指南

最新推荐文章于 2025-06-29 21:36:11 发布

霍美予Mabel

最新推荐文章于 2025-06-29 21:36:11 发布

阅读量403

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00342/article/details/148419246

Qwen-Agent工具系统详解：使用与开发指南

Qwen-Agent Agent framework and applications built upon Qwen, featuring Code Interpreter and Chrome browser extension. 项目地址: https://gitcode.com/gh_mirrors/qw/Qwen-Agent

工具系统概述

Qwen-Agent提供了一个强大的工具系统，允许开发者扩展模型的能力，使其能够执行特定任务。工具系统是Qwen-Agent架构中的关键组件，它使得语言模型能够与外部系统交互，完成诸如图像生成、代码执行等复杂操作。

工具使用详解

直接调用工具

在Qwen-Agent中，所有工具都通过统一的.call(params)接口进行调用。这种设计提供了简洁一致的调用方式：

from qwen_agent.tools import ImageGen

# 初始化图像生成工具
tool = ImageGen()

# 调用工具生成图片
res = tool.call(params={'prompt': '一只可爱的猫咪'})
print(res)

调用工具时需要注意：

参数必须按照工具定义的格式传递
返回值可能是字符串、列表或字典等类型
每个工具都有其特定的参数要求，需要查阅对应工具的文档

通过Agent调用工具

当工具集成到Agent中时，调用方式略有不同：

from qwen_agent.agents import Assistant

# 初始化Agent并指定可用工具
agent = Assistant(function_list=['code_interpreter', 'image_gen'])

# Agent会自动选择合适的工具处理请求
response = agent.run('请生成一张日落的图片')

Agent调用工具的特点：

使用_call_tool()内部方法调用工具
所有返回值都会被转换为字符串类型，便于语言模型处理
工具可以通过名称、配置或对象形式传入

工具开发指南

工具开发基础步骤

开发一个新工具需要遵循以下步骤：

定义工具名称和描述
声明工具参数
实现核心调用逻辑
注册工具(可选)

注册式开发示例

推荐使用装饰器注册工具，这种方式更加规范：

from qwen_agent.tools.base import BaseTool, register_tool

@register_tool('my_image_gen')
class MyImageGen(BaseTool):
    description = 'AI绘画服务，输入文本描述，返回根据文本生成的图片URL'
    parameters = [{
        'name': 'prompt',
        'type': 'string',
        'description': '图片内容的详细描述，建议使用英文',
        'required': True
    }]

    def call(self, params: str, **kwargs) -> str:
        # 实现具体的图像生成逻辑
        prompt = json5.loads(params)['prompt']
        encoded_prompt = urllib.parse.quote(prompt)
        return {
            'image_url': f'https://image.pollinations.ai/prompt/{encoded_prompt}'
        }

注册式开发的优势：

自动处理工具命名
便于工具的统一管理
支持通过名称快速调用

非注册式开发示例

也可以直接定义工具类而不注册：

class MyImageGen(BaseTool):
    name = 'my_image_gen'
    description = 'AI绘画服务...'
    parameters = [...]
    
    def call(self, params: str, **kwargs) -> str:
        # 工具实现逻辑
        ...

非注册式工具需要通过对象实例使用，不支持通过名称调用。