Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Projekte-API

Die Amazon Bedrock Projects API bietet Isolierung auf Anwendungsebene für Ihre generativen KI-Workloads mithilfe von OpenAI-Compatible. APIs Projekte ermöglichen es Ihnen, Ihre KI-Anwendungen mit verbesserter Zugriffskontrolle, Kostenverfolgung und unternehmensweit sichtbarer zu organisieren und zu verwalten.

Was ist ein Projekt?

Ein Projekt ist eine logische Grenze, die verwendet wird, um Workloads wie Anwendungen, Umgebungen oder Experimente innerhalb von Amazon Bedrock zu isolieren. Projekte bieten:

Projekte ermöglichen es Ihnen, mehrere generative KI-Workloads in der Produktion zu verwalten, ohne separate AWS-Konten oder Organisationen zu erstellen, wodurch die betriebliche Komplexität reduziert wird und gleichzeitig Sicherheit und Governance gewahrt bleiben.

Jedes AWS-Konto hat ein Standardprojekt, dem alle Inferenzanfragen zugeordnet sind. Mit der Projects-API können Sie weitere Projekte in Ihrem Konto erstellen.

Wann sollten Sie Projekte verwenden

Sie sollten die Projects-API verwenden, wenn Sie:

Projekte im Vergleich zu Inferenzprofilen

Sowohl die Projekt-API als auch die Inferenzprofile bieten Isolations-, Tagging- und Zugriffskontrollfunktionen in Amazon Bedrock, die sich jedoch je nach verwendeter API unterscheiden. Wenn Sie OpenAI verwenden, das APIs mit dem Bedrock-Mantle-Endpunkt kompatibel ist, der die Mantle-Inferenz-Engine verwendet, verwenden Sie die Projects-API. Wenn Sie Invoke oder Converse mit dem Bedrock-Runtime-Endpunkt verwenden, verwenden Sie Inference Profiles APIs . Sie können die Chat Completions API zwar entweder mit Bedrock-Mantle- oder Bedrock-Runtime-Endpunkten verwenden, wir empfehlen jedoch, den Mantle-Endpunkt zu verwenden.

Projekte im Vergleich zu AWS-Konten

AWS-Konten und AWS Organizations stellen Abrechnungs- und Eigentumsgrenzen auf Infrastrukturebene dar. Projekte stellen die Arbeitslast- und Anwendungsgrenzen innerhalb eines einzigen Kontos dar.

Die Verwendung von Projekten anstelle von separaten AWS-Konten bietet:

Erste Schritte mit Projekten

Auf dieser Seite erfahren Sie, wie Sie Ihr erstes Projekt erstellen, es mit Inferenzanfragen verknüpfen und Projektressourcen verwalten.

Voraussetzungen

Stellen Sie vor Beginn sicher, dass Sie über Folgendes verfügen:

Schritt 1: Richten Sie Ihre Umgebung ein

Konfigurieren Sie Ihre Umgebungsvariablen mit Ihren Amazon Bedrock-Anmeldeinformationen:

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

<your-region>Ersetzen Sie durch Ihre AWS-Region (z. B. us-east-1, us-west-2).

Schritt 2: Entdecken Sie die verfügbaren Modelle

Verwenden Sie die list() API, um eine Liste von Modellen abzurufen, die mit der Projects-API kompatibel sind:

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

Schritt 3: Erstellen Sie Ihr erstes Projekt

Erstellen Sie ein Projekt mithilfe der Create Project API mit Tags zur Kostenüberwachung und Beobachtbarkeit. Beachten Sie, dass derzeit nur cURL im SDK unterstützt wird.

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

Antwort:

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

Wichtige Hinweise:

Schritt 4: Verknüpfen Sie Inferenzanfragen mit Ihrem Projekt

Um Ihr Projekt mit Inferenzanfragen zu verknüpfen, geben Sie bei der Erstellung des Kunden die Projekt-ID an:

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

Alle Rückschlussanfragen, die an diesen Kunden gestellt werden, werden dem angegebenen Projekt zugeordnet, sodass eine angemessene Isolierung, Kostenverfolgung und Zugriffskontrolle gewährleistet sind.

Schritt 5: Überprüfen Sie Ihre Projektkonfiguration

Führen Sie alle Projekte auf, um zu überprüfen, ob Ihr Projekt erfolgreich erstellt wurde:

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

Antwort:

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

Nächste Schritte

Nachdem Sie Ihr erstes Projekt erstellt haben, können Sie:

Arbeiten mit -Projekten

Diese Seite bietet detaillierte Informationen zur Verwaltung von Projekten während ihres gesamten Lebenszyklus.

Projekte erstellen

Grundlegende Projekterstellung

Erstellen Sie ein Projekt mit einem Namen, einer Beschreibung und Tags:

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

Sie können bis zu 1000 Projekte pro Konto haben.

Empfohlene Namenskonventionen

Verwenden Sie klare, aussagekräftige Namen, die Ihre Organisationsstruktur widerspiegeln:

Projekte auflisten

Alle Projekte auflisten

Rufen Sie alle Projekte in Ihrem Konto ab:

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

Projektdetails werden abgerufen

Erhalten Sie detaillierte Informationen zu einem bestimmten Projekt:

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

Projekte aktualisieren

Ändern Sie Projekteigenschaften wie den Namen:

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

Projekt-Tags verwalten

Fügen Sie neue Tags hinzu oder aktualisieren Sie bestehende Tag-Werte:

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

Entferne bestimmte Tags anhand ihrer Schlüssel:

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

Projekte archivieren

Archivieren Sie Projekte, die nicht mehr verwendet werden:

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

Verwenden von Projekten mit unterschiedlichen 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)

Bewährte Methoden

Empfohlene Projektstruktur

Ein Projekt pro Anwendung: Erstellen Sie separate Projekte für jede einzelne Anwendung oder jeden Dienst.

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

Verwaltung des Projektlebenszyklus