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.

API de projets

L'API Amazon Bedrock Projects fournit une isolation au niveau de l'application pour vos charges de travail génératives basées sur l'IA grâce à la compatibilité OpenAI. APIs 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érative en production sans créer de comptes ou d'organisations AWS distincts, ce qui réduit la complexité opérationnelle tout en préservant la sécurité et la gouvernance.

Chaque compte AWS 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 de l'API que vous utilisez. Si vous utilisez OpenAI compatible APIs avec le point de terminaison Bedrock-mantle, qui utilise le moteur d'inférence Mantle, utilisez l'API Projects. Si vous utilisez Invoke ou Converse APIs avec le point de terminaison bedrock-runtime, utilisez des profils d'inférence. Bien que vous puissiez utiliser l'API Chat Completions avec les points de terminaison bedrock-mantle ou bedrock-runtime, nous vous recommandons d'utiliser le point de terminaison Mantle.

Projets et comptes AWS

Les comptes AWS et 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 projets au lieu de comptes AWS distincts permet de :

Commencer à utiliser des projets

Cette page 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 de disposer des éléments suivants :

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

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

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

Utilisez l'list()API pour récupérer une liste de 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, fournissez 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 faites 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éé avec succès :

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 projet de base

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

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

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

Mettre à 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 des 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 clés :

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"

Utiliser des projets avec différents 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)

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