Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Progetti (OpenAI-compatible)

L'API Amazon Bedrock Projects fornisce l'isolamento a livello di applicazione per i carichi di lavoro di IA generativa tramite API. OpenAI-compatible I progetti ti consentono di organizzare e gestire le tue applicazioni di intelligenza artificiale con un migliore controllo degli accessi, monitoraggio dei costi e osservabilità in tutta l'organizzazione.

Che cos'è un progetto?

Un progetto è un limite logico utilizzato per isolare carichi di lavoro come applicazioni, ambienti o esperimenti all'interno di Amazon Bedrock. I progetti forniscono:

I progetti consentono di gestire più carichi di lavoro di intelligenza artificiale generativa in produzione senza creare AWS account o organizzazioni separati, riducendo la complessità operativa e mantenendo la sicurezza e la governance.

Ogni AWS account ha un progetto predefinito a cui sono associate tutte le richieste di inferenza. Puoi creare più progetti nel tuo account utilizzando l'API Projects.

Quando usare i progetti

È necessario utilizzare l'API Projects quando è necessario:

Progetti e profili di inferenza

Sia l'API di Projects che i profili di inferenza forniscono funzionalità di isolamento, etichettatura e controllo degli accessi in Amazon Bedrock, ma differiscono in base all'endpoint utilizzato. Se utilizzi OpenAI-compatible API con l'endpoint Endpoint supportati da Amazon Bedrock bedrock-mantle, utilizza l'API Projects. Se stai usando l'endpoint bedrock-runtime (consigliato per le nuove applicazioni), usa Inference Profiles. L'API Chat Completions è disponibile su entrambi gli endpoint; l'API Projects è disponibile solo su. bedrock-mantle

Progetti vs. AWS account

Gli account e AWS le organizzazioni AWS rappresentano i limiti di fatturazione e proprietà a livello di infrastruttura. I progetti rappresentano i limiti del carico di lavoro e delle applicazioni all'interno di un singolo account.

L'utilizzo di Projects anziché AWS account separati fornisce:

Guida introduttiva ai progetti

Questa pagina illustra come creare il primo progetto, associarlo alle richieste di inferenza e gestire le risorse del progetto.

Prerequisiti

Prima di iniziare, assicurati di avere:

Passaggio 1: configura il tuo ambiente

Configura le variabili di ambiente con le tue credenziali Amazon Bedrock:

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

<your-region>Sostituiscile con la tua AWS regione (ad esempio, us-east-1, us-west-2).

Fase 2: Scopri i modelli disponibili

Usa l'list()API per recuperare un elenco di modelli compatibili con l'API Projects:

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

Fase 3: Crea il tuo primo progetto

Crea un progetto utilizzando l'API Create Project con tag per il monitoraggio e l'osservabilità dei costi. Nota che al momento solo cURL è supportato nell'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

Risposta:

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

Note importanti:

Fase 4: Associa le richieste di inferenza al tuo progetto

Per associare il progetto alle richieste di inferenza, fornisci l'ID del progetto durante la creazione del 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")

Tutte le richieste di inferenza effettuate con questo client verranno associate al progetto specificato, garantendo il corretto isolamento, il monitoraggio dei costi e il controllo degli accessi.

Fase 5: Verifica la configurazione del progetto

Elenca tutti i progetti per verificare che il progetto sia stato creato correttamente:

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

Risposta:

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

Fasi successive

Ora che hai creato il tuo primo progetto, puoi:

Utilizzo dei progetti

Questa pagina fornisce informazioni dettagliate sulla gestione dei progetti durante il loro ciclo di vita.

Creazione di progetti

Creazione di progetti di base

Crea un progetto con nome, descrizione e tag:

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

Puoi avere fino a 1000 progetti per account.

Convenzioni di denominazione consigliate

Usa nomi chiari e descrittivi che riflettano la tua struttura organizzativa:

Elenco dei progetti

Elenca tutti i progetti

Recupera tutti i progetti nel tuo account:

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

Recupero dei dettagli del progetto

Ottieni informazioni dettagliate su un progetto specifico:

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

Aggiornamento dei progetti

Modifica le proprietà del progetto, ad esempio il 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"
  }'

Gestione dei tag del progetto

Aggiungere nuovi tag o aggiornare i valori dei tag esistenti:

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

Rimuovi tag specifici con le relative chiavi:

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

Archiviazione dei progetti

Archivia i progetti che non sono più in uso:

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

Utilizzo di progetti con API diverse

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)

Best practice

Struttura del progetto consigliata

Un progetto per applicazione: crea progetti separati per ogni applicazione o servizio distinto.

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

Gestione del ciclo di vita del progetto