Spazi di lavoro

Gli spazi di lavoro forniscono un modo per organizzare l'utilizzo dell'API all'interno di un'organizzazione. Utilizza gli spazi di lavoro per separare diversi progetti, ambienti o team mantenendo la fatturazione e l'amministrazione centralizzate.

Come funzionano gli spazi di lavoro

Ogni organizzazione ha uno Spazio di lavoro predefinito che non può essere rinominato, archiviato o eliminato. Quando crei spazi di lavoro aggiuntivi, puoi assegnare chiavi API, membri e limiti di risorse a ciascuno.

Caratteristiche principali:

• Gli identificatori dello spazio di lavoro utilizzano il prefisso wrkspc_ (ad esempio, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
• Massimo 100 spazi di lavoro per organizzazione (gli spazi di lavoro archiviati non contano)
• Lo spazio di lavoro predefinito non ha ID e non appare negli endpoint dell'elenco
• Le chiavi API sono limitate a un singolo spazio di lavoro e possono accedere solo alle risorse all'interno di quello spazio di lavoro

Ruoli e autorizzazioni dello spazio di lavoro

I membri possono avere ruoli diversi in ogni spazio di lavoro, consentendo un controllo di accesso granulare.

Eredità dei ruoli

• Gli amministratori dell'organizzazione ricevono automaticamente l'accesso come Amministratore dello spazio di lavoro a tutti gli spazi di lavoro
• I membri della fatturazione dell'organizzazione ricevono automaticamente l'accesso come Fatturazione dello spazio di lavoro a tutti gli spazi di lavoro
• Gli utenti e gli sviluppatori dell'organizzazione devono essere aggiunti esplicitamente a ogni spazio di lavoro

Gestione degli spazi di lavoro

Tramite la Console

Crea e gestisci gli spazi di lavoro in Claude Console.

Crea uno spazio di lavoro

Modifica i dettagli dello spazio di lavoro

Per modificare il nome o il colore di uno spazio di lavoro:

1. Seleziona lo spazio di lavoro dall'elenco
2. Fai clic sul menu dei puntini di sospensione (...) e scegli Modifica dettagli
3. Aggiorna il nome o il colore e salva le modifiche

Aggiungi membri a uno spazio di lavoro

1. Vai alla scheda Membri dello spazio di lavoro
2. Fai clic su Aggiungi allo spazio di lavoro
3. Seleziona un membro dell'organizzazione e assegnagli un ruolo dello spazio di lavoro
4. Conferma l'aggiunta

Per rimuovere un membro, fai clic sull'icona del cestino accanto al suo nome.

Imposta i limiti dello spazio di lavoro

Nella scheda Limiti, puoi configurare:

• Limiti di velocità: Imposta limiti per livello di modello per richieste al minuto, token di input o token di output
• Notifiche di spesa: Configura avvisi quando la spesa raggiunge determinate soglie

Archivia uno spazio di lavoro

Per archiviare uno spazio di lavoro, fai clic sul menu dei puntini di sospensione (...) e seleziona Archivia. L'archiviazione:

• Conserva i dati storici per la generazione di report
• Disattiva lo spazio di lavoro e tutte le chiavi API associate
• Non può essere annullata

Tramite l'API di amministrazione

Gestisci gli spazi di lavoro a livello di programmazione utilizzando l'Admin API.

# Create a workspace
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"}'

# List workspaces
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"

# Archive a workspace
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"

Per i dettagli completi dei parametri e gli schemi di risposta, consulta il riferimento API Spazi di lavoro.

Gestione dei membri dello spazio di lavoro

Aggiungi, aggiorna o rimuovi membri da uno spazio di lavoro:

# Add a member to a workspace
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"
  }'

# Update a member's role
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"}'

# Remove a member from a workspace
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"

Per i dettagli completi dei parametri, consulta il riferimento API Membri dello spazio di lavoro.

Chiavi API e ambito delle risorse

Le chiavi API sono limitate a uno spazio di lavoro specifico. Quando crei una chiave API in uno spazio di lavoro, può accedere solo alle risorse all'interno di quello spazio di lavoro.

Le risorse limitate agli spazi di lavoro includono:

• File creati tramite l'API Files
• Message Batches creati tramite l'API Batch
• Skills creati tramite l'API Skills

Limiti dello spazio di lavoro

Puoi impostare limiti di spesa e velocità personalizzati per ogni spazio di lavoro per proteggerti dall'uso eccessivo e garantire una distribuzione equa delle risorse.

Impostazione dei limiti dello spazio di lavoro

I limiti dello spazio di lavoro possono essere impostati inferiori (ma non superiori) ai limiti della tua organizzazione:

• Limiti di spesa: Limita la spesa mensile per uno spazio di lavoro
• Limiti di velocità: Limita le richieste al minuto, i token di input al minuto o i token di output al minuto

Per informazioni dettagliate sui limiti di velocità e su come funzionano, consulta Limiti di velocità.

Tracciamento dell'utilizzo e dei costi

Traccia l'utilizzo e i costi per spazio di lavoro utilizzando l'API Utilizzo e costi:

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'utilizzo e i costi attribuiti allo spazio di lavoro predefinito hanno un valore null per workspace_id.

Casi d'uso comuni

Separazione dell'ambiente

Crea spazi di lavoro separati per sviluppo, staging e produzione:

Isolamento di team o dipartimenti

Assegna spazi di lavoro a diversi team per l'allocazione dei costi e il controllo dell'accesso:

• Team di ingegneria con accesso da sviluppatore
• Team di data science con le proprie chiavi API
• Team di supporto con accesso limitato per gli strumenti dei clienti

Organizzazione basata su progetti

Crea spazi di lavoro per progetti o prodotti specifici per tracciare l'utilizzo e i costi separatamente.

Best practice

FAQ

Vedi anche

• Panoramica dell'Admin API
• Riferimento dell'Admin API
• Limiti di velocità
• API Utilizzo e costi