Azure Container Apps 中的無伺服器程式代碼解釋器會話

Azure 容器應用程式動態工作階段可讓您以快速且可調整的方式存取程式碼解譯器。每個程式碼解譯器工作階段都會透過 Hyper-V 界限來完全隔離，其設計目的是為了執行不受信任的程式碼。

用於程式碼解譯器工作階段

程式碼解譯器工作階段非常適合以下案例：您需要執行可能有惡意，或可能會對主機系統或其他使用者造成傷害的程式碼，例如：

大型語言模型 (LLM) 所產生的程式碼。
由終端使用者在 Web 或 SaaS 應用程式中提交的程式碼。

對於 LangChain、LlamaIndex 或 Semantic Kernel 等熱門 LLM 架構，您可以使用工具和外掛程式來整合 AI 應用程式與程式碼解譯器工作階段。

您的應用程式也可以使用 REST API 與程式碼解譯器工作階段整合。 API 可讓您：

在工作階段中執行程式碼並擷取結果
上傳和下載會話中的檔案。

您可以上傳和下載可執行的程式碼檔案，或您的程式碼可以處理的資料檔案。

內建程式碼解譯器工作階段支援最常見的程式碼執行案例，而不需要管理基礎結構或容器。

如果您需要完全控制程式碼執行環境，或是您有需要隔離沙箱的不同案例，則可以使用自訂程式碼解譯器工作階段。

程式碼解譯器工作階段集區

若要使用程式代碼解釋器會話，您需要稱為會話集區的 Azure 資源，以定義程式代碼解釋器會話的組態。

在該工作階段集區中，您可以指定各項設定，例如並行工作階段數目上限，以及工作階段要閒置多久才加以終止。

您可以使用 Azure 入口網站、Azure CLI 或 Azure Resource Manager 範本來建立工作階段集區。建立工作階段集區之後，您可以使用集區的管理 API 端點來管理和執行工作階段內的程式碼。

如需如何建立和設定會話集區的詳細資訊，請參閱使用會話集區。

工作階段中的程式碼執行

在建立工作階段集區之後，您的應用程式可以透過與 LLM 架構的整合，或藉由直接使用集區的管理 API 端點，來與集區中的工作階段互動。

工作階段識別碼

重要

工作階段識別項是敏感性資訊，因此您必須使用安全的程序來管理其值。此程序有一部分需要您的應用程式確保每個使用者或租用戶只能存取其自己的工作階段。

無法保護會話存取的安全，可能會導致濫用或未經授權存取儲存在您用戶會話中的數據。如需詳細資訊，請參閱會話標識符。

當您與集區中的會話互動時，您會使用會話標識符來參考每個會話。會話標識符是您在會話集區中定義的唯一字串。如果您要建置 Web 應用程式，可以使用使用者的識別碼。如果您要建置聊天機器人，可以使用交談識別碼。

如果有具有該識別項的執行中工作階段，系統會重複使用該工作階段。如果沒有具有該識別項的執行中工作階段，則系統會自動建立新的工作階段。

驗證

驗證是使用 Microsoft Entra 令牌來處理。有效的 Microsoft Entra 權杖是由屬於工作階段集區上「Azure ContainerApps 工作階段執行者」和「參與者」角色的身分識別所產生。

如果您使用 LLM 架構整合，架構會為您處理權杖產生和管理。確定應用程式會使用對工作階段集區具有必要角色指派的受控識別進行設定。

如果您是直接使用集區的管理 API 端點，則必須產生權杖，並將其包含在 HTTP 要求的 Authorization 標頭中。除了先前提及的角色指派之外，權杖還需要包含值為 aud 的對象( https://dynamicsessions.io) 宣告。

若要深入瞭解，請參閱驗證和授權。

處理檔案

您可以上傳和下載檔案，並列出程式代碼解釋器會話中的所有檔案。

上傳檔案

若要將檔案上傳至工作階段，請將 POST 要求傳送至多部分表單資料中的 uploadFile 端點。在要求本文中包含檔案資料。檔案必須包含檔案名稱。

所上傳的檔案會儲存在工作階段檔案系統的 /mnt/data 目錄底下。

下列範例示範如何將檔案上傳至會話。

在傳送要求之前，請將 <> 括弧之間的預留位置取代為您要求特有的值。

POST https://<REGION>.dynamicsessions.io/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/sessionPools/<SESSION_POOL_NAME>/files/upload?api-version=2024-02-02-preview&identifier=<SESSION_ID>
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
Authorization: Bearer <token>

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="<FILE_NAME_AND_EXTENSION>"
Content-Type: application/octet-stream

(data)
------WebKitFormBoundary7MA4YWxkTrZu0gW--

下載檔案

若要從工作階段的 /mnt/data 目錄中下載檔案，請將 GET 要求傳送至 file/content/{filename} 端點。回應會包含檔案資料。

下列範例示範如何格式化 GET 要求以下載檔案。

在傳送要求之前，請將 <> 括弧之間的預留位置取代為您要求特有的值。

GET https://<REGION>.dynamicsessions.io/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/sessionPools/<SESSION_POOL_NAME>/files/content/<FILE_NAME_AND_EXTENSION>?api-version=2024-02-02-preview&identifier=<SESSION_ID>
Authorization: Bearer <TOKEN>

列出檔案

若要列出工作階段 /mnt/data 目錄中的檔案，請將 GET 要求傳送至 files 端點。

下列範例示範如何列出會話目錄中的檔案。

在傳送要求之前，請將 <> 括弧之間的預留位置取代為您要求特有的值。

GET https://<REGION>.dynamicsessions.io/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/sessionPools/<SESSION_POOL_NAME>/files?api-version=2024-02-02-preview&identifier=<SESSION_ID>
Authorization: Bearer <TOKEN>

回應會包含工作階段中的檔案清單。

下列清單會顯示在要求工作階段內容時應該會有的回應類型範例。

{
    "$id": "1",
    "value": [
        {
            "$id": "2",
            "properties": {
                "$id": "3",
                "filename": "test1.txt",
                "size": 16,
                "lastModifiedTime": "2024-05-02T07:21:07.9922617Z"
            }
        },
        {
            "$id": "4",
            "properties": {
                "$id": "5",
                "filename": "test2.txt",
                "size": 17,
                "lastModifiedTime": "2024-05-02T07:21:08.8802793Z"
            }
        }
    ]
}

安全

程式代碼解釋器會話的設計目的是在隔離的環境中執行不受信任的程式碼，以確保您的應用程式和數據保持保護。

LLM 架構整合

下列 LLM 架構會提供與程式碼解譯器工作階段的整合，而不是直接使用工作階段集區管理 API：

架構	套件	教學課程
LangChain	Python： `langchain-azure-dynamic-sessions`	教學課程
LlamaIndex	Python： `llama-index-tools-azure-code-interpreter`	教學課程
語意核心	Python：`semantic-kernel` (0.9.8-b1 版或更新版本)	教學課程

管理 API 端點

如果您未使用 LLM 架構整合，您可以使用管理 API 端點直接與工作階段集區互動。

在工作階段中執行程式碼

若要在工作階段中執行程式碼，請將 POST 要求傳送至 code/execute 端點，並附上要在要求本文中執行的程式碼。

下列範例會在 Python 中列印 Hello, world!。

在傳送要求之前，請將 <> 括弧之間的預留位置取代為工作階段集區和工作階段識別項的適當值。

POST https://<REGION>.dynamicsessions.io/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/sessionPools/<SESSION_POOL_NAME>/code/execute?api-version=2024-02-02-preview&identifier=<SESSION_ID>
Content-Type: application/json
Authorization: Bearer <token>

{
    "properties": {
        "codeInputType": "inline",
        "executionType": "synchronous",
        "code": "print('Hello, world!')"
    }
}

若要重複使用工作階段，請在後續要求中指定相同的工作階段識別項。

將檔案上傳至工作階段

若要將檔案上傳至工作階段，請將 POST 要求傳送至多部分表單資料中的 uploadFile 端點。在要求本文中包含檔案資料。檔案必須包含檔案名稱。

所上傳的檔案會儲存在工作階段檔案系統的 /mnt/data 目錄底下。

在傳送要求之前，請將 <> 括弧之間的預留位置取代為您要求特有的值。

POST https://<REGION>.dynamicsessions.io/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/sessionPools/<SESSION_POOL_NAME>/files/upload?api-version=2024-02-02-preview&identifier=<SESSION_ID>
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
Authorization: Bearer <token>

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="<FILE_NAME_AND_EXTENSION>"
Content-Type: application/octet-stream

(data)
------WebKitFormBoundary7MA4YWxkTrZu0gW--

注意

檔案上傳限制為 128MB。如果超過 HTTP 413 這個值，可能會傳回。

從工作階段中下載檔案

若要從工作階段的 /mnt/data 目錄中下載檔案，請將 GET 要求傳送至 file/content/{filename} 端點。回應會包含檔案資料。

在傳送要求之前，請將 <> 括弧之間的預留位置取代為您要求特有的值。

GET https://<REGION>.dynamicsessions.io/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/sessionPools/<SESSION_POOL_NAME>/files/content/<FILE_NAME_AND_EXTENSION>?api-version=2024-02-02-preview&identifier=<SESSION_ID>
Authorization: Bearer <TOKEN>

列出工作階段中的檔案

若要列出工作階段 /mnt/data 目錄中的檔案，請將 GET 要求傳送至 files 端點。

在傳送要求之前，請將 <> 括弧之間的預留位置取代為您要求特有的值。

GET https://<REGION>.dynamicsessions.io/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/sessionPools/<SESSION_POOL_NAME>/files?api-version=2024-02-02-preview&identifier=<SESSION_ID>
Authorization: Bearer <TOKEN>

回應會包含工作階段中的檔案清單。

下列清單會顯示在要求工作階段內容時應該會有的回應類型範例。

{
    "$id": "1",
    "value": [
        {
            "$id": "2",
            "properties": {
                "$id": "3",
                "filename": "test1.txt",
                "size": 16,
                "lastModifiedTime": "2024-05-02T07:21:07.9922617Z"
            }
        },
        {
            "$id": "4",
            "properties": {
                "$id": "5",
                "filename": "test2.txt",
                "size": 17,
                "lastModifiedTime": "2024-05-02T07:21:08.8802793Z"
            }
        }
    ]
}

已預先安裝的套件

Python 程式代碼解釋器會話包含熱門的 Python 套件，例如 NumPy、 pandas 和 scikit-learn。

若要輸出已預先安裝之套件的清單，請使用下列程式碼呼叫 code/execute 端點。

在傳送要求之前，請將 <> 括弧之間的預留位置取代為您要求特有的值。

POST https://<REGION>.dynamicsessions.io/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/sessionPools/<SESSION_POOL_NAME>/identifier/<SESSION_ID>/code/execute?api-version=2024-02-02-preview&identifier=<SESSION_ID>
Content-Type: application/json
Authorization: Bearer <TOKEN>

{
    "properties": {
        "codeInputType": "inline",
        "executionType": "synchronous",
        "code": "import pkg_resources\n[(d.project_name, d.version) for d in pkg_resources.working_set]"
    }
}

記錄

程式代碼解釋器會話不支援直接記錄。與會話互動的應用程式可以將要求記錄至會話集區管理 API 及其回應。

計費

程式代碼解釋器會話是根據每個會話的持續時間計費。如需詳細資訊，請參閱帳單。

下一步

搭配 LangChain 使用程式代碼解釋器會話

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-05-20

共用方式為

Azure Container Apps 中的無伺服器程式代碼解釋器會話

用於程式碼解譯器工作階段

程式碼解譯器工作階段集區

工作階段中的程式碼執行

工作階段識別碼

驗證

處理檔案

上傳檔案

下載檔案

列出檔案

安全

LLM 架構整合

管理 API 端點

在工作階段中執行程式碼

將檔案上傳至工作階段

從工作階段中下載檔案

列出工作階段中的檔案

已預先安裝的套件

記錄

計費

下一步

意見反應

其他資源