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à.

API dei progetti

L'API Amazon Bedrock Projects fornisce l'isolamento a livello di applicazione per i carichi di lavoro di intelligenza artificiale generativa utilizzando la compatibilità con OpenAI. APIs I progetti ti consentono di organizzare e gestire le tue applicazioni AI con un migliore controllo degli accessi, il monitoraggio dei costi e l'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 account o organizzazioni AWS separati, riducendo la complessità operativa e mantenendo la sicurezza e la governance.

Ogni account AWS 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 Projects che i profili di inferenza forniscono funzionalità di isolamento, etichettatura e controllo degli accessi in Amazon Bedrock, ma differiscono in base all'API utilizzata. Se utilizzi OpenAI compatibile APIs con l'endpoint bedrock-mantle, che utilizza il motore di inferenza Mantle, usa l'API Projects. Se utilizzi Invoke o Converse con l'endpoint bedrock-runtime, usa Inference Profiles. APIs Sebbene tu possa utilizzare l'API Chat Completions con endpoint bedrock-mantle o bedrock-runtime, ti consigliamo di utilizzare l'endpoint Mantle.

Progetti e account AWS

Gli account AWS e AWS Organizations 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é account AWS separati offre:

Guida introduttiva a Projects

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

Prerequisiti

Prima di iniziare, assicurati di disporre dei seguenti elementi:

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

Sostituisci <your-region> con la tua regione AWS (ad es. 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"

Passaggio 3: crea il tuo primo progetto

Crea un progetto utilizzando l'API Create Project con tag per il monitoraggio dei costi e l'osservabilità. 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: Associare le richieste di inferenza al progetto

Per associare il tuo 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 un isolamento adeguato, il monitoraggio dei costi e il controllo degli accessi.

Fase 5: Verifica della 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/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"
    }
  }'

Puoi avere fino a 1000 progetti per account.

Convenzioni di denominazione consigliate

Usa nomi chiari e descrittivi che rispecchino 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 come 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 di progetto

Aggiungi nuovi tag o aggiorna 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 tramite le loro 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 caratteristiche diverse 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)

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