Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Arbeitsbereiche () Anthropic-compatible

Amazon Bedrock Workspaces bieten Isolierung auf Anwendungsebene für Ihre generativen KI-Workloads mithilfe der Anthropic-compatible Messages-API auf dem Endpunkt. bedrock-mantle Workspaces ermöglichen es Ihnen, Ihre KI-Anwendungen zur Kostenverfolgung, Beobachtbarkeit und Zugriffskontrolle zu segmentieren.

Was ist ein Workspace?

Ein Workspace ist eine logische Grenze, die verwendet wird, um Workloads wie Anwendungen, Umgebungen oder Experimente innerhalb von Amazon Bedrock zu isolieren, wenn die Anthropic Messages API verwendet wird. Workspaces sind dieselbe zugrunde liegende Ressource wie Projekte (OpenAI-compatible) — sie werden mithilfe der Projects-API verwaltet und bieten dieselben Funktionen:

Workspaces ermöglichen es Ihnen, mehrere generative KI-Workloads in der Produktion zu verwalten, ohne separate AWS Konten oder Organisationen zu erstellen. Dies reduziert die betriebliche Komplexität und gewährleistet gleichzeitig Sicherheit und Governance.

Jedes AWS Konto hat einen Standardarbeitsbereich (Projekt), in dem alle Inferenzanfragen verknüpft sind. Sie können mit der Projekte-API zusätzliche Workspaces erstellen und in Anfragen der Messages-API mithilfe der anthropic-workspace Kopfzeile auf diese verweisen.

Wann sollten Sie Workspaces verwenden

Sie sollten Workspaces verwenden, wenn Sie:

Arbeitsbereiche im Vergleich zu Projekten

Workspaces und Projekte (OpenAI-compatible) sind dieselbe zugrunde liegende Ressource — beide werden über die Projects-API verwaltet. Der Unterschied besteht darin, wie Sie sie in Ihren Inferenzanfragen referenzieren, je nachdem, welche API Sie verwenden:

Erste Schritte mit Workspaces

In diesem Abschnitt erfahren Sie, wie Sie einen Workspace erstellen, ihn mit Anfragen der Messages-API verknüpfen und Ihre Einrichtung verifizieren.

Voraussetzungen

Stellen Sie vor Beginn sicher, dass Sie über Folgendes verfügen:

Schritt 1: Einrichten Ihrer Umgebung

Konfigurieren Sie Ihre Umgebungsvariablen mit Ihren Amazon Bedrock-Anmeldeinformationen:

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

Schritt 2: Erstellen Sie einen Arbeitsbereich

Arbeitsbereiche werden mithilfe der Projects-API erstellt. Erstellen Sie einen Arbeitsbereich (Projekt) mit einem Namen und Tags für die Kostenüberwachung:

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"
    }
  }'

Antwort:

{
  "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"
  }
}

Beachten Sie das id Feld — das ist der Wert, den Sie in der anthropic-workspace Kopfzeile übergeben.

Schritt 3: Verbinde Anfragen mit deinem Workspace

Um deine Messages-API-Anfragen mit einem Workspace zu verknüpfen, füge den anthropic-workspace Header mit der Projekt-ID hinzu:

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)

Alle Inferenzanfragen, die mit derselben Workspace-ID gestellt wurden, werden gruppiert, sodass die Kosten pro Workspace nachverfolgt, Zugriffskontrolle und Beobachtbarkeit gewährleistet werden können.

Schritt 4: Überprüfe deine Workspace-Einrichtung

Führe alle Workspaces (Projekte) auf, um zu überprüfen, ob dein Workspace erfolgreich erstellt wurde:

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

Arbeitsbereiche verwalten

Da Workspaces über die Projects-API verwaltet werden, gelten alle Projektmanagement-Operationen. Detaillierte Arbeiten mit -Projekten Anweisungen finden Sie unter:

Best Practices

Empfohlene Workspace-Struktur

Ein Workspace pro Anwendung: Erstellen Sie separate Workspaces für jede einzelne Anwendung oder jeden Dienst.

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

Lebenszyklusmanagement von Arbeitsräumen