Skip to main content
插件

官方和第三方插件

大模型本身虽然具备强大的自然语言处理能力,但在特定领域或特定任务上,可能需要额外的功能辅助(如联网搜索实时信息、图像处理等)。阿里云百炼提供了一系列官方插件和三方插件。您可以根据具体需求选择适合的插件,进一步增强大模型功能,扩展其应用场景。

首次访问插件页面

如果您的主账号或 RAM 用户(子账号)从未授权过 AliyunServiceRoleForSFMAccessCloudAPI 角色权限,您将无法访问插件。请参考以下操作进行授权。
如果您使用主账号登录阿里云百炼,请在插件页面,勾选同意上述条款,单击**进入插件广场**。

授权页面将创建服务关联角色 AliyunServiceRoleForSFMAccessCloudAPI,对应权限策略为 AliyunServiceRolePolicyForSFMAccessCloudAPI,用于授权百炼大模型平台访问您的阿里云市场商品清单并根据插件配置进行 API 调用。

官方插件说明

组件广场中预置了阿里云百炼的官方插件,您无需配置其输入和输出参数,即可直接调用。
官方插件名称工具 ID说明计费方案
Python 代码解释器code_interpreter使大模型可以执行 Python 代码片段,例如数学计算、数据分析与可视化、数据处理。免费
计算器calculator使大模型可以进行复杂的数学计算,例如计算"12313x13232"。免费
图片生成text_to_image使大模型可以基于文本生成图片,例如"请画一只在笑的小狗"。限时免费,需申请开通
夸克搜索quark_search使大模型可以搜索实时信息,查找公开的网络知识和信息,例如"杭州今天天气如何"。夸克搜索插件目前支持检索出网页标题、关键词和摘要,但不支持直接访问网页详情。限时免费,需申请开通
生成二维码generate_qrcode使大模型可以根据网站链接地址生成二维码。免费
GitHub 搜索github_search使大模型可以在 GitHub 中搜索相关项目列表,例如"GitHub搜索:千问"。免费
Python 代码解释器插件不支持对外访问网络以及上传本地文件。

调用官方插件

步骤一:在子业务空间调用官方插件时,需要先执行以下步骤为子业务空间授权。在默认业务空间调用官方插件不需要执行此步骤。
  1. 访问插件页面,找到需要授权的目标插件并单击查看详情
  2. 单击授权,选择待授权的子业务空间,单击确定完成授权。
步骤二:调用插件。

三方插件说明

第三方插件涵盖了商业服务、图像视频、学习教育等多个领域,并且经过了效果测试,您可以在开通后直接调用,无需进行额外配置。

调用三方插件

步骤一:开通三方插件。
  1. 访问插件页面,找到目标插件并单击查看详情
  2. 选择套餐,单击免费试用立即购买,根据界面指引开通插件。开通成功后,插件详情卡片中将显示已开通状态标签。
步骤二:调用插件。

调用插件

  • 方式一:在插件页面,将工具添加至智能体应用。
    官方插件只能与位于相同的业务空间里的智能体应用关联。
    1. 找到目标插件,单击添加到智能体
    2. 选择工具,单击下一步
    3. 选择智能体应用,单击确认添加
    4. 在应用详情页面,您可以看到工具已经自动添加。您也可以单击选择插件,继续添加其他工具。最多支持添加 10 个工具。
    5. 在输入框中与大模型进行对话,测试工具的使用效果是否符合预期。
    6. 测试完成后,发布应用。
  • 方式二:访问应用管理页面,在指定智能体或工作流应用内,添加指定插件,测试插件使用效果,并发布应用。具体操作请参见智能体应用插件能力、工作流应用插件节点。
  • 方式三:通过 Assistant API 调用工具。请在 Assistant API 文档中搜索 tools 关键字,查看如何使用 Assistant API 调用工具。

获取工具 ID

工具 ID 用于标识具体的工具。通过 API 调用工具时,需要正确传递工具 ID,以确保请求能够被正确识别。
  1. 插件页面,找到目标插件并单击查看详情
  2. 插件工具下获取工具 ID。

常见问题

夸克搜索和联网搜索(enable_search)有什么区别?
  • 开启夸克搜索插件时,模型将直接调用插件执行搜索,并将搜索结果以文本形式返回,这些结果可以直接用于生成最终输出。夸克搜索插件目前支持检索出网页标题、关键词和摘要,但不支持直接访问网页详情。
  • 联网搜索(enable_search)也是基于夸克搜索。联网搜索开启后,模型会尝试利用互联网上的信息来丰富其生成的内容,但不会完全依赖或返回互联网搜索结果。

相关文档

除了官方插件和三方插件外,百炼还支持用户引入自定义插件,具体操作请参见自定义插件