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.
**Anmerkung**
Workspaces können nur mit Modellen verwendet werden, die die Messages-API auf dem Endpunkt unterstützen. `bedrock-mantle` Informationen darüber, welche Modelle die Messages-API unterstützen, finden Sie unter[Von Amazon Bedrock unterstützte APIs](apis.md).
Wenn Sie die OpenAI-compatible APIs (Responses API, Chat Completions) verwenden, verwenden Sie [Projekte (OpenAI-compatible)](projects.md) stattdessen.
## 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)](projects.md) — sie werden mithilfe der Projects-API verwaltet und bieten dieselben Funktionen:
+ **Zugriffsisolierung**: Steuern Sie mithilfe von [IAM-Richtlinien für Amazon Bedrock](security-iam-projects.md) Projects, wer auf bestimmte Workspace-Ressourcen zugreifen kann
+ **Kostenüberwachung**: Verfolgen Sie Ausgaben auf Workspace-Ebene mithilfe von [AWS-Tags](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/what-are-tags.html) und [AWS Cost Explorer](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-what-is.html)
+ **Beobachtbarkeit**: Verfolge Nutzungsmetriken und -muster pro Workspace zur Überwachung und Optimierung.
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:
+ **Nach Geschäftsstruktur organisieren: Verwalten Sie die Nutzung von** Amazon Bedrock auf der Grundlage Ihrer Organisationstaxonomie wie Geschäftseinheiten, Teams, Anwendungen oder Kostenstellen
+ **Verfolgen Sie die Kosten genau**: Überwachen Sie KI-Ausgaben und ordnen Sie sie bestimmten Teams, Projekten oder Umgebungen zu
+ Setzen Sie **Zugriffsrichtlinien durch**: Wenden Sie detaillierte IAM-Berechtigungen an, um zu kontrollieren, wer auf bestimmte KI-Workloads zugreifen kann
+ **Skalieren Sie Produktionsworkloads**: Führen Sie mehrere Produktionsanwendungen mit klaren betrieblichen Grenzen und Überwachung aus
## Arbeitsbereiche im Vergleich zu Projekten
Workspaces und [Projekte (OpenAI-compatible)](projects.md) 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:
| Feature | Arbeitsbereiche | Projekte |
| --- | --- | --- |
| Unterstützte APIs | API für anthropische Nachrichten | OpenAI-compatible APIs (Antworten, Chat-Abschlüsse) |
| Endpoint | bedrock-mantle.{region}.api.aws/anthropic/v1/messages | bedrock-mantle.{region}.api.aws/v1 |
| Header | anthropic-workspace: {project-id} | OpenAI-Project: {project-id} |
| Verwaltungs-API | Projekt-API | Projekte-API |
| Zugriffskontrolle | Projekt als Ressource in IAM-Richtlinien | Projekt als Ressource in IAM-Richtlinien |
| Nachverfolgung der Kosten | AWS Tags auf Projekten | AWS Tags auf Projekten |
## 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:
+ Ein AWS Konto mit Amazon Bedrock-Zugriff
+ IAM-Berechtigungen zum Erstellen und Verwalten von Amazon Bedrock-Projekten
+ Ein [API-Schlüssel](api-keys.md) für die Amazon Bedrock-Authentifizierung
+ Zugriff auf Claude-Modelle (siehe[Zugriff auf Modelle beantragen](model-access.md))
### Schritt 1: Einrichten Ihrer Umgebung
Konfigurieren Sie Ihre Umgebungsvariablen mit Ihren Amazon Bedrock-Anmeldeinformationen:
```
export BEDROCK_API_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](projects.md#projects-working-with) Anweisungen finden Sie unter:
+ **Workspaces auflisten**: Rufe alle Workspaces in deinem Konto ab
+ **Details abrufen**: Erhalte Informationen zu einem bestimmten Workspace
+ **Arbeitsbereiche aktualisieren**: Ändern Sie den Namen oder die Tags des Arbeitsbereichs
+ **Schlagworte verwalten: Fügen Sie Tags** für die Kostenzuweisung hinzu oder entfernen Sie sie
+ **Arbeitsbereiche archivieren**: Archivieren Sie Arbeitsbereiche, die nicht mehr verwendet werden
## 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
```
+ **Separate Umgebungen**: Verwenden Sie unterschiedliche Arbeitsbereiche für Entwicklungs-, Staging- und Produktionsumgebungen.
+ **Isolierung von Experimenten**: Schaffen Sie spezielle Arbeitsbereiche für Experimente und Machbarkeitsnachweise.
### Lebenszyklusmanagement von Arbeitsräumen
+ **Arbeitsbereiche frühzeitig erstellen**: Richten Sie Arbeitsbereiche ein, bevor Sie Anwendungen bereitstellen
+ **Verwenden Sie eine einheitliche Benennung**: Folgen Sie den Benennungskonventionen der Organisation
+ **Tag für die Kostenzuweisung**: Geben Sie immer Stichwörter für Kostenstelle und Team an
+ **Regelmäßige Audits**: Überprüfe und archiviere regelmäßig ungenutzte Arbeitsbereiche
+ **Überwachen Sie die Nutzung**: Verfolgen Sie Workspace-Kennzahlen, um Optimierungsmöglichkeiten zu identifizieren