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

Proyek API

Amazon Bedrock Projects API menyediakan isolasi tingkat aplikasi untuk beban kerja AI generatif Anda menggunakan OpenAI kompatibel. APIs Proyek memungkinkan Anda untuk mengatur dan mengelola aplikasi AI Anda dengan kontrol akses yang lebih baik, pelacakan biaya, dan pengamatan di seluruh organisasi Anda.

Apa itu Proyek?

Proyek adalah batas logis yang digunakan untuk mengisolasi beban kerja seperti aplikasi, lingkungan, atau eksperimen dalam Amazon Bedrock. Proyek menyediakan:

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

Setiap akun AWS memiliki proyek default tempat semua permintaan inferensi dikaitkan dengannya. Anda dapat membuat lebih banyak proyek di akun Anda menggunakan Projects API.

Kapan Menggunakan Proyek

Anda harus menggunakan Projects API saat Anda perlu:

Proyek vs Profil Inferensi

Baik Project API dan Inference Profiles menyediakan kemampuan isolasi, penandaan, dan kontrol akses di Amazon Bedrock, tetapi keduanya berbeda berdasarkan API yang Anda gunakan. Jika Anda menggunakan OpenAI yang kompatibel APIs dengan endpoint batuan dasar mantel, yang menggunakan mesin inferensi Mantle, gunakan Projects API. Jika Anda menggunakan Invoke atau Converse APIs dengan endpoint groundck-runtime, gunakan Inference Profiles. Meskipun Anda dapat menggunakan Chat Completions API dengan endpoint bedrock-mantle atau bedrock-runtime, kami sarankan Anda menggunakan endpoint Mantle.

Proyek vs Akun AWS

AWS Accounts dan AWS Organizations mewakili batas penagihan dan kepemilikan di tingkat infrastruktur. Proyek mewakili beban kerja dan batasan aplikasi dalam satu akun.

Menggunakan Projects alih-alih akun AWS terpisah menyediakan:

Memulai dengan Proyek

Halaman ini memandu Anda melalui pembuatan proyek pertama Anda, mengaitkannya dengan permintaan inferensi, dan mengelola sumber daya proyek.

Prasyarat

Sebelum Anda mulai, pastikan Anda memiliki:

Langkah 1: Atur Lingkungan Anda

Konfigurasikan variabel lingkungan Anda dengan kredensyal Amazon Bedrock Anda:

export OPENAI_API_KEY="<your-bedrock-key>"
export OPENAI_BASE_URL="https://bedrock-mantle.<your-region>.api.aws/v1"

Ganti <your-region> dengan wilayah AWS Anda (misalnya, us-east-1, us-west-2).

Langkah 2: Temukan Model yang Tersedia

Gunakan list() API untuk mengambil daftar model yang kompatibel dengan Projects API:

curl -X GET $OPENAI_BASE_URL/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

Langkah 3: Buat Proyek Pertama Anda

Buat proyek menggunakan Create Project API dengan tag untuk pemantauan biaya dan observabilitas. Perhatikan bahwa saat ini hanya cURL yang didukung di SDK.

curl -X POST $OPENAI_BASE_URL/organization/projects \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Project ABC",
    "tags": {
      "Project": "CustomerChatbot",
      "Environment": "Production",
      "Owner": "TeamAlpha",
      "CostCenter": "21524"
    }
  }' -v

Respons:

{
  "arn": "arn:aws:bedrock-mantle:ap-northeast-1:673693429514:project/proj_5d5ykleja6cwpirysbb7",
  "created_at": 1772135628,
  "id": "proj_5d5ykleja6cwpirysbb7",
  "name": "Project ABC",
  "object": "organization.project",
  "status": "active",
  "tags": {
    "Owner": "TeamAlpha",
    "Project": "CustomerChatbot",
    "Environment": "Production",
    "CostCenter": "21524"
  }
}

Catatan Penting:

Langkah 4: Kaitkan Permintaan Inferensi dengan Proyek Anda

Untuk mengaitkan proyek Anda dengan permintaan inferensi, berikan ID proyek saat membuat klien:

cURL

curl -X POST $OPENAI_BASE_URL/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "OpenAI-Project: proj_5d5ykleja6cwpirysbb7" \
  -d '{
    "model": "openai.gpt-oss-120b",
    "input": "Explain the benefits of using projects in Amazon Bedrock"
  }'

Python

from openai import OpenAI
client = OpenAI(project="proj_5d5ykleja6cwpirysbb7")

Semua permintaan inferensi yang dibuat dengan klien ini akan dikaitkan dengan proyek yang ditentukan, memastikan isolasi yang tepat, pelacakan biaya, dan kontrol akses.

Langkah 5: Verifikasi Pengaturan Proyek Anda

Buat daftar semua proyek untuk memverifikasi proyek Anda berhasil dibuat:

curl -X GET $OPENAI_BASE_URL/organization/projects \
  -H "Authorization: Bearer $OPENAI_API_KEY"

Respons:

{
  "data": [
    {
      "arn": "arn:aws:bedrock-mantle:ap-northeast-1:673693429514:project/default",
      "created_at": 1764460800,
      "id": "default",
      "name": "default",
      "object": "organization.project",
      "status": "active",
      "tags": {}
    },
    {
      "arn": "arn:aws:bedrock-mantle:ap-northeast-1:673693429514:project/proj_2z766pfxmkij5vwubv75",
      "created_at": 1771823259,
      "id": "proj_2z766pfxmkij5vwubv75",
      "name": "Project ABC",
      "object": "organization.project",
      "status": "active",
      "tags": {}
    }
  ],
  "first_id": "default",
  "has_more": false,
  "last_id": "proj_znaruqn723npmjqnxqfd",
  "object": "list"
}

Langkah Berikutnya

Sekarang setelah Anda membuat proyek pertama Anda, Anda dapat:

Bekerja dengan Proyek

Halaman ini memberikan informasi rinci tentang mengelola proyek sepanjang siklus hidupnya.

Membuat Proyek

Pembuatan Proyek Dasar

Buat proyek dengan nama, deskripsi, dan tag:

curl -X POST $OPENAI_BASE_URL/v1/organization/projects \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Development Environment",
    "tags": {
      "Project": "InternalTools",
      "Environment": "Development",
      "Owner": "TeamAlpha",
      "CostCenter": "30156"
    }
  }'

Anda dapat memiliki hingga 1000 proyek per akun.

Konvensi Penamaan yang Direkomendasikan

Gunakan nama yang jelas dan deskriptif yang mencerminkan struktur organisasi Anda:

Daftar Proyek

Daftar Semua Proyek

Ambil semua proyek di akun Anda:

curl -X GET $OPENAI_BASE_URL/organization/projects \
  -H "Authorization: Bearer $OPENAI_API_KEY"

Mengambil Detail Proyek

Dapatkan informasi rinci tentang proyek tertentu:

curl -X GET $OPENAI_BASE_URL/organization/projects/proj_5d5ykleja6cwpirysbb7 \
  -H "Authorization: Bearer $OPENAI_API_KEY"

Memperbarui Proyek

Ubah properti proyek seperti nama:

curl -X POST $OPENAI_BASE_URL/organization/projects/proj_5d5ykleja6cwpirysbb7 \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production Chatbot v2"
  }'

Mengelola Tag Proyek

Tambahkan tag baru atau perbarui nilai tag yang ada:

curl -X POST $OPENAI_BASE_URL/organization/projects/proj_5d5ykleja6cwpirysbb7 \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "add_tags": {
      "Application": "WebApp",
      "Version": "2.0",
      "Team": "Engineering"
    }
  }'

Hapus tag tertentu dengan kuncinya:

curl -X POST $OPENAI_BASE_URL/organization/projects/proj_5d5ykleja6cwpirysbb7 \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "remove_tag_keys": ["Version", "OldTagKey"]
  }'

Proyek Pengarsipan

Arsipkan proyek yang tidak lagi digunakan:

curl -X POST $OPENAI_BASE_URL/organization/projects/proj_abc123/archive \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json"

Menggunakan Proyek dengan Berbeda APIs

Responses API

from openai import OpenAI

client = OpenAI(project="proj_abc123")

response = client.responses.create(
    model="openai.gpt-oss-120b",
    input="What are the key features of Amazon Bedrock?"
)
print(response)

Chat Completions API

from openai import OpenAI

client = OpenAI(project="proj_abc123")

response = client.chat.completions.create(
    model="openai.gpt-oss-120b",
    messages=[
        {"role": "user", "content": "Explain how projects improve security"}
    ]
)

print(response.choices[0].message.content)

Praktik Terbaik

Struktur Proyek yang Direkomendasikan

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

├── CustomerChatbot-Production
├── CustomerChatbot-Staging
├── CustomerChatbot-Development
├── InternalSearch-Production
└── InternalSearch-Development

Manajemen Siklus Hidup Proyek