Espaces de travail

Les espaces de travail offrent un moyen d'organiser votre utilisation des API au sein d'une organisation. Utilisez les espaces de travail pour séparer différents projets, environnements ou équipes tout en maintenant une facturation et une administration centralisées.

Fonctionnement des espaces de travail

Chaque organisation dispose d'un Espace de travail par défaut qui ne peut pas être renommé, archivé ou supprimé. Lorsque vous créez des espaces de travail supplémentaires, vous pouvez assigner des clés API, des membres et des limites de ressources à chacun d'eux.

Caractéristiques clés :

• Les identifiants d'espace de travail utilisent le préfixe wrkspc_ (par exemple, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
• Maximum 100 espaces de travail par organisation (les espaces de travail archivés ne comptent pas)
• L'espace de travail par défaut n'a pas d'ID et n'apparaît pas dans les points de terminaison de liste
• Les clés API sont limitées à un seul espace de travail et ne peuvent accéder qu'aux ressources de cet espace de travail

Rôles et permissions des espaces de travail

Les membres peuvent avoir différents rôles dans chaque espace de travail, permettant un contrôle d'accès granulaire.

Héritage des rôles

• Les administrateurs de l'organisation reçoivent automatiquement l'accès Administrateur de l'espace de travail à tous les espaces de travail
• Les membres de facturation de l'organisation reçoivent automatiquement l'accès Facturation de l'espace de travail à tous les espaces de travail
• Les utilisateurs et développeurs de l'organisation doivent être explicitement ajoutés à chaque espace de travail

Gestion des espaces de travail

Via la Console

Créez et gérez les espaces de travail dans la Claude Console.

Créer un espace de travail

Modifier les détails de l'espace de travail

Pour modifier le nom ou la couleur d'un espace de travail :

1. Sélectionnez l'espace de travail dans la liste
2. Cliquez sur le menu des points de suspension (...) et choisissez Modifier les détails
3. Mettez à jour le nom ou la couleur et enregistrez vos modifications

Ajouter des membres à un espace de travail

1. Accédez à l'onglet Membres de l'espace de travail
2. Cliquez sur Ajouter à l'espace de travail
3. Sélectionnez un membre de l'organisation et assignez-lui un rôle d'espace de travail
4. Confirmez l'ajout

Pour supprimer un membre, cliquez sur l'icône de corbeille à côté de son nom.

Définir les limites de l'espace de travail

Dans l'onglet Limites, vous pouvez configurer :

• Limites de débit : Définissez des limites par niveau de modèle pour les demandes par minute, les jetons d'entrée ou les jetons de sortie
• Notifications de dépenses : Configurez les alertes lorsque les dépenses atteignent certains seuils

Archiver un espace de travail

Pour archiver un espace de travail, cliquez sur le menu des points de suspension (...) et sélectionnez Archiver. L'archivage :

• Préserve les données historiques pour les rapports
• Désactive l'espace de travail et toutes les clés API associées
• Ne peut pas être annulé

Via l'API Admin

Gérez les espaces de travail par programmation en utilisant l'API Admin.

# Créer un espace de travail
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"name": "Production"}'

# Lister les espaces de travail
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Archiver un espace de travail
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Pour les détails complets des paramètres et les schémas de réponse, consultez la référence de l'API Espaces de travail.

Gestion des membres de l'espace de travail

Ajoutez, mettez à jour ou supprimez des membres d'un espace de travail :

# Ajouter un membre à un espace de travail
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# Mettre à jour le rôle d'un membre
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"workspace_role": "workspace_admin"}'

# Supprimer un membre d'un espace de travail
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Pour les détails complets des paramètres, consultez la référence de l'API Membres de l'espace de travail.

Clés API et portée des ressources

Les clés API sont limitées à un espace de travail spécifique. Lorsque vous créez une clé API dans un espace de travail, elle ne peut accéder qu'aux ressources de cet espace de travail.

Les ressources limitées aux espaces de travail incluent :

• Fichiers créés via l'API Fichiers
• Lots de messages créés via l'API Batch
• Compétences créées via l'API Compétences

Limites de l'espace de travail

Vous pouvez définir des limites de dépenses et de débit personnalisées pour chaque espace de travail afin de vous protéger contre l'utilisation excessive et d'assurer une distribution équitable des ressources.

Définition des limites de l'espace de travail

Les limites de l'espace de travail peuvent être définies plus bas que (mais pas plus haut que) les limites de votre organisation :

• Limites de dépenses : Plafonner les dépenses mensuelles pour un espace de travail
• Limites de débit : Limiter les demandes par minute, les jetons d'entrée par minute ou les jetons de sortie par minute

Pour des informations détaillées sur les limites de débit et leur fonctionnement, consultez Limites de débit.

Suivi de l'utilisation et des coûts

Suivez l'utilisation et les coûts par espace de travail en utilisant l'API Utilisation et Coûts :

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
group_by[]=workspace_id&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

L'utilisation et les coûts attribués à l'espace de travail par défaut ont une valeur null pour workspace_id.

Cas d'usage courants

Séparation des environnements

Créez des espaces de travail séparés pour le développement, la mise en staging et la production :

Isolation des équipes ou départements

Assignez des espaces de travail à différentes équipes pour l'allocation des coûts et le contrôle d'accès :

• Équipe d'ingénierie avec accès développeur
• Équipe de science des données avec leurs propres clés API
• Équipe d'assistance avec accès limité pour les outils clients

Organisation basée sur les projets

Créez des espaces de travail pour des projets ou des produits spécifiques afin de suivre l'utilisation et les coûts séparément.

Bonnes pratiques

FAQ

Voir aussi

• Aperçu de l'API Admin
• Référence de l'API Admin
• Limites de débit
• API Utilisation et Coûts