Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Espaces de travail () Anthropic-compatible

Les espaces de travail Amazon Bedrock fournissent une isolation au niveau de l'application pour vos charges de travail génératives basées sur l'IA à l'aide de l'API Anthropic-compatible Messages sur le terminal. bedrock-mantle Les espaces de travail vous permettent de segmenter vos applications d'IA pour le suivi des coûts, l'observabilité et le contrôle d'accès.

Qu'est-ce qu'un espace de travail ?

Un espace de travail est une limite logique utilisée pour isoler les charges de travail telles que les applications, les environnements ou les expériences au sein d'Amazon Bedrock lors de l'utilisation de l'API Anthropic Messages. Les espaces de travail constituent la même ressource sous-jacente que Projets (OpenAI-compatible) : ils sont gérés à l'aide de l'API Projects et offrent les mêmes fonctionnalités :

Les espaces de travail vous permettent de gérer plusieurs charges de travail d'IA générative en production sans créer de AWS comptes ou d'organisations distincts, ce qui réduit la complexité opérationnelle tout en préservant la sécurité et la gouvernance.

Chaque AWS compte possède un espace de travail par défaut (projet) auquel toutes les demandes d'inférence sont associées. Vous pouvez créer des espaces de travail supplémentaires à l'aide de l'API Projects et les référencer dans les demandes de l'API Messages à l'aide de l'anthropic-workspaceen-tête.

Quand utiliser les espaces de travail

Vous devez utiliser Workspaces lorsque vous devez :

Espaces de travail et projets

Les espaces de travail et Projets (OpenAI-compatible) 3 constituent la même ressource sous-jacente. Les deux sont gérés via l'API Projects. La différence réside dans la manière dont vous les référencez dans vos demandes d'inférence, en fonction de l'API que vous utilisez :

Commencer à utiliser Workspaces

Cette section explique comment créer un espace de travail, l'associer aux requêtes de l'API Messages et vérifier votre configuration.

Conditions préalables

Avant de commencer, assurez-vous de disposer des éléments suivants :

Étape 1 : configuration de votre environnement

Configurez vos variables d'environnement avec vos informations d'identification Amazon Bedrock :

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

Étape 2 : Création d'un espace de travail

Les espaces de travail sont créés à l'aide de l'API Projects. Créez un espace de travail (projet) avec un nom et des tags pour le suivi des coûts :

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

Réponse :

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

Notez le id champ : il s'agit de la valeur que vous transmettez dans l'anthropic-workspaceen-tête.

Étape 3 : associer les demandes à votre espace de travail

Pour associer vos demandes d'API Messages à un espace de travail, incluez l'anthropic-workspaceen-tête avec l'ID du projet :

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)

Toutes les demandes d'inférence effectuées avec le même identifiant d'espace de travail sont regroupées, ce qui permet le suivi des coûts par espace de travail, le contrôle d'accès et l'observabilité.

Étape 4 : vérifier la configuration de votre espace de travail

Répertoriez tous les espaces de travail (projets) pour vérifier que votre espace de travail a bien été créé :

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

Gestion des espaces de travail

Les espaces de travail étant gérés via l'API Projects, toutes les opérations de gestion de projet s'appliquent. Consultez Utilisation des projets les instructions détaillées sur :

Bonnes pratiques

Structure d'espace de travail recommandée

Un espace de travail par application : créez des espaces de travail distincts pour chaque application ou service distinct.

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

Gestion du cycle de vie des espaces