Azure Container Apps でのサーバーレスコードインタープリターセッション

2025-05-21

Azure Container Apps の動的セッションでは、コードインタープリターへの高速でスケーラブルなアクセスが提供されます。各コードインタープリターセッションは、Hyper-V 境界によって完全に分離され、信頼されていないコードを実行するように設計されています。

コードインタープリターセッション用に使用する

コードインタープリターセッションは、悪意のある可能性がある、またはホストシステムや他のユーザーに損害を与える可能性があるコードを実行する必要がある、次のようなシナリオに最適です。

大規模言語モデル (LLM) によって生成されたコード。
エンドユーザーが Web または SaaS アプリケーションで送信したコード。

LangChain、LlamaIndex、セマンティックカーネルなどの一般的な LLM フレームワークの場合、ツールとプラグインを使用して AI アプリをコードインタープリターセッションと統合できます。

作成中のアプリケーションは、REST API を使用してコードインタープリターセッションと統合することもできます。 API を使用すると、次のことができます。

セッションでコードを実行し、結果を取得する
セッションとの間でファイルをアップロードおよびダウンロードします。

実行可能なコードファイル、またはコードで処理できるデータファイルをアップロードおよびダウンロードできます。

組み込みのコードインタープリターセッションは、インフラストラクチャまたはコンテナーを管理する必要なく、最も一般的なコード実行シナリオをサポートします。

コード実行環境を完全に制御する必要がある場合、または分離されたサンドボックスを必要とする別のシナリオがある場合は、カスタムコードインタープリターセッションを使用できます。

コードインタープリターセッションプール

コードインタープリターセッションを使用するには、コードインタープリターセッションの構成を定義するセッションプールと呼ばれる Azure リソースが必要です。

セッションプールでは、同時セッションの最大数や、セッションが終了するまでのセッションのアイドル時間などの設定を指定できます。

セッションプールは、Azure portal、Azure CLI、または Azure Resource Manager テンプレートを使用して作成できます。セッションプールを作成したら、プールの管理 API エンドポイントを使用して、セッション内でコードを管理および実行できます。

セッションプールを作成および構成する方法の詳細については、「セッションプールを使用する」を参照してください。

セッションでのコード実行

セッションプールを作成したら、作成中のアプリケーションは、LLM フレームワークとの統合を使用するか、プールの管理 API エンドポイントを直接使用して、プール内のセッションと対話できます。

セッション識別子

重要

セッション識別子は機密情報であり、セキュリティで保護されたプロセスを使ってその値を管理する必要があります。このプロセスの一部として、アプリケーションで確実に、各ユーザーまたはテナントがそれ自身のセッションにしかアクセスできないようにする必要があります。

セッションへのアクセスをセキュリティで保護しないと、ユーザーのセッションに格納されているデータへの誤用または未承認のアクセスが発生する可能性があります。詳細については、「セッション識別子」を参照してください。

プール内のセッションを操作する場合は、セッション識別子を使用して各セッションを参照します。セッション識別子は、セッションプール内で一意である定義した文字列です。 Web アプリケーションを構築している場合は、ユーザーの ID を使用できます。チャットボットを構築している場合は、会話 ID を使用できます。

識別子を持つ実行中のセッションがある場合は、セッションが再利用されます。識別子を持つ実行中のセッションがない場合は、新しいセッションが自動的に作成されます。

認証

認証は Microsoft Entra トークンを使用して処理されます。有効な Microsoft Entra トークンは、セッションプール上の Azure ContainerApps Session Executor および "共同作成者" ロールに属する ID によって生成されます。

LLM フレームワーク統合を使用している場合、フレームワークはトークンの生成と管理を自動的に処理します。アプリケーションが、セッションプールで必要なロールの割り当てを持つマネージド ID で構成されていることを確認します。

プールの管理 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	ニシキヘビ： `langchain-azure-dynamic-sessions`	チュートリアル
LlamaIndex（ラマインデックス）	ニシキヘビ： `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!')"
    }
}

セッションを再利用するには、後続の要求で同じセッション識別子を指定します。

セッションにファイルをアップロードする

アップロードされたファイルは、セッションのファイルシステムの /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 が返される可能性があります。

セッションからファイルをダウンロードする

要求を送信する前に、<> 角かっこの間のプレースホルダーを、要求に固有の値に置き換えます。

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 コードインタープリターセッションには、 NumPy、 pandas、 scikit-learn などの一般的な Python パッケージが含まれます。

プレインストール済みのパッケージの一覧を出力するには、次のコードを使用して 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 でコードインタープリターセッションを使用する

次の方法で共有

Azure Container Apps でのサーバーレス コード インタープリター セッション

コード インタープリター セッション用に使用する

コード インタープリター セッション プール

セッションでのコード実行

セッション識別子

認証

ファイルを操作する

ファイルをアップロードする

ファイルをダウンロードする

ファイルを一覧表示する

安全

LLM フレームワークの統合

管理 API エンドポイント

セッションでコードを実行する

セッションにファイルをアップロードする

セッションからファイルをダウンロードする

セッション内のファイルを一覧表示する

プレインストール済みのパッケージ

ログ記録

請求

次のステップ

フィードバック

その他のリソース

Azure Container Apps でのサーバーレスコードインタープリターセッション

コードインタープリターセッション用に使用する

コードインタープリターセッションプール