Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Projets (OpenAI-compatible)

L'API Amazon Bedrock Projects fournit une isolation au niveau de l'application pour vos charges de travail d'IA génératives à l'aide d'API. OpenAI-compatible Les projets vous permettent d'organiser et de gérer vos applications d'IA en améliorant le contrôle d'accès, le suivi des coûts et l'observabilité au sein de votre organisation.

Qu'est-ce qu'un projet ?

Un projet est une limite logique utilisée pour isoler les charges de travail telles que les applications, les environnements ou les expériences au sein d'Amazon Bedrock. Les projets fournissent :

Les projets vous permettent de gérer plusieurs charges de travail d'IA génératives en production sans créer de AWS comptes ou d'organisations distincts, ce qui réduit la complexité opérationnelle tout en préservant la sécurité et la gouvernance.

Chaque AWS compte possède un projet par défaut auquel toutes les demandes d'inférence sont associées. Vous pouvez créer d'autres projets dans votre compte à l'aide de l'API Projects.

Quand utiliser les projets

Vous devez utiliser l'API Projects lorsque vous devez :

Projets et profils d'inférence

L'API Projects et les profils d'inférence fournissent des fonctionnalités d'isolation, de balisage et de contrôle d'accès dans Amazon Bedrock, mais elles diffèrent en fonction du point de terminaison que vous utilisez. Si vous utilisez des OpenAI-compatible API dont le point de terminaison est le socle, utilisez l'API Projects. Si vous utilisez le point de terminaison Bedrock-Runtime (recommandé pour les nouvelles applications), utilisez des profils d'inférence. L'API Chat Completions est disponible sur les deux terminaux ; l'API Projects n'est disponible que sur. bedrock-mantle

Projets vs. AWS comptes

Les comptes et AWS les organisations AWS représentent les limites de facturation et de propriété au niveau de l'infrastructure. Les projets représentent la charge de travail et les limites des applications au sein d'un seul compte.

L'utilisation de Projects au lieu de AWS comptes séparés permet de :

Démarrer avec Projects

Cette page vous explique comment créer votre premier projet, l'associer à des demandes d'inférence et gérer les ressources du projet.

Conditions préalables

Avant de commencer, assurez-vous d'avoir :

Étape 1 : Configuration de votre environnement

Configurez vos variables d'environnement avec vos informations d'identification Amazon Bedrock :

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

Remplacez <your-region> par votre AWS région (par exemple, us-east-1, us-west-2).

Étape 2 : Découvrez les modèles disponibles

Utilisez l'list()API pour récupérer la liste des modèles compatibles avec l'API Projects :

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

Étape 3 : Créez votre premier projet

Créez un projet à l'aide de l'API Create Project avec des balises pour le suivi des coûts et l'observabilité. Notez qu'à l'heure actuelle, seul cURL est pris en charge dans le 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

Réponse :

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

Remarques importantes :

Étape 4 : Associez les demandes d'inférence à votre projet

Pour associer votre projet aux demandes d'inférence, indiquez l'ID du projet lors de la création du client :

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

Toutes les demandes d'inférence effectuées auprès de ce client seront associées au projet spécifié, garantissant ainsi une isolation, un suivi des coûts et un contrôle d'accès appropriés.

Étape 5 : Vérifiez la configuration de votre projet

Répertoriez tous les projets pour vérifier que votre projet a été créé correctement :

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

Réponse :

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

Étapes suivantes

Maintenant que vous avez créé votre premier projet, vous pouvez :

Utilisation des projets

Cette page fournit des informations détaillées sur la gestion des projets tout au long de leur cycle de vie.

Création de projets

Création de projets de base

Créez un projet avec un nom, une description et des balises :

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

Vous pouvez avoir jusqu'à 1 000 projets par compte.

Conventions de dénomination recommandées

Utilisez des noms clairs et descriptifs qui reflètent la structure de votre organisation :

Lister les projets

Liste de tous les projets

Retrouvez tous les projets de votre compte :

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

Récupération des détails du projet

Obtenez des informations détaillées sur un projet spécifique :

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

Mise à jour des projets

Modifiez les propriétés du projet, telles que le nom :

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

Gestion des balises de projet

Ajoutez de nouvelles balises ou mettez à jour les valeurs de balises existantes :

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

Supprimez des tags spécifiques à l'aide de leurs touches :

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

Projets d'archivage

Archivez les projets qui ne sont plus utilisés :

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

Utilisation de projets avec différentes API

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)

Bonnes pratiques

Structure de projet recommandée

Un projet par application  : créez des projets distincts pour chaque application ou service distinct.

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

Gestion du cycle de vie des projets