Merge pull request #311143 from v-albemi/sessions

denrea · web-flow · commit 531eb5b99c75 · 2026-02-20T09:52:52.000-08:00
Freshness Edit: Azure Container Apps
diff --git a/articles/container-apps/sessions-code-interpreter.md b/articles/container-apps/sessions-code-interpreter.md
@@ -1,11 +1,11 @@
 ---
-title: Serverless code interpreter sessions in Azure Container Apps
-description: Learn to run a serverless code interpreter session in Azure Container Apps.
+title: Serverless Code Interpreter Sessions in Azure Container Apps
+description: Learn how to run a serverless code interpreter session in Azure Container Apps.
 services: container-apps
 author: craigshoemaker
 ms.service: azure-container-apps
 ms.topic: how-to
-ms.date: 05/19/2025
+ms.date: 01/30/2026
 ms.update-cycle: 180-days
 ms.author: cshoe
 ms.custom: references_regions
@@ -14,91 +14,90 @@ ms.collection: ce-skilling-ai-copilot
 
 # Serverless code interpreter sessions in Azure Container Apps
 
-Azure Container Apps [dynamic sessions](sessions.md) provides fast and scalable access to a code interpreter. Each code interpreter session is fully isolated by a Hyper-V boundary and is designed to run untrusted code.
+Azure Container Apps [dynamic sessions](sessions.md) provide fast and scalable access to a code interpreter. Each code interpreter session is fully isolated by a Hyper-V boundary and is designed to run untrusted code.
 
 ## Uses for code interpreter sessions
 
-Code interpreter sessions are ideal for scenarios where you need to run code that is potentially malicious or could cause harm to the host system or other users, such as:
+Code interpreter sessions are ideal for scenarios where you need to run code that's potentially malicious or could cause harm to the host system or other users, such as:
 
 - Code generated by a large language model (LLM).
 - Code submitted by an end user in a web or SaaS application.
 
-For popular LLM frameworks such as LangChain, LlamaIndex, or Semantic Kernel, you can use [tools and plugins](#llm-framework-integrations) to integrate AI apps with code interpreter sessions.
+For popular LLM frameworks such as LangChain, LlamaIndex, and Semantic Kernel, you can use [tools and plugins](#llm-framework-integrations) to integrate AI apps with code interpreter sessions.
 
-Your applications can also integrate with code interpreter session using a [REST API](#management-api-endpoints). The API allows you to:
+Your applications can also integrate with code interpreter session by using a [REST API](#management-api-endpoints). The API enables you to:
 
-- Execute code in a session and retrieve results
+- Run code in a session and retrieve results.
 - Upload and download files to and from the session.
 
-    You can upload and download executable code files, or data files that your code can process.
+    You can upload and download executable code files or data files that your code can process.
 
-The built-in code interpreter sessions support the most common code execution scenarios without the need to manage infrastructure or containers.
+The built-in code interpreter sessions support the most common code execution scenarios without requiring you to manage infrastructure or containers.
 
 If you need full control over the code execution environment or have a different scenario that requires isolated sandboxes, you can use [custom code interpreter sessions](sessions-custom-container.md).
 
 ## Code interpreter session pool
 
 To use code interpreter sessions, you need an Azure resource called a [session pool](session-pool.md) that defines the configuration for code interpreter sessions.
 
-In the session pool, you can specify settings such as the maximum number of concurrent sessions and how long a session can be idle before the session is terminated.
+In the session pool, you can specify settings such as the maximum number of concurrent sessions and how long a session can be idle before the session is stopped.
 
-You can create a session pool using the Azure portal, Azure CLI, or Azure Resource Manager templates. After you create a session pool, you can use the pool's management API endpoints to manage and execute code inside a session.
+You can create a session pool by using the Azure portal, the Azure CLI, or Azure Resource Manager templates. After you create a session pool, you can use the pool's management API endpoints to manage and run code inside a session.
 
 For more information about how to create and configure a session pool, see [Use session pools](./session-pool.md).
 
 ## Code execution in a session
 
-After you create a session pool, your application can interact with sessions in the pool using an integration with an [LLM framework](#llm-framework-integrations) or by using the pool's [management API endpoints](#management-api-endpoints) directly.
+After you create a session pool, your application can interact with sessions in the pool by using an integration with an [LLM framework](#llm-framework-integrations) or by using the pool's [management API endpoints](#management-api-endpoints) directly.
 
 ## Session identifiers
 
 > [!IMPORTANT]
-> The session identifier is sensitive information which requires you to use a secure process to manage its value. Part of this process requires that your application ensures each user or tenant only has access to their own sessions.
+> The session identifier is sensitive information. You need to use a secure process to manage its value. Part of this process is to make sure that your application ensures each user or tenant only has access to their own sessions.
 >
 > Failure to secure access to sessions could result in misuse or unauthorized access to data stored in your users' sessions. For more information, see [Session identifiers](sessions-usage.md#identifiers).
 
-When you interact with sessions in a pool, you use a [session identifier](sessions-usage.md#identifiers) to reference each session A session identifier is a string that you define that is unique within the session pool. If you're building a web application, you can use the user's ID. If you're building a chatbot, you can use the conversation ID.
+When you interact with sessions in a pool, you use a [session identifier](sessions-usage.md#identifiers) to reference each session. A session identifier is a string that you define that's unique within the session pool. If you're building a web application, you can use the user's ID. If you're building a chatbot, you can use the conversation ID.
 
 If there's a running session with the identifier, the session is reused. If there's no running session with the identifier, a new session is automatically created.
 
 ## Authentication
 
-Authentication is handled using Microsoft Entra tokens. Valid Microsoft Entra tokens are generated by an identity belonging to the *Azure ContainerApps Session Executor* and *Contributor* roles on the session pool.
+Authentication is handled via Microsoft Entra tokens. Valid Microsoft Entra tokens are generated by an identity belonging to the *Azure ContainerApps Session Executor* and *Contributor* roles on the session pool.
 
-If you're using an LLM framework integration, the framework handles the token generation and management for you. Ensure that the application is configured with a managed identity with the necessary role assignments on the session pool.
+If you're using an LLM framework integration, the framework handles the token generation and management for you. Ensure that the application is configured with a managed identity that has the necessary role assignments on the session pool.
 
-If you're using the pool's management API endpoints directly, you must generate a token and include it in the `Authorization` header of your HTTP requests. In addition to the role assignments previously mentioned, token needs to contain an audience (`aud`) claim with the value `https://dynamicsessions.io`.
+If you're using the pool's management API endpoints directly, you must generate a token and include it in the `Authorization` header of your HTTP requests. In addition to the role assignments previously mentioned, token needs to contain an audience (`aud`) claim that has the value `https://dynamicsessions.io`.
 
-To learn more, see [Authentication and authorization](sessions-usage.md#authentication).
+For more information, see [Authentication and authorization](sessions-usage.md#authentication).
 
 ## Work with files
 
 You can upload and download files, and list all the files in a code interpreter session.
 
 ### Supported characters
 
-Filenames and path must use only the following supported characters:
+File names and paths must use only the following supported characters:
 
-- Uppercase and lowercase letters: `A-Z`, `a-z`
-- Digits: `0-9`
-- Special characters: `-`, `_`,` `, `.`, `@`, `$`, `&`, `=`, `;`, `,`, `#`, `%`, `^`, `(`, `)`
-- Unicode characters: Includes Chinese, Japanese, and other international characters
-- Path does not allow: `.`
+- Uppercase and lowercase letters: `A-Z`, `a-z`.
+- Digits: `0-9`.
+- Special characters: `-`, `_`,` `, `.`, `@`, `$`, `&`, `=`, `;`, `,`, `#`, `%`, `^`, `(`, `)`. (Paths can't contain `.`.)
+- Unicode characters: Includes Chinese, Japanese, and other international characters.
 
 ### Upload a file
 
-To upload a file to a session, send a `POST` request to the `uploadFile` endpoint in a multipart form data request. Include the file data in the request body. The file must include a filename.
+To upload a file to a session, send a `POST` request to the `uploadFile` endpoint in a multipart form data request. Include the file data in the request body. The file must include a file name.
 
-Uploaded files are stored in the session's file system under the `/mnt/data` directory.
+Uploaded files are stored in the session's file system in the `/mnt/data` directory.
 
 The following example shows how to upload a file to a session.
 
-Before you send the request, replace the placeholders between the `<>` brackets with values specific to your request.
+Before you send the request, replace the placeholders between the `<>` brackets with values that are specific to your request.
 
 ```http
 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>
+Authorization: Bearer <TOKEN>
 
 ------WebKitFormBoundary7MA4YWxkTrZu0gW
 Content-Disposition: form-data; name="file"; filename="<FILE_NAME_AND_EXTENSION>"
@@ -114,29 +113,29 @@ To download a file from a session's `/mnt/data` directory, send a `GET` request
 
 The following example demonstrates how to format a `GET` request to download a file.
 
-Before you send the request, replace the placeholders between the `<>` brackets with values specific to your request.
+Before you send the request, replace the placeholders between the `<>` brackets with values that are specific to your request.
 
 ```http
 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>
 ```
 
-### List the files
+### List files
 
 To list the files in a session's `/mnt/data` directory, send a `GET` request to the `files` endpoint.
 
-The following example shows you how to list the files in a session's directory.
+The following example shows how to list the files in a session's directory.
 
-Before you send the request, replace the placeholders between the `<>` brackets with values specific to your request.
+Before you send the request, replace the placeholders between the `<>` brackets with values that are specific to your request.
 
 ```http
 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>
 ```
 
-The response contains a list of files in the session.
+The response contains a list of the files in the session.
 
-The following listing shows a sample of the type of response you can expect from requesting session contents.
+The following listing shows a sample of the type of response you can expect when you request session contents.
 
 ```json
 {
@@ -166,11 +165,11 @@ The following listing shows a sample of the type of response you can expect from
 
 ## Security
 
-Code interpreter sessions are designed to run untrusted code in isolated environments, ensuring that your applications and data remain protected.
+Code interpreter sessions are designed to run untrusted code in isolated environments to ensure that your applications and data remain protected.
 
 ## LLM framework integrations
 
-Instead of using the session pool management API directly, the following LLM frameworks provide integrations with code interpreter sessions:
+Instead of using the session pool management API directly, you can use the following LLM frameworks, which provide integrations with code interpreter sessions.
 
 | Framework | Package | Tutorial |
 |-----------|---------|------------|
@@ -180,11 +179,11 @@ Instead of using the session pool management API directly, the following LLM fra
 
 ## Management API endpoints
 
-If you're not using an LLM framework integration, you can interact with the session pool directly using the [management API endpoints](session-pool.md#management-endpoint).
+If you're not using an LLM framework integration, you can interact with the session pool directly by using the [management API endpoints](session-pool.md#management-endpoint).
 
-## Execute code in a session
+## Run code in a session
 
-To execute code in a session, send a `POST` request to the `code/execute` endpoint with the code to run in the request body. Each code execution is limited to a maximum runtime of 220 seconds.
+To run code in a session, send a `POST` request to the `code/execute` endpoint with the code to run in the request body. Each code execution is limited to a maximum runtime of 220 seconds.
 
 The following example prints `Hello, world!` in Python.
 
@@ -193,7 +192,7 @@ Before you send the request, replace the placeholders between the `<>` brackets
 ```http
 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>
+Authorization: Bearer <TOKEN>
 
 {
     "properties": {
@@ -208,16 +207,16 @@ To reuse a session, specify the same session identifier in subsequent requests.
 
 #### Upload a file to a session
 
-To upload a file to a session, send a `POST` request to the `uploadFile` endpoint in a multipart form data request. Include the file data in the request body. The file must include a filename.
+To upload a file to a session, send a `POST` request to the `uploadFile` endpoint in a multipart form data request. Include the file data in the request body. The file must include a file name.
 
-Uploaded files are stored in the session's file system under the `/mnt/data` directory.
+Uploaded files are stored in the session's file system in the `/mnt/data` directory.
 
-Before you send the request, replace the placeholders between the `<>` brackets with values specific to your request.
+Before you send the request, replace the placeholders between the `<>` brackets with values that are specific to your request.
 
 ```http
 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>
+Authorization: Bearer <TOKEN>
 
 ------WebKitFormBoundary7MA4YWxkTrZu0gW
 Content-Disposition: form-data; name="file"; filename="<FILE_NAME_AND_EXTENSION>"
@@ -228,13 +227,13 @@ Content-Type: application/octet-stream
 ```
 
 > [!NOTE]
-> The file upload limit is `128MB`. If this is exceeded a `HTTP 413` may be returned.
+> The file upload limit is 128 MB. If this limit is exceeded, you might get an HTTP 413 error.
 
 #### Download a file from a session
 
 To download a file from a session's `/mnt/data` directory, send a `GET` request to the `file/content/{filename}` endpoint. The response includes the file data.
 
-Before you send the request, replace the placeholders between the `<>` brackets with values specific to your request.
+Before you send the request, replace the placeholders between the `<>` brackets with values that are specific to your request.
 
 ```http
 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>
@@ -245,7 +244,7 @@ Authorization: Bearer <TOKEN>
 
 To list the files in a session's `/mnt/data` directory, send a `GET` request to the `files` endpoint.
 
-Before you send the request, replace the placeholders between the `<>` brackets with values specific to your request.
+Before you send the request, replace the placeholders between the `<>` brackets with values that are specific to your request.
 
 ```http
 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>
@@ -254,7 +253,7 @@ Authorization: Bearer <TOKEN>
 
 The response contains a list of files in the session.
 
-The following listing shows a sample of the type of response you can expect from requesting session contents.
+Following is an example of the type of response you can expect when you request session contents.
 
 ```json
 {
@@ -284,11 +283,11 @@ The following listing shows a sample of the type of response you can expect from
 
 ## Preinstalled packages
 
-Python code interpreter sessions include popular Python packages such as *NumPy*, *pandas*, and *scikit-learn*.
+Python code interpreter sessions include popular Python packages such as NumPy, pandas, and scikit-learn.
 
 To output the list of preinstalled packages, call the `code/execute` endpoint with the following code.
 
-Before you send the request, replace the placeholders between the `<>` brackets with values specific to your request.
+Before you send the request, replace the placeholders between the `<>` brackets with values that are specific to your request.
 
 ```http
 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>
@@ -306,13 +305,13 @@ Authorization: Bearer <TOKEN>
 
 ## Logging
 
-Code interpreter sessions don't support logging directly. Your application that's interacting with the sessions can log requests to the session pool management API and its responses.
+Code interpreter sessions don't support logging directly. The application that's interacting with the sessions can log requests to the session pool management API and its responses.
 
 ## Billing
 
 Code interpreter sessions are billed based on the duration of each session. For more information, see [Billing](billing.md#dynamic-sessions).
 
-## Next steps
+## Next step
 
 > [!div class="nextstepaction"]
 > [Use code interpreter sessions with LangChain](./sessions-tutorial-langchain.md)
