官方插件 - Alibaba Cloud Model Studio

首次访问插件页面

如果您的主账号或RAM用户（子账号）从未授权过AliyunServiceRoleForSFMAccessCloudAPI角色权限，您将无法访问插件。请参考以下操作进行授权。

主账号
RAM用户（子账号）

如果您使用主账号登录阿里云百炼，请在插件页面，勾选同意上述条款，单击授权并进入。授权页面将创建服务关联角色 AliyunServiceRoleForSFMAccessCloudAPI，对应权限策略为 AliyunServiceRolePolicyForSFMAccessCloudAPI，用于授权百炼大模型平台访问您的阿里云市场商品清单并根据插件配置进行API调用。

如果您使用RAM用户（子账号）登录阿里云百炼，在插件页面，勾选同意上述条款，单击授权并进入时，会有如下提示：系统弹出云市场服务关联角色对话框，显示错误码 140052，服务关联角色名称为 AliyunServiceRoleForSFMAccessCloudAPI。这是因为该RAM用户（子账号）不具备创建服务关联角色的权限。请按照下述操作先授予RAM用户（子账号）创建服务关联角色的权限。获得授权后，RAM用户（子账号）即可进入插件页面。

授权RAM用户（子账号）创建服务关联角色的权限。
1. 使用主账号登录RAM控制台。
2. 在左侧导航栏，选择权限管理>权限策略。
3. 单击创建权限策略。
4. 在脚本编辑的Effect、Action、Resource、Condition中分别输入以下脚本中的对应内容。

{
    "Action": [
        "ram:CreateServiceLinkedRole"
    ],
    "Resource": "*",
    "Effect": "Allow",
    "Condition": {
        "StringEquals": {
            "ram:ServiceName": "cloundapi-access.sfm.aliyuncs.com"
        }
    }
}

单击确定。
设置权限策略名称，单击确定。例如，输入名称为服务关联角色。
在左侧导航栏，选择身份管理 > 用户。
找到待授权的RAM用户（子账号），单击RAM用户（子账号）操作列的添加权限。
在权限策略中选择刚才创建的权限策略，单击确认新增授权。至此，RAM用户（子账号）拥有了创建服务关联角色的权限。在策略类型下拉框中选择自定义策略进行筛选，即可找到并勾选目标权限策略。
返回插件页面，勾选同意上述条款，单击授权并进入。

官方插件说明

组件广场中预置了阿里云百炼的官方插件，您无需配置其输入和输出参数，即可直接调用。

官方插件名称	工具ID	说明	计费方案
Python Code Interpreter	code_interpreter	Python代码解释器，使大模型可以执行Python代码片段，例如数学计算、数据分析与可视化、数据处理。	免费
Calculator	calculator	计算器，使大模型可以进行复杂的数学计算，例如计算“12313x13232”。	免费
Image Generation	text_to_image	图片生成，使大模型可以基于文本生成图片，例如“请画一只在笑的小狗”。	限时免费，需申请开通

Python Code Interpreter

示例输入 无插件时输出 有插件时输出

示例输入	无插件时输出	有插件时输出
`import matplotlib.pyplot as plt import numpy as np x = np.linspace(-2, 2, 100) y1 = np.sqrt(1 + x2) y2 = -np.sqrt(1 + x2) plt.plot(x, y1, label='y = sqrt(1 + x^2)') plt.plot(x, y2, label='y = -sqrt(1 + x^2)') plt.xlabel('x') plt.ylabel('y') plt.title('Hyperbola') plt.legend() plt.show()`	大模型应用无法执行Python代码，只会针对代码进行语言描述。	大模型应用具备了执行Python代码的能力，能够对数据进行可视化分析。

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(-2, 2, 100)
y1 = np.sqrt(1 + x**2)
y2 = -np.sqrt(1 + x**2)

plt.plot(x, y1, label='y = sqrt(1 + x^2)')
plt.plot(x, y2, label='y = -sqrt(1 + x^2)')
plt.xlabel('x')
plt.ylabel('y')
plt.title('Hyperbola')
plt.legend()
plt.show()

大模型应用无法执行Python代码，只会针对代码进行语言描述。

大模型应用具备了执行Python代码的能力，能够对数据进行可视化分析。

Python代码解释器插件不支持对外访问网络以及上传本地文件，可用依赖：json5~=0.9.6、jupyter_client~=8.1.0、ipykernel~=6.25.0、seaborn、sympy、pydantic~=1.10.8、pillow~=9.4.0、fastapi~=0.101.1、dynaconf~=3.2.1、oss2~=2.18.1、matplotlib、starlette~=0.27.0、uvicorn~=0.23.2、requests~=2.31.0、scipy、html2text、matplotlib、pandas、pdf2image、pdfminer-six、pillow、pypdf、python-pptx、seaborn、sympy、wordcloud。

Calculator

示例输入	无插件时输出	有插件时输出
12313x13232	大模型应用无法准确计算复杂数学问题，会出现计算错误的情况。正确结果应为162,925,616。	大模型应用具备了良好的计算能力，能够生成准确的计算结果。

Image Generation

示例输入	无插件时输出	有插件时输出
请画一只在笑的小狗。	大模型应用无法直接绘制图片或图形，只能通过文字来描述画面。	大模型应用具备了直接绘制图片的能力，能够按指令生成小狗图片。
请画一只在笑的小狗。

组合使用插件

阿里云百炼支持在同一个任务中调用多个工具，您可以根据实际需求来选择插件。

调用官方插件

步骤一：在子业务空间调用官方插件时，需要先执行以下步骤为子业务空间授权。在默认业务空间调用官方插件不需要执行此步骤。

访问插件页面，找到需要授权的目标插件并单击查看详情。
单击授权，选择待授权的子业务空间，单击确定完成授权。

步骤二：调用插件。

调用插件

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

获取工具ID

工具ID用于标识具体的工具。通过API调用工具时，需要正确传递工具ID，以确保请求能够被正确识别。

在插件页面，找到目标插件并单击查看详情。
在插件工具下获取工具ID。此示例中，工具 ID 为 calculator。

​首次访问插件页面

​官方插件说明

​调用官方插件

​调用插件

​获取工具ID

​相关文档

首次访问插件页面

官方插件说明

调用官方插件

调用插件

获取工具ID

相关文档