翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# WorkSpaces (Anthropic 互換)
Amazon Bedrock WorkSpaces は、`bedrock-mantle`エンドポイントの Anthropic 互換 Messages API を使用して、生成 AI ワークロードのアプリケーションレベルの分離を提供します。WorkSpaces を使用すると、AI アプリケーションをセグメント化し、コスト追跡、オブザーバビリティ、アクセスコントロールを行うことができます。
**注記**
WorkSpaces は、`bedrock-mantle`エンドポイントで Messages API をサポートするモデルでのみ使用できます。Messages API をサポートするモデルを確認するには、「」を参照してください[Amazon Bedrock でサポートされている APIs](apis.md)。
OpenAI 互換 APIs (応答 API、チャット完了) を使用している場合は、[プロジェクト (OpenAI 互換)](projects.md)代わりに を使用します。
## WorkSpace とは
Workspace は、Anthropic Messages API を使用するときに Amazon Bedrock 内のアプリケーション、環境、実験などのワークロードを分離するために使用される論理的な境界です。WorkSpaces は と同じ基盤となるリソースです[プロジェクト (OpenAI 互換)](projects.md)。WorkSpaces は Projects API を使用して管理され、同じ機能を提供します。
+ **アクセス分離**: [Amazon Bedrock プロジェクトの IAM ポリシー](security-iam-projects.md)を使用して特定のワークスペースリソースにアクセスできるユーザーを制御する
+ **コストモニタリング**: [AWS タグ](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/what-are-tags.html)と [AWS Cost Explorer](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-what-is.html) を使用してワークスペースレベルで支出を追跡する
+ **オブザーバビリティ**: ワークスペースあたりの使用状況メトリクスとパターンを追跡して、モニタリングと最適化を行います。
WorkSpaces を使用すると、個別の AWS アカウントや組織を作成することなく、本番環境で複数の生成 AI ワークロードを管理できるため、セキュリティとガバナンスを維持しながら運用の複雑さを軽減できます。
各 AWS アカウントには、すべての推論リクエストが関連付けられているデフォルトのワークスペース (プロジェクト) があります。プロジェクト API を使用して追加のワークスペースを作成し、 `anthropic-workspace`ヘッダーを使用して Messages API リクエストで参照できます。
## WorkSpaces を使用するタイミング
以下の必要がある場合は、WorkSpaces を使用する必要があります。
+ **ビジネス構造別に整理**する: ビジネスユニット、チーム、アプリケーション、コストセンターなどの組織の分類に基づいて Amazon Bedrock の使用を管理します。
+ **コストを正確に追跡**する: 特定のチーム、プロジェクト、または環境に AI 支出をモニタリングして割り当てる
+ **アクセスポリシーを適用する**: 詳細な IAM アクセス許可を適用して、特定の AI ワークロードにアクセスできるユーザーを制御する
+ **本番ワークロードのスケーリング**: 運用上の境界とモニタリングを明確にして複数の本番アプリケーションを実行する
## WorkSpaces とプロジェクト
WorkSpaces と [プロジェクト (OpenAI 互換)](projects.md)は同じ基盤となるリソースであり、どちらも Projects API を介して管理されます。違いは、使用する API に応じて、推論リクエストでそれらを参照する方法です。
| 機能 | WorkSpaces | プロジェクト |
| --- | --- | --- |
| サポートされている API | Anthropic Messages API | OpenAI 互換 APIs (応答、チャット完了) |
| Endpoint | bedrock-mantle.{region}.api.aws/anthropic/v1/messages | bedrock-mantle.{region}.api.aws/v1 |
| ヘッダー | anthropic-workspace: {project-id} | OpenAI-Project: {project-id} |
| 管理 API | プロジェクト API | プロジェクト API |
| アクセスコントロール | IAM ポリシーのリソースとしてのプロジェクト | IAM ポリシーのリソースとしてのプロジェクト |
| コスト追跡 | AWS プロジェクトのタグ | AWS プロジェクトのタグ |
## WorkSpaces の開始方法
このセクションでは、ワークスペースの作成、Messages API リクエストとの関連付け、セットアップの検証について説明します。
### 前提条件
開始する前に、以下があることを確認してください。
+ Amazon Bedrock アクセスを持つ AWS アカウント
+ Amazon Bedrock プロジェクトを作成および管理するための IAM アクセス許可
+ Amazon Bedrock 認証の [API キー](api-keys.md)
+ Claude モデルへのアクセス (「」を参照[モデルへのアクセスをリクエストする](model-access.md))
### ステップ1: 環境の構築
Amazon Bedrock 認証情報を使用して環境変数を設定します。
```
export BEDROCK_API_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 を介して管理されるため、すべてのプロジェクト管理オペレーションが適用されます。以下の詳細な手順[プロジェクト作業](projects.md#projects-working-with)については、「」を参照してください。
+ **ワークスペースの一覧表示**: アカウント内のすべてのワークスペースを取得する
+ **詳細の取得**: 特定のワークスペースに関する情報を取得する
+ **ワークスペースの更新**: ワークスペース名またはタグの変更
+ **タグの管理**: コスト配分のためのタグの追加または削除
+ **ワークスペースのアーカイブ**: 使用されなくなったワークスペースのアーカイブ
## ベストプラクティス
### 推奨される Workspace 構造
**アプリケーションごとに 1 つのワークスペース**: 個別のアプリケーションまたはサービスごとに個別のワークスペースを作成します。
```
├── Claude-Chatbot-Production
├── Claude-Chatbot-Staging
├── Claude-Chatbot-Development
├── Claude-Summarizer-Production
└── Claude-Summarizer-Development
```
+ **個別の環境**: 開発、ステージング、本番環境には異なるワークスペースを使用します。
+ **実験分離**: 実験とproof-of-concepts専用のワークスペースを作成します。
### WorkSpace ライフサイクル管理
+ **ワークスペースを早期に作成する**: アプリケーションをデプロイする前にワークスペースをセットアップする
+ **一貫した命名**を使用する: 組織の命名規則に従う
+ **コスト配分のタグ**: 常にコストセンタータグとチームタグを含める
+ **定期的な監査**: 未使用のワークスペースを定期的にレビューしてアーカイブする
+ **使用状況のモニタリング**: ワークスペースメトリクスを追跡して最適化の機会を特定する