Claude in Microsoft Foundry

​

預覽

​

先決條件

• 有效的 Azure 訂閱
• 存取 Foundry
• 已安裝 Azure CLI（選擇性，用於資源管理）

​

安裝 SDK

# Python
pip install -U "anthropic"

# Typescript
npm install @anthropic-ai/foundry-sdk

​

佈建

​

佈建 Foundry 資源

1. 導覽至 Foundry 入口網站
2. 建立新的 Foundry 資源或選擇現有資源
3. 使用 Azure 發行的 API 金鑰或 Entra ID 設定存取管理以進行角色型存取控制
4. 選擇性地將資源設定為私人網路 (Azure 虛擬網路) 的一部分以增強安全性
5. 記下您的資源名稱—您將在 API 端點中使用此作為 {resource}（例如 https://{resource}.services.ai.azure.com/anthropic/v1/*）

​

建立 Foundry 部署

1. 在 Foundry 入口網站中，導覽至您的資源
2. 前往模型 + 端點並選擇**+ 部署模型** > 部署基礎模型
3. 搜尋並選擇 Claude 模型（例如 claude-sonnet-4-5）
4. 設定部署設定：
   • 部署名稱：預設為模型 ID，但您可以自訂它（例如 my-claude-deployment）。部署名稱在建立後無法變更。
   • 部署類型：選擇全球標準（建議用於 Claude）
5. 選擇部署並等待佈建完成
6. 部署後，您可以在金鑰和端點下找到您的端點 URL 和金鑰

​

身份驗證

​

API 金鑰身份驗證

1. 在 Foundry 入口網站中導覽至您的資源
2. 前往金鑰和端點部分
3. 複製提供的 API 金鑰之一
4. 在您的請求中使用 api-key 或 x-api-key 標頭

import os
from anthropic import AnthropicFoundry

client = AnthropicFoundry(
    api_key=os.environ.get("ANTHROPIC_FOUNDRY_API_KEY"),
    resource_name="{resource}",
)

message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content)

​

Microsoft Entra 身份驗證

1. 為您的 Foundry 資源啟用 Entra 身份驗證
2. 從 Entra ID 取得存取權杖
3. 在 Authorization: Bearer {TOKEN} 標頭中使用權杖

import os
from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

# 使用權杖提供者模式取得 Azure Entra ID 權杖
token_provider = get_bearer_token_provider(
    DefaultAzureCredential(),
    "https://cognitiveservices.azure.com/.default"
)

# 使用 Entra ID 身份驗證建立用戶端
client = AnthropicFoundry(
    resource_name="{resource}",  # 您的 Azure 資源名稱
    azure_ad_token_provider=token_provider  # 使用權杖提供者進行 Entra ID 身份驗證
)

# 發出請求
message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content)

​

安裝 SDK

# Python
pip install -U "anthropic"

# Typescript
npm install @anthropic-ai/foundry-sdk

​

模型參數和部署

# 如果您已建立名為 "my-claude-deployment" 的自訂部署
message = client.messages.create(
    model="my-claude-deployment",  # 您的自訂部署名稱
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)

​

相關請求 ID

​

支援的功能

​

不支援的功能

• 管理員 API（/v1/organizations/* 端點）
• 模型 API（/v1/models）
• 訊息批次 API（/v1/messages/batches）

​

API 回應

​

API 模型 ID 和部署

​

監控和記錄

• Azure Monitor：追蹤 API 使用情況、延遲和錯誤率
• Azure Log Analytics：查詢和分析請求/回應日誌
• 成本管理：監控和預測與 Claude 使用相關的成本

​

疑難排解

​

身份驗證錯誤

• 解決方案：驗證您的 API 金鑰是否正確。您可以從 Azure 入口網站中 Claude 資源的金鑰和端點下取得新的 API 金鑰。
• 解決方案：如果使用 Azure Entra ID，請確保您的存取權杖有效且未過期。權杖通常在 1 小時後過期。

• 解決方案：您的 Azure 帳戶可能缺少必要的權限。確保您已分配適當的 Azure RBAC 角色（例如「認知服務 OpenAI 使用者」）。

​

速率限制

• 解決方案：您已超過速率限制。在應用程式中實施指數退避和重試邏輯。
• 解決方案：考慮透過 Azure 入口網站或 Azure 支援請求提高速率限制。

​

速率限制標頭

​

模型和部署錯誤

• 解決方案：驗證您使用的是正確的部署名稱。如果您尚未建立自訂部署，請使用預設模型 ID（例如 claude-sonnet-4-5）。
• 解決方案：確保模型/部署在您的 Azure 區域中可用。

• 解決方案：模型參數應包含您的部署名稱，可在 Foundry 入口網站中自訂。驗證部署存在且配置正確。

​

其他資源

• Foundry 文件：ai.azure.com/catalog
• Azure 定價：azure.microsoft.com/en-us/pricing
• Anthropic 定價詳情：定價文件
• 身份驗證指南：請參閱上面的身份驗證部分
• Azure 入口網站：portal.azure.com