Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Proyectos (OpenAI-compatible)

La API de proyectos de Amazon Bedrock proporciona aislamiento a nivel de aplicación para sus cargas de trabajo generativas de IA mediante API. OpenAI-compatible Los proyectos le permiten organizar y gestionar sus aplicaciones de IA mejorando el control de acceso, el seguimiento de los costes y la observabilidad en toda la organización.

¿Qué es un proyecto?

Un proyecto es un límite lógico que se utiliza para aislar cargas de trabajo como aplicaciones, entornos o experimentos en Amazon Bedrock. Los proyectos proporcionan lo siguiente:

Los proyectos le permiten administrar múltiples cargas de trabajo generativas de IA en producción sin crear AWS cuentas u organizaciones independientes, lo que reduce la complejidad operativa y, al mismo tiempo, mantiene la seguridad y la gobernanza.

Cada AWS cuenta tiene un proyecto predeterminado al que están asociadas todas las solicitudes de inferencia. Puedes crear más proyectos en tu cuenta mediante la API de proyectos.

¿Cuándo usar los proyectos

Debes usar la API de proyectos cuando necesites:

Proyectos frente a perfiles de inferencia

Tanto la API de proyectos como los perfiles de inferencia ofrecen funciones de aislamiento, etiquetado y control de acceso en Amazon Bedrock, pero varían en función del punto final que utilice. Si utiliza OpenAI-compatible las API con el punto final de Bedrock-mantle, utilice la API de proyectos. Si usas el punto final de ejecución básico (recomendado para aplicaciones nuevas), usa los perfiles de inferencia. La API de finalización del chat está disponible en ambos terminales; la API de proyectos solo está disponible en. bedrock-mantle

Proyectos vs. AWS cuentas

Las cuentas y AWS organizaciones de AWS representan los límites de facturación y propiedad a nivel de infraestructura. Los proyectos representan los límites de la carga de trabajo y las aplicaciones dentro de una sola cuenta.

El uso de proyectos en lugar de AWS cuentas independientes proporciona:

Cómo empezar con Projects

En esta página, se explica cómo crear el primer proyecto, asociarlo a las solicitudes de inferencia y administrar los recursos del proyecto.

Requisitos previos

Antes de empezar, asegúrese de que tiene lo siguiente:

Paso 1: Configure su entorno

Configure las variables de entorno con sus credenciales de Amazon Bedrock:

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

<your-region>Sustitúyalas por las de tu AWS región (p. ej., us-east-1, us-west-2).

Paso 2: Descubre los modelos disponibles

Usa la list() API para recuperar una lista de modelos compatibles con la API de proyectos:

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

Paso 3: Crea tu primer proyecto

Cree un proyecto utilizando la API de creación de proyectos con etiquetas para el seguimiento de los costos y la observabilidad. Ten en cuenta que, por el momento, solo cURL es compatible con el 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

Respuesta:

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

Notas importantes:

Paso 4: Asocia las solicitudes de inferencia a tu proyecto

Para asociar tu proyecto a las solicitudes de inferencia, proporciona el ID del proyecto al crear el cliente:

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

Todas las solicitudes de inferencia realizadas con este cliente se asociarán al proyecto especificado, lo que garantiza un aislamiento, un seguimiento de los costos y un control de acceso adecuados.

Paso 5: Verifique la configuración de su proyecto

Enumere todos los proyectos para verificar que su proyecto se creó correctamente:

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

Respuesta:

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

Siguientes pasos

Ahora que has creado tu primer proyecto, puedes:

Trabajar con proyectos de

Esta página proporciona información detallada sobre la administración de proyectos a lo largo de su ciclo de vida.

Creación de proyectos

Creación de proyectos básicos

Crea un proyecto con un nombre, una descripción y etiquetas:

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

Puedes tener hasta 1000 proyectos por cuenta.

Convenciones de nomenclatura recomendadas

Usa nombres claros y descriptivos que reflejen tu estructura organizacional:

Listado de proyectos

Listar todos los proyectos

Recupera todos los proyectos de tu cuenta:

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

Recuperando los detalles del proyecto

Obtenga información detallada sobre un proyecto específico:

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

Actualización de proyectos

Modifique las propiedades del proyecto, como el nombre:

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

Administrar las etiquetas del proyecto

Agregue nuevas etiquetas o actualice los valores de las etiquetas existentes:

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

Elimine etiquetas específicas con sus claves:

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

Proyectos de archivado

Archiva los proyectos que ya no están en uso:

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

Uso de proyectos con diferentes 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)

Prácticas recomendadas

Estructura de proyecto recomendada

Un proyecto por aplicación: cree proyectos independientes para cada aplicación o servicio distinto.

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

Gestión del ciclo de vida del proyecto