官方外掛程式 - 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

相關文檔