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

リクエストごとのメタデータのタグ付け

リクエストメタデータを使用すると、bedrock-runtimeエンドポイントの個々の Amazon Bedrock 推論呼び出しにキーと値のタグをアタッチできます。タグは、モデル呼び出しログに リクエストとともに記録されます。その後、使用状況をチーム、アプリケーション、環境、実験、または呼び出しごとに異なるその他のディメンションに属性付けできます。事前に作成または設定するリソースはありません。各呼び出しには異なるタグセットを含めることができます。

リクエストメタデータは、次の bedrock-runtime APIs。

リクエストメタデータの仕組み

リクエストにメタデータをアタッチする方法は、呼び出す API によって異なります。

リクエストメタデータは、呼び出し AWS リージョン が行われた でログ記録が有効になっている場合にのみ、モデル呼び出しログに記録されます。セットアップ手順については、「」を参照してくださいCloudWatch Logs と Amazon S3 を使用してモデル呼び出しをモニタリングする。

次の例は、呼び出しにチーム名、環境、テストケース識別子をタグ付けする InvokeModel リクエストを示しています。

POST /model/anthropic.claude-3-haiku-20240307-v1:0/invoke HTTP/1.1
Content-Type: application/json
X-Amzn-Bedrock-Request-Metadata: {"team": "orchestrator", "environment": "preview-test", "test_case": "invoke_model_sync"}

{
  "anthropic_version": "bedrock-2023-05-31",
  "max_tokens": 50,
  "messages": [{"role": "user", "content": "Say hello in one word."}]
}

InvokeModelWithResponseStream でも同じヘッダーがサポートされています。

POST /model/anthropic.claude-3-haiku-20240307-v1:0/invoke-with-response-stream HTTP/1.1
Content-Type: application/json
X-Amzn-Bedrock-Request-Metadata: {"team": "orchestrator", "environment": "preview-test", "test_case": "invoke_model_stream"}

{
  "anthropic_version": "bedrock-2023-05-31",
  "max_tokens": 50,
  "messages": [{"role": "user", "content": "Say hello in one word."}]
}

次の例では、Converse 呼び出しで AWS SDK for Python (Boto3) を使用してリクエストメタデータを設定します。SDK には、SigV4-signed付きヘッダーにメタデータが含まれています。

import boto3

client = boto3.client("bedrock-runtime")

response = client.converse(
    modelId="us.anthropic.claude-opus-4-8",  # or an inference profile ARN
    messages=[{"role": "user", "content": [{"text": "Summarize this ticket."}]}],
    requestMetadata={
        "user": "alice@example.com",
        "team": "growth",
        "feature": "summarizer",
        "environment": "prod",
    },
)

制限

リクエストメタデータには以下の制限があり、X-Amzn-Bedrock-Request-Metadataヘッダー (InvokeModel、InvokeModelWithResponseStream) とrequestMetadata本文フィールド (Converse、ConverseStream) の両方に適用されます。

これらの制限を超えるリクエストは、検証エラーで拒否されます。

リクエストメタデータが表示される場所

リクエストメタデータは、最上位requestMetadataフィールドの Amazon Bedrock モデル呼び出しログに表示されます。次の省略ログエントリは、InvokeModel 呼び出しの フィールドを示しています。

{
    "schemaType": "ModelInvocationLog",
    "schemaVersion": "1.0",
    "timestamp": "2024-01-15T12:00:00Z",
    "accountId": "123456789012",
    "region": "us-east-1",
    "requestId": "abcd1234-5678-efgh-ijkl-mnopqrstuvwx",
    "operation": "InvokeModel",
    "modelId": "anthropic.claude-3-haiku-20240307-v1:0",
    "requestMetadata": {
        "team": "orchestrator",
        "environment": "preview-test",
        "test_case": "invoke_model_sync"
    },
    "input":  { "...": "..." },
    "output": { "...": "..." }
}

Amazon CloudWatch Logs Insights、Amazon Athena などの Amazon S3 クエリツール、または呼び出しログを読み取るその他のシステム内のメタデータフィールドでログをフィルタリングおよび集計できます。

ログからのコストの取得

リクエストメタデータとトークン数は、請求書ではなくモデル呼び出しログに書き込まれます。これらをコストに変換する方法は 2 つあります。

考慮事項