microsoft · LarryOsterman · Jul 28, 2026 · Jul 15, 2026 · Jul 15, 2026 · Jul 15, 2026
@@ -97,6 +97,7 @@ with ConversationAnalysisClient(endpoint, credential) as client:
     )
 
     print(f"Top intent: {result['result']['prediction']['topIntent']}")
+```
 
 ## Reference Files
 

@@ -45,7 +45,7 @@ from azure.identity import DefaultAzureCredential, ManagedIdentityCredential
 from azure.ai.projects import AIProjectClient
 
 # Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=<specific_credential>
-credential = DefaultAzureCredential(require_envvar=True)
+credential = DefaultAzureCredential()
 # Or use a specific credential directly in production:
 # See https://learn.microsoft.com/python/api/overview/azure/identity-readme?view=azure-python#credential-classes
 # credential = ManagedIdentityCredential()
@@ -115,7 +115,7 @@ agent = client.agents.create_agent(
 ### Create Agent with Tools
 
 ```python
-from azure.ai.agents import CodeInterpreterTool, FileSearchTool
+from azure.ai.agents.models import CodeInterpreterTool, FileSearchTool
 
 agent = client.agents.create_agent(
     model=os.environ["AZURE_AI_MODEL_DEPLOYMENT_NAME"],

@@ -215,7 +215,7 @@ run = project_client.agents.runs.create_and_process(
 ### Streaming Run
 
 ```python
-from azure.ai.agents import AgentEventHandler
+from azure.ai.agents.models import AgentEventHandler
 
 class MyHandler(AgentEventHandler):
     def on_message_delta(self, delta):

@@ -50,7 +50,7 @@ from azure.identity import DefaultAzureCredential, ManagedIdentityCredential
 from azure.ai.translation.document import DocumentTranslationClient
 
 # Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=<specific_credential>
-credential = DefaultAzureCredential(require_envvar=True)
+credential = DefaultAzureCredential()
 # Or use a specific credential directly in production:
 # See https://learn.microsoft.com/python/api/overview/azure/identity-readme?view=azure-python#credential-classes
 # credential = ManagedIdentityCredential()
@@ -83,32 +83,45 @@ with DocumentTranslationClient(
 ## Basic Document Translation
 
 ```python
-from azure.ai.translation.document import DocumentTranslationInput, TranslationTarget
+import os
+from azure.ai.translation.document import DocumentTranslationClient, DocumentTranslationInput, TranslationTarget
+from azure.core.exceptions import HttpResponseError
+from azure.identity import DefaultAzureCredential
 
-source_url = os.environ["AZURE_SOURCE_CONTAINER_URL"]
-target_url = os.environ["AZURE_TARGET_CONTAINER_URL"]
+credential = DefaultAzureCredential()
 
-# Start translation job
-poller = client.begin_translation(
-    inputs=[
-        DocumentTranslationInput(
-            source_url=source_url,
-            targets=[
-                TranslationTarget(
-                    target_url=target_url,
-                    language="es"  # Translate to Spanish
+with DocumentTranslationClient(
+    endpoint=os.environ["AZURE_DOCUMENT_TRANSLATION_ENDPOINT"],
+    credential=credential,
+) as client:
+    source_url = os.environ["AZURE_SOURCE_CONTAINER_URL"]
+    target_url = os.environ["AZURE_TARGET_CONTAINER_URL"]
+
+    try:
+        # Start translation job
+        poller = client.begin_translation(
+            inputs=[
+                DocumentTranslationInput(
+                    source_url=source_url,
+                    targets=[
+                        TranslationTarget(
+                            target_url=target_url,
+                            language="es"  # Translate to Spanish
+                        )
+                    ]
                 )
             ]
         )
-    ]
-)
 
-# Wait for completion
-result = poller.result()
+        # Wait for completion
+        result = poller.result()
 
-print(f"Status: {poller.status()}")
-print(f"Documents translated: {poller.details.documents_succeeded_count}")
-print(f"Documents failed: {poller.details.documents_failed_count}")
+        print(f"Status: {poller.status()}")
+        print(f"Documents translated: {poller.details.documents_succeeded_count}")
+        print(f"Documents failed: {poller.details.documents_failed_count}")
+    except HttpResponseError as e:
+        print(f"Translation failed: {e.message}")
+        raise
 ```
 
 ## Multiple Target Languages

@@ -42,18 +42,12 @@ AZURE_TOKEN_CREDENTIALS=prod # Required only if DefaultAzureCredential is used i
 > Snippets may abbreviate this setup, but production code should always follow both rules.
 
 ```python
-from azure.identity import DefaultAzureCredential, ManagedIdentityCredential
+from azure.identity import DefaultAzureCredential
 from azure.mgmt.apimanagement import ApiManagementClient
 import os
 
-# Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=<specific_credential>
-credential = DefaultAzureCredential(require_envvar=True)
-# Or use a specific credential directly in production:
-# See https://learn.microsoft.com/python/api/overview/azure/identity-readme?view=azure-python#credential-classes
-# credential = ManagedIdentityCredential()
-
 with ApiManagementClient(
-    credential=credential,
+    credential=DefaultAzureCredential(),
     subscription_id=os.environ["AZURE_SUBSCRIPTION_ID"]
 ) as client:
     # Use `client` for all subsequent operations (see examples below)

@@ -53,17 +53,26 @@ configure_azure_monitor(
 # Your application code...
 ```
 
-## Explicit Configuration
+## Explicit Connection String
+
+Pass the connection string explicitly by reading it from the environment variable.
+The value includes both `InstrumentationKey` and `IngestionEndpoint`.
 
 ```python
-from azure.identity import DefaultAzureCredential
+import os
 from azure.monitor.opentelemetry import configure_azure_monitor
 
-# Reads APPLICATIONINSIGHTS_CONNECTION_STRING from env to identify the resource;
-# DefaultAzureCredential authenticates ingestion via Microsoft Entra ID.
-configure_azure_monitor(
-    credential=DefaultAzureCredential(),
-)
+# Read the full connection string from the environment.
+# Format: "InstrumentationKey=<key>;IngestionEndpoint=https://<id>.in.applicationinsights.azure.com/"
+connection_string = os.environ["APPLICATIONINSIGHTS_CONNECTION_STRING"]
+
+try:
+    configure_azure_monitor(
+        connection_string=connection_string,
+    )
+    # Your application code...
+except Exception as exc:
+    raise RuntimeError(f"Azure Monitor configuration failed: {exc}") from exc
 ```
 
 ## With Flask
@@ -204,8 +213,8 @@ configure_azure_monitor(
 from azure.monitor.opentelemetry import configure_azure_monitor
 from azure.identity import DefaultAzureCredential, ManagedIdentityCredential
 
-# Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=<specific_credential>
-credential = DefaultAzureCredential(require_envvar=True)
+# Local dev: DefaultAzureCredential. In production, set AZURE_TOKEN_CREDENTIALS=prod or use a specific credential.
+credential = DefaultAzureCredential()
 # Or use a specific credential directly in production:
 # See https://learn.microsoft.com/python/api/overview/azure/identity-readme?view=azure-python#credential-classes
 # credential = ManagedIdentityCredential()

@@ -6,7 +6,7 @@ This index maps hero scenarios in `SKILL.md` and links non-hero scenarios docume
 
 ## Hero scenarios covered in SKILL.md
 
-- `Explicit Configuration`
+- `Explicit Connection String`
 - `With Flask`
 - `With Django`
 - `With FastAPI`

@@ -99,10 +99,14 @@ print(result["DisplayText"])
 
 ```python
 # WAV PCM 16kHz
-"Content-Type": "audio/wav; codecs=audio/pcm; samplerate=16000"
+wav_headers = {
+    "Content-Type": "audio/wav; codecs=audio/pcm; samplerate=16000"
+}
 
 # OGG OPUS
-"Content-Type": "audio/ogg; codecs=opus"
+ogg_headers = {
+    "Content-Type": "audio/ogg; codecs=opus"
+}
 ```
 
 ## Response Formats

@@ -44,7 +44,12 @@ async def list_items() -> list[Item]:
 
 ```python
 @router.post("/items", status_code=status.HTTP_201_CREATED)
+async def create_item(item: ItemCreate) -> Item:
+  ...
+
 @router.delete("/items/{id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_item(id: str) -> None:
+  ...
 ```
 
 ## Integration Steps

@@ -2,6 +2,11 @@
 {{ResourceName}} Router
 
 Handles CRUD operations for {{resource_name}} resources.
+
+Template placeholders to replace:
+- {{ResourceName}} (PascalCase)
+- {{resource_name}} (snake_case)
+- {{resource_plural}} (plural snake_case)
 """
 
 from typing import Optional

@@ -30,19 +30,23 @@ Copy the template from [assets/template.py](assets/template.py) and replace plac
 ## camelCase Aliases
 
 ```python
+from datetime import datetime
+
+from pydantic import BaseModel, ConfigDict, Field
+
 class MyModel(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
     workspace_id: str = Field(..., alias="workspaceId")
     created_at: datetime = Field(..., alias="createdAt")
-
-    class Config:
-        populate_by_name = True  # Accept both snake_case and camelCase
 ```
 
 ## Optional Update Fields
 
 ```python
 class MyUpdate(BaseModel):
-    """All fields optional for PATCH requests."""
+    model_config = ConfigDict(populate_by_name=True)
+
     name: Optional[str] = Field(None, min_length=1)
     description: Optional[str] = None
 ```
@@ -51,7 +55,6 @@ class MyUpdate(BaseModel):
 
 ```python
 class MyInDB(MyResponse):
-    """Adds doc_type for Cosmos DB queries."""
     doc_type: str = "my_resource"
 ```
-Original file line number
+Diff line change
@@ Expand Up @@
         )
         print(f"Top intent: {result['result']['prediction']['topIntent']}")
+    ```
     ## Reference Files
@@ Expand Down @@