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 mithilfe der Anthropic-compatible Nachrichten-API auf dem Endpunkt eine Isolierung auf Anwendungsebene für Ihre generativen KI-Workloads. 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 zugrundeliegende Ressource wie Projekte (OpenAI-compatible) — sie werden mithilfe der Projekt-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 einrichten zu müssen. Dadurch wird die betriebliche Komplexität reduziert und gleichzeitig Sicherheit und Governance gewahrt.

Jedes AWS Konto hat einen Standardarbeitsbereich (Projekt), dem alle Inferenzanforderungen zugeordnet sind. Sie können mithilfe der Projekte-API zusätzliche Arbeitsbereiche erstellen und sie in Nachrichten-API-Anfragen mithilfe des anthropic-workspace Headers referenzieren.

Wann sollte man Workspaces verwenden

Du solltest Workspaces verwenden, wenn du:

Arbeitsbereiche im Vergleich zu Projekten

Arbeitsbereiche und Projekte (OpenAI-compatible) sind dieselbe zugrundeliegende Ressource — beide werden über die Projekt-API verwaltet. Der Unterschied besteht darin, wie Sie in Ihren Inferenzanfragen auf sie verweisen, je nachdem, welche API Sie verwenden:

Erste Schritte mit Workspaces

In diesem Abschnitt erfährst du, wie du einen Workspace erstellst, ihn mit Messages-API-Anfragen verknüpfst und deine Einrichtung verifizierst.

Voraussetzungen

Bevor du anfängst, stelle sicher, dass du:

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: Einen Workspace erstellen

Arbeitsbereiche werden mithilfe der Projekte-API erstellt. Erstellen Sie einen Arbeitsbereich (Projekt) mit einem Namen und Stichwörtern 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"
  }
}

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

Schritt 3: Ordne Anfragen deinem Workspace zu

Um deine Nachrichten-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, Zugriffskontrolle und Beobachtbarkeit nachverfolgt werden können.

Schritt 4: Verifiziere deine Workspace-Einrichtung

Listet alle Workspaces (Projekte) auf, um sicherzustellen, dass 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 Arbeitsbereiche über die Projekte-API verwaltet werden, gelten alle Projektmanagementvorgänge. Eine Arbeiten mit -Projekten ausführliche Anleitung finden Sie unter:

Bewährte Methoden

Empfohlene Workspace-Struktur

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

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

Lebenszyklusmanagement am Arbeitsplatz