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

Proyek (OpenAI-compatible)

Amazon Bedrock Projects API menyediakan isolasi tingkat aplikasi untuk beban kerja AI generatif Anda menggunakan API. OpenAI-compatible Proyek memungkinkan Anda mengatur dan mengelola aplikasi AI Anda dengan kontrol akses yang ditingkatkan, 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 AWS akun atau organisasi terpisah, mengurangi kompleksitas operasional sambil mempertahankan keamanan dan tata kelola.

Setiap AWS akun memiliki proyek default di mana semua permintaan inferensi dikaitkan dengan. 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

API Proyek dan Profil Inferensi menyediakan kemampuan isolasi, penandaan, dan kontrol akses di Amazon Bedrock, tetapi keduanya berbeda berdasarkan titik akhir yang Anda gunakan. Jika Anda menggunakan OpenAI-compatible API dengan titik akhir land rock-mantle, gunakan Projects API. Jika Anda menggunakan titik akhir runtime bedrock-( direkomendasikan untuk aplikasi baru), gunakan Profil Inferensi. API Penyelesaian Obrolan tersedia di kedua titik akhir; API Proyek hanya tersedia di. bedrock-mantle

Proyek vs. AWS rekening

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

Menggunakan Proyek alih-alih AWS akun 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 memulai, pastikan Anda memiliki:

Langkah 1: Siapkan Lingkungan Anda

Konfigurasikan variabel lingkungan Anda dengan kredenSIAL 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 AWS wilayah 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 pengamatan. 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: Mengaitkan Permintaan Inferensi dengan Proyek Anda

Untuk mengaitkan proyek Anda untuk 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

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 terperinci tentang mengelola proyek sepanjang siklus hidupnya.

Membuat Proyek

Pembuatan Proyek Dasar

Buat proyek dengan nama, deskripsi, dan tag:

curl -X POST $OPENAI_BASE_URL/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 terperinci 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 kunci mereka:

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 API yang Berbeda

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