Ruang Kerja

Ruang kerja menyediakan cara untuk mengatur penggunaan API Anda dalam organisasi. Gunakan ruang kerja untuk memisahkan proyek, lingkungan, atau tim yang berbeda sambil mempertahankan penagihan dan administrasi terpusat.

Cara kerja ruang kerja

Setiap organisasi memiliki Ruang Kerja Default yang tidak dapat diubah nama, diarsipkan, atau dihapus. Ketika Anda membuat ruang kerja tambahan, Anda dapat menetapkan kunci API, anggota, dan batas sumber daya untuk masing-masing.

Karakteristik utama:

• Pengenal ruang kerja menggunakan awalan wrkspc_ (misalnya, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
• Maksimal 100 ruang kerja per organisasi (ruang kerja yang diarsipkan tidak dihitung)
• Ruang Kerja Default tidak memiliki ID dan tidak muncul di titik akhir daftar
• Kunci API dibatasi pada satu ruang kerja dan hanya dapat mengakses sumber daya dalam ruang kerja tersebut

Peran dan izin ruang kerja

Anggota dapat memiliki peran berbeda di setiap ruang kerja, memungkinkan kontrol akses yang terperinci.

Pewarisan peran

• Admin organisasi secara otomatis menerima akses Admin Ruang Kerja ke semua ruang kerja
• Anggota penagihan organisasi secara otomatis menerima akses Penagihan Ruang Kerja ke semua ruang kerja
• Pengguna dan pengembang organisasi harus ditambahkan secara eksplisit ke setiap ruang kerja

Mengelola ruang kerja

Melalui Claude Console

Buat dan kelola ruang kerja di Claude Console.

Buat ruang kerja

Edit detail ruang kerja

Untuk mengubah nama atau warna ruang kerja:

1. Pilih ruang kerja dari daftar
2. Klik menu elipsis (...) dan pilih Edit details
3. Perbarui nama atau warna dan simpan perubahan Anda

Tambahkan anggota ke ruang kerja

1. Navigasi ke tab Members ruang kerja
2. Klik Add to Workspace
3. Pilih anggota organisasi dan tetapkan mereka peran ruang kerja
4. Konfirmasi penambahan

Untuk menghapus anggota, klik ikon tempat sampah di sebelah nama mereka.

Tetapkan batas ruang kerja

Di tab Limits, Anda dapat mengonfigurasi:

• Batas laju: Tetapkan batas per tingkat model untuk permintaan per menit, token input, atau token output
• Notifikasi pengeluaran: Konfigurasikan peringatan ketika pengeluaran mencapai ambang batas tertentu

Arsipkan ruang kerja

Untuk mengarsipkan ruang kerja, klik menu elipsis (...) dan pilih Archive. Pengarsipan:

• Menyimpan data historis untuk pelaporan
• Menonaktifkan ruang kerja dan semua kunci API terkait
• Tidak dapat dibatalkan

Melalui Admin API

Kelola ruang kerja secara terprogram menggunakan 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"

Untuk detail parameter lengkap dan skema respons, lihat referensi API Ruang Kerja.

Mengelola anggota ruang kerja

Tambahkan, perbarui, atau hapus anggota dari ruang kerja:

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

Untuk detail parameter lengkap, lihat referensi API Anggota Ruang Kerja.

Kunci API dan cakupan sumber daya

Kunci API dibatasi pada ruang kerja tertentu. Ketika Anda membuat kunci API di ruang kerja, kunci tersebut hanya dapat mengakses sumber daya dalam ruang kerja tersebut.

Sumber daya yang dibatasi pada ruang kerja meliputi:

• File yang dibuat melalui Files API
• Message Batches yang dibuat melalui Batch API
• Skills yang dibuat melalui Skills API

Batas ruang kerja

Anda dapat menetapkan batas pengeluaran dan laju kustom untuk setiap ruang kerja untuk melindungi dari penggunaan berlebihan dan memastikan distribusi sumber daya yang adil.

Menetapkan batas ruang kerja

Batas ruang kerja dapat ditetapkan lebih rendah dari (tetapi tidak lebih tinggi dari) batas organisasi Anda:

• Batas pengeluaran: Batasi pengeluaran bulanan untuk ruang kerja
• Batas laju: Batasi permintaan per menit, token input per menit, atau token output per menit

Untuk informasi terperinci tentang batas laju dan cara kerjanya, lihat Batas laju.

Pelacakan penggunaan dan biaya

Lacak penggunaan dan biaya berdasarkan ruang kerja menggunakan Usage and Cost API:

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"

Penggunaan dan biaya yang dikaitkan dengan Ruang Kerja Default memiliki nilai null untuk workspace_id.

Kasus penggunaan umum

Pemisahan lingkungan

Buat ruang kerja terpisah untuk pengembangan, staging, dan produksi:

Isolasi tim atau departemen

Tetapkan ruang kerja ke tim berbeda untuk alokasi biaya dan kontrol akses:

• Tim teknik dengan akses pengembang
• Tim ilmu data dengan kunci API mereka sendiri
• Tim dukungan dengan akses terbatas untuk alat pelanggan

Organisasi berbasis proyek

Buat ruang kerja untuk proyek atau produk tertentu untuk melacak penggunaan dan biaya secara terpisah.

Praktik terbaik

FAQ

Lihat juga

• Gambaran umum Admin API
• Referensi Admin API
• Batas laju
• Usage and Cost API