As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

API de projetos

A API Amazon Bedrock Projects fornece isolamento em nível de aplicativo para suas cargas de trabalho generativas de IA usando a API compatível com OpenAI. APIs Os projetos permitem que você organize e gerencie seus aplicativos de IA com controle de acesso aprimorado, controle de custos e observabilidade em toda a organização.

O que é um projeto?

Um projeto é um limite lógico usado para isolar cargas de trabalho, como aplicativos, ambientes ou experimentos no Amazon Bedrock. Os projetos fornecem:

Os projetos permitem que você gerencie várias cargas de trabalho de IA generativas na produção sem criar contas ou organizações separadas da AWS, reduzindo a complexidade operacional e mantendo a segurança e a governança.

Cada conta da AWS tem um projeto padrão ao qual todas as solicitações de inferência são associadas a. Você pode criar mais projetos em sua conta usando a API de projetos.

Quando usar projetos

Você deve usar a API de projetos quando precisar:

Projetos versus perfis de inferência

Tanto a API de projetos quanto os perfis de inferência fornecem recursos de isolamento, marcação e controle de acesso no Amazon Bedrock, mas eles diferem com base na API que você usa. Se você estiver usando OpenAI compatível APIs com o endpoint bedrock-mantle, que usa o mecanismo de inferência Mantle, use a API de projetos. Se você estiver usando Invoke ou Converse APIs com o endpoint bedrock-runtime, use Perfis de inferência. Embora você possa usar a API Chat Completions com endpoints bedrock-mantle ou bedrock-runtime, recomendamos que você use o endpoint Mantle.

Projetos versus contas da AWS

As contas da AWS e as organizações da AWS representam os limites de faturamento e propriedade no nível da infraestrutura. Os projetos representam os limites da carga de trabalho e dos aplicativos em uma única conta.

O uso de projetos em vez de contas separadas da AWS fornece:

Começando com projetos

Esta página explica como criar seu primeiro projeto, associá-lo a solicitações de inferência e gerenciar os recursos do projeto.

Pré-requisitos

Antes de começar, verifique se você tem:

Etapa 1: configurar seu ambiente

Configure suas variáveis de ambiente com suas credenciais do Amazon Bedrock:

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

<your-region>Substitua pela sua região da AWS (por exemplo, us-east-1, us-west-2).

Etapa 2: Descubra os modelos disponíveis

Use a list() API para recuperar uma lista de modelos compatíveis com a API de projetos:

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

Etapa 3: Crie seu primeiro projeto

Crie um projeto usando a API Create Project com tags para monitoramento de custos e observabilidade. Observe que, no momento, somente cURL é compatível com o 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

Resposta:

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

Etapa 4: associar solicitações de inferência ao seu projeto

Para associar seu projeto às solicitações de inferência, forneça o ID do projeto ao criar o 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 as solicitações de inferência feitas com esse cliente serão associadas ao projeto especificado, garantindo isolamento adequado, controle de custos e controle de acesso.

Etapa 5: verifique a configuração do seu projeto

Liste todos os projetos para verificar se seu projeto foi criado com sucesso:

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

Resposta:

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

Próximas etapas

Agora que você criou seu primeiro projeto, você pode:

Como trabalhar com projetos do

Esta página fornece informações detalhadas sobre o gerenciamento de projetos em todo o ciclo de vida.

Criação de projetos

Criação básica de projetos

Crie um projeto com nome, descrição e tags:

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

Você pode ter até 1000 projetos por conta.

Convenções de nomenclatura recomendadas

Use nomes claros e descritivos que reflitam sua estrutura organizacional:

Listando projetos

Listar todos os projetos

Recupere todos os projetos em sua conta:

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

Recuperando detalhes do projeto

Obtenha informações detalhadas sobre um projeto específico:

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

Atualizando projetos

Modifique as propriedades do projeto, como o nome:

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

Gerenciando tags de projeto

Adicione novas tags ou atualize os valores 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"
    }
  }'

Remova tags específicas usando suas chaves:

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

Projetos de arquivamento

Arquive projetos que não estão mais em uso:

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

Usando projetos com 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áticas recomendadas

Estrutura de projeto recomendada

Um projeto por aplicativo: crie projetos separados para cada aplicativo ou serviço distinto.

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

Gerenciamento do ciclo de vida do projeto