View a markdown version of this page

Ruang kerja () Anthropic-compatible - Amazon Bedrock
Apa itu Ruang Kerja?Kapan menggunakan WorkspaceRuang Kerja vs ProyekMemulai dengan WorkspacesMengelola Ruang KerjaPraktik terbaik

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Ruang kerja () Anthropic-compatible

Amazon Bedrock Workspaces menyediakan isolasi tingkat aplikasi untuk beban kerja AI generatif Anda menggunakan Messages API di titik akhir Anthropic-compatible . bedrock-mantle Ruang kerja memungkinkan Anda untuk mengelompokkan aplikasi AI Anda untuk pelacakan biaya, pengamatan, dan kontrol akses.

Tip

Untuk aplikasi baru, kami merekomendasikan titik bedrock-runtime akhir. Jika Anda tidak memerlukan Workspace, gunakan API Converse atau In voke dengan Profil Inferensi untuk isolasi, penandaan, dan pelacakan biaya. bedrock-runtime

catatan

Ruang kerja hanya dapat digunakan dengan model yang mendukung Messages API pada bedrock-mantle titik akhir. Untuk melihat model mana yang mendukung Messages API, lihatAPI yang didukung oleh Amazon Bedrock.

Jika Anda menggunakan OpenAI-compatible API (Responses API, Chat Completions), gunakan Proyek (OpenAI-compatible) sebagai gantinya.

Apa itu Ruang Kerja?

Ruang Kerja adalah batas logis yang digunakan untuk mengisolasi beban kerja seperti aplikasi, lingkungan, atau eksperimen dalam Amazon Bedrock saat menggunakan Anthropic Messages API. Ruang kerja adalah sumber daya dasar yang sama Proyek (OpenAI-compatible) dengan - mereka dikelola menggunakan API Proyek dan menyediakan kemampuan yang sama:

  • Isolasi akses: Kontrol siapa yang dapat mengakses sumber daya ruang kerja tertentu menggunakan kebijakan IAM untuk Proyek Amazon Bedrock

  • Pemantauan biaya: Lacak pengeluaran di tingkat ruang kerja menggunakan tag AWS dan AWS Cost Explorer

  • Pengamatan: Lacak metrik dan pola penggunaan per ruang kerja untuk pemantauan dan pengoptimalan.

Ruang kerja memungkinkan Anda mengelola beberapa beban kerja AI generatif dalam produksi tanpa membuat AWS akun atau organisasi terpisah, mengurangi kompleksitas operasional sambil mempertahankan keamanan dan tata kelola.

Setiap AWS akun memiliki ruang kerja default (proyek) di mana semua permintaan inferensi dikaitkan. Anda dapat membuat ruang kerja tambahan menggunakan Projects API dan merujuknya dalam permintaan Messages API menggunakan anthropic-workspace header.

Kapan menggunakan Workspace

Anda harus menggunakan Workspaces ketika Anda perlu:

  • Mengatur berdasarkan struktur bisnis: Kelola penggunaan Amazon Bedrock berdasarkan taksonomi organisasi Anda seperti unit bisnis, tim, aplikasi, atau pusat biaya

  • Lacak biaya secara akurat: Pantau dan alokasikan pengeluaran AI ke tim, proyek, atau lingkungan tertentu

  • Menerapkan kebijakan akses: Terapkan izin IAM terperinci untuk mengontrol siapa yang dapat mengakses beban kerja AI tertentu

  • Skala beban kerja produksi: Jalankan beberapa aplikasi produksi dengan batas operasional dan pemantauan yang jelas

Ruang Kerja vs Proyek

Ruang kerja dan Proyek (OpenAI-compatible) merupakan sumber daya dasar yang sama — keduanya dikelola melalui Projects API. Perbedaannya adalah bagaimana Anda mereferensikan mereka dalam permintaan inferensi Anda, tergantung pada API mana yang Anda gunakan:

Fitur Workspace Proyek
API yang didukung API Pesan Antropik OpenAI-compatible API (Tanggapan, Penyelesaian Obrolan)
Titik akhir bedrock-mantle.{region}.api.aws/anthropic/v1/messages bedrock-mantle.{region}.api.aws/v1
Header anthropic-workspace: {project-id} OpenAI-Project: {project-id}
API Manajemen API Proyek API Proyek
Kontrol Akses Proyek sebagai sumber daya dalam kebijakan IAM Proyek sebagai sumber daya dalam kebijakan IAM
Pelacakan Biaya AWS tag pada proyek AWS tag pada proyek

Memulai dengan Workspaces

Bagian ini memandu Anda membuat ruang kerja, mengaitkannya dengan permintaan Messages API, dan memverifikasi pengaturan Anda.

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

  • AWS Akun dengan akses Amazon Bedrock

  • Izin IAM untuk membuat dan mengelola proyek Amazon Bedrock

  • Kunci API untuk otentikasi Amazon Bedrock

  • Akses ke model Claude (lihatMinta akses ke model)

Langkah 1: Siapkan lingkungan Anda

Konfigurasikan variabel lingkungan Anda dengan kredenSIAL Amazon Bedrock Anda:

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

Langkah 2: Buat Ruang Kerja

Ruang kerja dibuat menggunakan Projects API. Buat ruang kerja (proyek) dengan nama dan tag untuk pemantauan biaya:

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

Respons:

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

Perhatikan id bidang - ini adalah nilai yang Anda berikan di anthropic-workspace header.

Langkah 3: Mengaitkan permintaan dengan Ruang Kerja Anda

Untuk mengaitkan permintaan API Pesan Anda dengan ruang kerja, sertakan anthropic-workspace header dengan ID proyek:

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)

Semua permintaan inferensi yang dibuat dengan ID ruang kerja yang sama dikelompokkan bersama, memungkinkan pelacakan biaya per ruang kerja, kontrol akses, dan pengamatan.

Langkah 4: Verifikasi pengaturan Ruang Kerja

Daftar semua ruang kerja (proyek) untuk memverifikasi ruang kerja Anda berhasil dibuat:

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

Mengelola Ruang Kerja

Karena Workspace dikelola melalui Projects API, semua operasi manajemen proyek berlaku. Lihat Bekerja dengan Proyek untuk petunjuk terperinci tentang:

  • Daftar ruang kerja: Ambil semua ruang kerja di akun Anda

  • Mengambil detail: Dapatkan informasi tentang ruang kerja tertentu

  • Memperbarui ruang kerja: Ubah nama atau tag ruang kerja

  • Mengelola tag: Menambahkan atau menghapus tag untuk alokasi biaya

  • Mengarsipkan ruang kerja: Mengarsipkan ruang kerja yang tidak lagi digunakan

Praktik terbaik

Satu ruang kerja per aplikasi: Buat ruang kerja terpisah untuk setiap aplikasi atau layanan yang berbeda.

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

  • Lingkungan terpisah: Gunakan ruang kerja yang berbeda untuk pengembangan, pementasan, dan lingkungan produksi.

  • Isolasi eksperimen: Buat ruang kerja khusus untuk eksperimen dan pembuktian konsep.

Manajemen siklus hidup ruang kerja

  • Buat ruang kerja lebih awal: Siapkan ruang kerja sebelum menerapkan aplikasi

  • Gunakan penamaan yang konsisten: Ikuti konvensi penamaan organisasi

  • Tag untuk alokasi biaya: Selalu sertakan pusat biaya dan tag tim

  • Audit rutin: Tinjau dan arsipkan ruang kerja yang tidak digunakan secara berkala

  • Memantau penggunaan: Lacak metrik ruang kerja untuk mengidentifikasi peluang pengoptimalan