Merge pull request #335 from Portkey-AI/azure-doc-new

Azure doc new stuff

Author: siddharthsambharia-portkey

integrations/agents/openai-agents.mdx

@@ -252,15 +252,16 @@ print(Runner.run_sync(agent, "Recursion haiku.").final_output)
 **Comparing the 3 approaches**
 
 | Strategy | Code Touchpoints | Best For |
-|----------|-----------------|----------|
+|:----------|:-----------------|:----------|
 | **Global Client** via `set_default_openai_client` | One-time setup; agents need only model names | Whole app uses Portkey; simplest migration |
 | **ModelProvider in RunConfig** | Add a provider + pass `run_config` | Toggle Portkey per run; A/B tests, staged rollouts |
 | **Explicit Model per Agent** | Specify `OpenAIChatCompletionsModel` in agent | Mixed fleet: each agent can talk to a different provider |
 
-<Accordion title="End-to-End Example: Research Agent with Tools">
-Here's a more comprehensive agent that can use tools to perform tasks:
+## End-to-End Example
 
-```python
+**Research Agent with Tools**: Here's a more comprehensive agent that can use tools to perform tasks.
+
+```python [expandable]
 from agents import Agent, Runner, Tool, set_default_openai_client
 from openai import AsyncOpenAI
 from portkey_ai import PORTKEY_GATEWAY_URL, createHeaders
@@ -325,7 +326,8 @@ print(result.final_output)
 ```
 
 Visit your Portkey dashboard to see the complete execution flow visualized!
-</Accordion>
+
+---
 
 ## Production Features
 

integrations/cloud/azure.mdx

@@ -1,69 +1,56 @@
 ---
 title: "Microsoft Azure"
-description: "End-to-end support for Azure's entire platform and AI ecosystem, all through Portkey."
+description: "Discover how you can build your Gen AI platform on Azure using Portkey"
 ---
 
-**Gen AI teams achieve 75% faster time-to-market Azure AI costs and 4× faster deployment** with Portkey's end-to-end Azure AI solution. Our dedicated platform bridges compliance and innovation gaps, bringing unified control to all your AI infrastructure while maintaining Azure's native security model.
+Portkey supercharges your Azure AI infrastructure with an enterprise-ready production stack. Teams building on Azure achieve **75% faster time-to-market**, **significant cost optimization**, and **4× faster deployments** while maintaining seamless integration with existing Azure investments. 
 
-<CTABanner title="Ready to optimize your Azure AI investment?" buttonText="Schedule a 30-min strategy call" href="#enterprise-demo" />
+Our solution empowers you to build robust, scalable AI applications that leverage the full security and compliance capabilities of Azure.
 
-# Build Enterprise-Grade GenAI on Azure
+**Key benefits for Azure AI teams:**
+- Accelerated development cycles with unified API access
+- Granular cost tracking and optimization for Azure AI services
+- Enhanced governance with centralized security controls
+- Simplified deployment and scaling of production AI applications
+- Full compatibility with Azure's native security model
 
+<Card title="Ready to optimize your Azure AI investment?" href="https://portkey.sh/azure">Schedule a 30-min strategy call</Card>
 
-
-
-## What You Can Do Today
+## What You Can Do Today with Portkey on Azure
 
 <CardGroup cols={2}>
 <Card title="1-Click Azure Marketplace Deploy" icon="rocket" href="https://azuremarketplace.microsoft.com/en-in/marketplace/apps/portkey.enterprise-saas?tab=Overview">
-Spin up a managed Portkey instance directly inside your Azure subscription.
+Spin up a managed Portkey instance directly inside your Azure subscription for maximum security and control.
 </Card>
-<Card title="SSO & SCIM with Microsoft Entra" icon="user-lock" href="/product/enterprise-offering/org-management/sso">
-Enterprise-grade identity and automated user provisioning out of the box.
+<Card title="SSO & SCIM with Microsoft Entra ID" icon="user-lock" href="/product/enterprise-offering/org-management/sso">
+Integrate seamlessly with your existing identity provider for enterprise-grade access control and automated user provisioning.
 </Card>
 <Card title="Unified Access to Azure OpenAI" icon="brain" href="/integrations/llms/azure-openai">
-Route chat, vision, function-calling and image requests through Portkey while retaining Azure compliance.
+Route all your Azure OpenAI requests (chat, vision, function-calling, DALL-E images) through Portkey while retaining full Azure compliance and gaining enhanced observability.
 </Card>
-<Card title="Azure AI Foundry Models" icon="flask" href="/integrations/llms/azure-foundry">
-Bring any model deployed via AI Foundry under the same gateway, with caching, retries & observability.
+<Card title="Azure AI Foundry Models Integration" icon="flask" href="/integrations/llms/azure-foundry">
+Bring any model deployed via Azure AI Studio (formerly AI Foundry) under the Portkey gateway for consistent caching, retries, fallbacks, and observability.
 </Card>
 <Card title="Azure Content Safety Guardrails" icon="shield-check" href="/product/guardrails/azure-guardrails">
-Apply robust content moderation & PII detection to every request — no code changes required.
+Apply robust, configurable content moderation and PII detection to every AI request—no code changes required in your applications.
 </Card>
-<Card title="OpenAI C# SDK & Semantic Kernel" icon="code">
-Keep using familiar Microsoft tooling while Portkey handles routing, cost attribution and guardrails.
+<Card title="Full Support for OpenAI C# SDK & Semantic Kernel" icon="code" href="/api-reference/sdk/c-sharp">
+Developers can continue using familiar Microsoft tooling. Portkey transparently adds value by handling routing, cost attribution, observability, and guardrails.
 </Card>
-<Card title="Native Azure API Management" icon="plug">
-Expose Portkey configs as APIM endpoints for consistent governance across all your APIs.
+<Card title="Native Azure API Management (APIM) Integration" icon="plug">
+Expose Portkey configurations as APIM endpoints, ensuring consistent governance and policies across all your APIs, not just AI.
 </Card>
 </CardGroup>
 
-## Why Enterprises Choose Portkey on Azure
-
-<Mermaid>
-graph LR
-A[All Azure AI Usage] --> B[Portkey Gateway]
-B --> C[Per-app Budgets & Cost Attribution]
-C --> D[Centralised Guardrails & Observability]
-D --> E[Actionable Insights & ROI]
-</Mermaid>
-
-1. **Full Cost Attribution** – Tag requests by application, environment or user and export detailed metrics to Azure Monitor or your data warehouse.  
-2. **Governance at Scale** – Enforce organisation-wide guardrails, rate limits and SSO policies across every workspace.  
-3. **Zero-Trust Security** – Secrets remain in Azure Key Vault; traffic never leaves Azure’s backbone when you deploy via Marketplace or Private Cloud.  
-4. **Faster Developer Velocity** – A single gateway layer means no more per-team Azure OpenAI subscriptions or duplicated infrastructure.
-
 ## Get Started in Minutes
 
-1. **Deploy from the Azure Marketplace** and choose your subscription.  
-2. **Connect Entra SSO & SCIM** using our [SSO guide](/product/enterprise-offering/org-management/sso) and [Azure SCIM setup](/product/enterprise-offering/org-management/scim/azure-ad).  
-3. **Add Virtual Keys** for your Azure OpenAI or AI Foundry resources.  
-4. **Enable Azure Content Safety Guardrails** within your Portkey Config.  
-5. **Instrument your code** with the SDK of your choice.
+1.  **Deploy from the Azure Marketplace**: Launch Portkey directly within your Azure subscription.
+2.  **Connect Microsoft Entra ID for SSO & SCIM**: Follow our [SSO guide](/product/enterprise-offering/org-management/sso) and [Azure SCIM setup](/product/enterprise-offering/org-management/scim/azure-ad).
+3.  **Create Virtual Keys in Portkey**: Link your Azure OpenAI resources or Azure AI Foundry model deployments.
+4.  **Enable Azure Content Safety Guardrails**: Configure content filters within your Portkey Configs.
+5.  **Instrument Your Applications**: Use your preferred SDK (like the C# example below) to route requests through Portkey.
 
-<Tabs>
-<Tab title="C#">
-```csharp
+```csharp C# [expandable]
 using OpenAI;
 using OpenAI.Chat;
 using System;
@@ -163,8 +150,31 @@ public class ExampleAzureIntegration
     }
 }
 ```
-</Tab>
-</Tabs>
+
+## Why Portkey + Azure? The Strategic Advantages
+
+Enterprises choose to combine Portkey with Microsoft Azure to gain a competitive edge in their AI development. This powerful synergy offers:
+
+
+```mermaid
+flowchart LR
+    A[Your Azure AI Services\nOpenAI, Foundry, etc.] --> B[Portkey AI Gateway]
+    B --> C[Unified Observability\n& Cost Control]
+    B --> D[Centralized Guardrails\n& Security]
+    B --> E[Enhanced Reliability\n& Performance]
+    B --> F[Accelerated Development\nCycles]
+    C --> G[Actionable Insights &\nROI on Azure Spend]
+    D --> G
+    E --> G
+    F --> G
+```
+
+
+1.  **Complete Cost Visibility & Control on Azure Spend**: Go beyond standard Azure billing. Portkey allows you to tag every AI request (by application, environment, user, or custom dimension) and export granular metrics to Azure Monitor or your data warehouse for precise cost attribution and budget management.
+2.  **Unified Governance & Security Across Your Azure AI Landscape**: Enforce organization-wide policies consistently. From robust content moderation with Azure Content Safety to PII detection, rate limits, and SSO via Microsoft Entra ID, Portkey centralizes governance across all your Azure AI services and Portkey workspaces.
+3.  **Fortified Security with Azure-Native Integration**: Leverage Azure's robust security model. With Portkey's Azure Marketplace deployment or Private Cloud options, secrets remain securely in Azure Key Vault, and AI traffic can be configured to never leave Azure’s backbone, ensuring compliance and data integrity.
+4.  **Boosted Developer Velocity & Efficiency**: Eliminate redundant setups and streamline AI development. Portkey provides a single, consistent gateway layer, removing the need for per-team Azure OpenAI subscriptions or duplicated infrastructure, allowing your teams to build faster.
+5.  **Seamless Integration with the Azure Ecosystem**: Portkey is built for Azure. Enjoy native support for Azure OpenAI (chat, vision, function-calling, images), Azure AI Foundry Models, and even familiar Microsoft tooling like the OpenAI C# SDK and Semantic Kernel, all while Portkey handles the complexities of routing, cost attribution, and guardrails.
 
 ## Book an Enterprise Demo
 <Frame>