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à.
# Agent Builder
Agent Builder fornisce una piattaforma per la creazione, la distribuzione e la gestione di agenti AI pronti per la produzione su Amazon Bedrock. AgentCore Questa sezione descrive i componenti tecnici e i dettagli di implementazione.
## AgentCore integrazione
Agent Builder utilizza un approccio di distribuzione basato sulla configurazione con immagini predefinite degli agenti per consentire implementazioni rapide, sicure e scalabili.
**Immagini predefinite degli agenti**
Le immagini dei container degli agenti vengono create dal team GAAB durante la CI/CD pipeline e pubblicate in un repository ECR pubblico. Ogni versione dell'immagine è collegata alla versione della soluzione GAAB (ad esempio, v4.0.0 →:v4.0.0). gaab-strands-agent Le immagini sono basate su Strands SDK e includono:
+ Ambiente di runtime dell'agente
+ Integrazione del client MCP
+ Funzionalità di gestione della memoria
+ OpenTelemetry strumentazione
**Cache pull-through ECR**
La soluzione utilizza ECR Pull-Through Cache per distribuire automaticamente le immagini degli agenti dall'archivio ECR pubblico all'ECR privato del cliente. Questo servizio gestito da AWS:
+ Memorizza le immagini nella cache alla prima estrazione (ritardo di 2-5 minuti)
+ Elimina la logica di copia personalizzata delle immagini
+ Fornisce la disponibilità locale delle immagini per le distribuzioni successive
+ Crea regole di cache uniche per ogni distribuzione per evitare conflitti
**Archiviazione della configurazione**
Le configurazioni degli agenti sono archiviate in DynamoDB insieme alle configurazioni dei casi d'uso esistenti. Ogni configurazione include:
+ Modello di prompt di sistema
+ Fornitore e ID del modello
+ Parametri del modello (temperatura, max\$1tokens)
+ Riferimenti ed endpoint del server MCP
+ Impostazioni della memoria (commutazione della memoria a lungo termine)
+ Metadati di distribuzione
**Registro delle versioni dell'immagine**
Una tabella DynamoDB tiene traccia delle versioni delle immagini degli agenti disponibili e della relativa URIs cache, abilitando la gestione delle versioni e la compatibilità con le versioni precedenti.
## Configurazione dell'agente
**Richieste di sistema**
I prompt di sistema definiscono il comportamento, la personalità e le capacità degli agenti. Gli utenti amministratori possono:
+ Modificare il modello predefinito tramite l'interfaccia utente di Agent Builder
+ Include istruzioni per l'utilizzo degli strumenti e la formattazione delle risposte
+ Ripristina il modello predefinito in qualsiasi momento
**Selezione del modello**
Agent Builder supporta i modelli Amazon Bedrock nella versione 4.0.0:
+ Fornitore del modello: Amazon Bedrock (solo opzione nella versione 4.0.0)
+ Selezione del modello: Claude, Nova e altri modelli Bedrock
+ Parametri del modello: Temperature, max\$1tokens, top\$1p e impostazioni specifiche del modello
**Integrazione con server MCP**
I server Model Context Protocol forniscono agli agenti l'accesso a strumenti e dati aziendali:
+ Individuazione dei server tramite l'endpoint API GET /mcp
+ Configurazione dinamica senza modifiche al codice
+ Autenticazione e gestione degli endpoint
+ Esposizione delle funzionalità degli strumenti agli agenti
## Streaming ed elaborazione
**Streaming in tempo reale**
Agent Builder utilizza Server-Sent Events (SSE) da AgentCore bridge a per WebSocket lo streaming di risposte in tempo reale:
+ La funzione Lambda stabilisce la connessione SSE a Runtime AgentCore
+ Gli stream sono collegati all'API Gateway WebSocket
+ Consente la consegna delle token-by-token risposte ai clienti
+ Mantiene la connessione per le richieste di lunga durata
**Vincoli di elaborazione**
L'elaborazione dell'agente nella v4.0.0 è limitata al timeout di esecuzione Lambda:
+ Tempo massimo di elaborazione: 15 minuti
+ Modello di elaborazione sincrona
+ Adatto per agenti conversazionali e flussi di lavoro moderati
+ Supporto asincrono esteso previsto per la versione 4.1\$1
## Gestione della memoria
**Memoria a breve termine**
Abilitato per impostazione predefinita per tutti gli agenti che utilizzano una configurazione personalizzata MemoryHookProvider:
+ Cattura gli eventi di conversazione tramite i gestori di callback di Strands
+ Organizza per actorID e sessionID per l'isolamento del contesto
+ Mantiene il contesto della conversazione all'interno delle sessioni
+ Integrazione automatica con la AgentCore memoria
**Memoria a lungo termine**
Funzionalità opzionale che utilizza AgentCore Memory Tool di strands\$1tools:
+ Attivazione semplice nell'interfaccia utente di Agent Builder
+ Strategia di memoria semantica con impostazioni predefinite
+ Accesso controllato dall'agente tramite invocazione naturale degli strumenti
+ Memorizza le informazioni estratte tra le sessioni
+ Utilizza ConversationID come SessionID
## Osservabilità
** OpenTelemetry Distribuzione AWS (ADOT)**
Gli agenti vengono dotati automaticamente di strumenti durante la creazione del container:
+ Generazione automatica di tracce per le operazioni degli agenti
+ Tracciamento distribuito attraverso i confini del servizio
+ Registrazione strutturata con correlazione IDs
+ Integrazione con Transaction Search CloudWatch
**Flusso di autenticazione**
Gli utenti si autenticano tramite Amazon Cognito con token JWT convalidati da autorizzatori Lambda personalizzati che recuperano le policy IAM da DynamoDB in base ai gruppi di utenti.
## Workflow Builder
Workflow Builder consente l'orchestrazione multiagente creando un agente supervisore che coordina più agenti Agent Builder utilizzando il modello di delega Agents as Tools.
### Architettura del workflow
**Componenti chiave**
+ Agente **supervisore: agente** Entrypoint che riceve le richieste degli utenti e delega ad agenti specializzati
+ **Agenti specializzati: Agent** Builder utilizza casi registrati come strumenti per il supervisore
+ **Agent Registry**: tabella DynamoDB che memorizza le configurazioni e i metadati degli agenti
+ Livello di **orchestrazione: implementazione del pattern Agents as Tools tramite Strands** SDK
### Istanziazione dell'agente
**Creazione di agenti locali**
Tutti gli agenti specializzati vengono istanziati localmente all'interno dello stesso AgentCore Runtime:
1. Recupera le configurazioni degli agenti da DynamoDB
1. Crea istanze locali di ogni agente Agent Builder
1. Ogni agente mantiene le proprie connessioni al server MCP
1. L'agente supervisore registra agenti specializzati come strumenti
1. Strands SDK gestisce la selezione e la delega degli agenti