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.

API de proyectos

La API de Amazon Bedrock Projects proporciona aislamiento a nivel de aplicación para sus cargas de trabajo de IA generativa mediante la compatibilidad con OpenAI. APIs Los proyectos le permiten organizar y gestionar sus aplicaciones de IA con un mejor control de acceso, un seguimiento de los costes y una mejor 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 dentro de Amazon Bedrock. Los proyectos proporcionan lo siguiente:

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

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

Cuándo usar los proyectos

Deberías usar la API de proyectos cuando necesites:

Proyectos frente a perfiles de inferencia

Tanto la API de proyectos como los perfiles de inferencia proporcionan capacidades de aislamiento, etiquetado y control de acceso en Amazon Bedrock, pero difieren según la API que utilice. Si utilizas OpenAI compatible APIs con el punto final bedrock-mantle, que usa el motor de inferencia Mantle, usa la API Projects. Si utilizas Invoke o Converse con el terminal de tiempo de ejecución sólido, usa los perfiles de inferencia APIs . Si bien puedes usar la API Chat Completions con puntos de enlace con tiempo de ejecución sólido o sólido, te recomendamos que utilices el punto final de Mantle.

Proyectos frente a cuentas de AWS

Las cuentas de AWS y AWS Organizations 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 de las aplicaciones dentro de una sola cuenta.

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

Cómo empezar con los proyectos

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 comenzar, asegúrese de que dispone de 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úyala por tu región de AWS (p. ej., us-east-1, us-west-2).

Paso 2: Descubra los modelos disponibles

Utilice 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 mediante la API Create Project con etiquetas para monitorear los costos y observarlos. Tenga en cuenta que, por el momento, el SDK solo admite cURL.

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: Asocie las solicitudes de inferencia a su 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 garantizará el aislamiento, el seguimiento de los costes y el control de acceso adecuados.

Paso 5: Verifique la configuración del proyecto

Enumere todos los proyectos para verificar que su proyecto se haya creado 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 gestión de los proyectos a lo largo de su ciclo de vida.

Creación de proyectos

Creación básica de proyectos

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

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

Puedes tener hasta 1000 proyectos por cuenta.

Convenciones de nomenclatura recomendadas

Usa nombres descriptivos y claros que reflejen la estructura de tu organización:

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

Archivar proyectos

Archivar proyectos que ya no se utilizan:

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

Prácticas recomendadas

Estructura de proyecto recomendada

Un proyecto por aplicación: cree proyectos separados 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