翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

WorkSpaces (Anthropic 互換)

Amazon Bedrock WorkSpaces は、bedrock-mantleエンドポイントの Anthropic 互換 Messages API を使用して、生成 AI ワークロードのアプリケーションレベルの分離を提供します。WorkSpaces を使用すると、AI アプリケーションをセグメント化し、コスト追跡、オブザーバビリティ、アクセスコントロールを行うことができます。

WorkSpace とは

Workspace は、Anthropic Messages API を使用するときに Amazon Bedrock 内のアプリケーション、環境、実験などのワークロードを分離するために使用される論理的な境界です。WorkSpaces は と同じ基盤となるリソースですプロジェクト (OpenAI 互換)。WorkSpaces は Projects API を使用して管理され、同じ機能を提供します。

WorkSpaces を使用すると、個別の AWS アカウントや組織を作成することなく、本番環境で複数の生成 AI ワークロードを管理できるため、セキュリティとガバナンスを維持しながら運用の複雑さを軽減できます。

各 AWS アカウントには、すべての推論リクエストが関連付けられているデフォルトのワークスペース (プロジェクト) があります。プロジェクト API を使用して追加のワークスペースを作成し、 anthropic-workspaceヘッダーを使用して Messages API リクエストで参照できます。

WorkSpaces を使用するタイミング

以下の必要がある場合は、WorkSpaces を使用する必要があります。

WorkSpaces とプロジェクト

WorkSpaces と プロジェクト (OpenAI 互換)は同じ基盤となるリソースであり、どちらも Projects API を介して管理されます。違いは、使用する API に応じて、推論リクエストでそれらを参照する方法です。

WorkSpaces の開始方法

このセクションでは、ワークスペースの作成、Messages API リクエストとの関連付け、セットアップの検証について説明します。

前提条件

開始する前に、以下があることを確認してください。

ステップ1: 環境の構築

Amazon Bedrock 認証情報を使用して環境変数を設定します。

export BEDROCK_API_KEY="<your-bedrock-key>"
export BEDROCK_REGION="us-east-1"

ステップ 2: ワークスペースを作成する

WorkSpaces は、Projects API を使用して作成されます。コストモニタリング用の名前とタグを使用してワークスペース (プロジェクト) を作成します。

curl -X POST "https://bedrock-mantle.$BEDROCK_REGION.api.aws/v1/organization/projects" \
  -H "Authorization: Bearer $BEDROCK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Claude Chatbot Production",
    "tags": {
      "Application": "CustomerChatbot",
      "Environment": "Production",
      "Team": "NLPEngineering",
      "CostCenter": "41250"
    }
  }'

レスポンス:

{
  "arn": "arn:aws:bedrock-mantle:us-east-1:123456789012:project/proj_abc123def456",
  "created_at": 1772135628,
  "id": "proj_abc123def456",
  "name": "Claude Chatbot Production",
  "object": "organization.project",
  "status": "active",
  "tags": {
    "Application": "CustomerChatbot",
    "Environment": "Production",
    "Team": "NLPEngineering",
    "CostCenter": "41250"
  }
}

id フィールドに注意してください。これは、 anthropic-workspaceヘッダーで渡す値です。

ステップ 3: リクエストを Workspace に関連付ける

Messages API リクエストをワークスペースに関連付けるには、 anthropic-workspaceヘッダーをプロジェクト ID に含めます。

curl

curl -X POST "https://bedrock-mantle.$BEDROCK_REGION.api.aws/anthropic/v1/messages" \
  -H "x-api-key: $BEDROCK_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-workspace: proj_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic.claude-sonnet-4-6-v1",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, how can you help me today?"}
    ]
  }'

Python (Anthropic SDK)

import anthropic

client = anthropic.Anthropic(
    base_url=f"https://bedrock-mantle.{region}.api.aws/anthropic",
    api_key=bedrock_api_key,
)

response = client.messages.create(
    model="anthropic.claude-sonnet-4-6-v1",
    max_tokens=1024,
    extra_headers={"anthropic-workspace": "proj_abc123def456"},
    messages=[
        {"role": "user", "content": "Hello, how can you help me today?"}
    ]
)

print(response.content[0].text)

同じワークスペース ID で行われたすべての推論リクエストがグループ化され、ワークスペースごとのコスト追跡、アクセスコントロール、オブザーバビリティが可能になります。

ステップ 4: Workspace の設定を確認する

すべてのワークスペース (プロジェクト) を一覧表示して、ワークスペースが正常に作成されたことを確認します。

curl -X GET "https://bedrock-mantle.$BEDROCK_REGION.api.aws/v1/organization/projects" \
  -H "Authorization: Bearer $BEDROCK_API_KEY"

WorkSpaces の管理

WorkSpaces は Projects API を介して管理されるため、すべてのプロジェクト管理オペレーションが適用されます。以下の詳細な手順プロジェクト作業については、「」を参照してください。

ベストプラクティス

推奨される Workspace 構造

アプリケーションごとに 1 つのワークスペース: 個別のアプリケーションまたはサービスごとに個別のワークスペースを作成します。

├── Claude-Chatbot-Production
├── Claude-Chatbot-Staging
├── Claude-Chatbot-Development
├── Claude-Summarizer-Production
└── Claude-Summarizer-Development

WorkSpace ライフサイクル管理