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 (OpenAI-compatible)

Die Amazon Bedrock Projects API bietet mithilfe von APIs eine Isolierung auf Anwendungsebene für Ihre generativen KI-Workloads. OpenAI-compatible Projekte ermöglichen es Ihnen, Ihre KI-Anwendungen mit verbesserter Zugriffskontrolle, Kostenverfolgung und Beobachtbarkeit in Ihrem gesamten Unternehmen zu organisieren und zu verwalten.

Was ist ein Projekt?

Ein Projekt ist eine logische Grenze, die verwendet wird, um Arbeitslasten 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 einrichten zu müssen. Dadurch wird die betriebliche Komplexität reduziert und gleichzeitig Sicherheit und Governance gewahrt.

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

Wann sollten Projekte verwendet werden

Sie sollten die Projekte-API verwenden, wenn Sie:

Projekte im Vergleich zu Inferenzprofilen

Sowohl die Projekt-API als auch die Inferenzprofile bieten Isolierungs-, Tagging- und Zugriffskontrollfunktionen in Amazon Bedrock, sie unterscheiden sich jedoch je nach verwendetem Endpunkt. Wenn Sie OpenAI-compatible APIs mit dem Von Amazon Bedrock unterstützte Endpunkte Bedrock-Mantle-Endpunkt verwenden, verwenden Sie die Projects-API. Wenn Sie den Von Amazon Bedrock unterstützte Endpunkte Bedrock-Runtime-Endpunkt verwenden (empfohlen für neue Anwendungen), verwenden Sie Inferenzprofile. Die Chat Completions API ist auf beiden Endpunkten verfügbar; die Projects-API ist nur auf verfügbar. bedrock-mantle

Projekte vs. AWS Konten

AWS-Konten und AWS -Organisationen stellen Abrechnungs- und Eigentumsgrenzen auf Infrastrukturebene dar. Projekte stellen die Arbeitslast und die Anwendungsgrenzen innerhalb eines einzelnen 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

Bevor Sie beginnen, stellen Sie sicher, dass Sie:

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 Projekt-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 mithilfe der Create Project API ein Projekt 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: Ordnen Sie Ihrem Projekt Inferenzanfragen zu

Um Ihrem Projekt Inferenzanfragen zuzuordnen, geben Sie bei der Erstellung des Clients 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 Inferenzanfragen, die an diesen Kunden gestellt werden, werden dem angegebenen Projekt zugeordnet, sodass eine ordnungsgemäße Isolierung, Kostenverfolgung und Zugriffskontrolle gewährleistet ist.

Schritt 5: Überprüfen Sie Ihr Projekt-Setup

Listen 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 enthält 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 Stichwörtern:

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

Du kannst bis zu 1000 Projekte pro Konto haben.

Empfohlene Benennungskonventionen

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

Holen Sie sich 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"
  }'

Verwaltung von Projekt-Tags

Fügen Sie neue Tags hinzu oder aktualisieren Sie vorhandene 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"

Projekte mit unterschiedlichen APIs verwenden

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