View a markdown version of this page

Agent Builder - Generative AI Application Builder su AWS
AgentCore integrazioneConfigurazione dell'agenteStreaming ed elaborazioneGestione della memoriaOsservabilitàWorkflow Builder

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

  • 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_tokens, top_p 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+

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_tools:

  • 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

  2. Crea istanze locali di ogni agente Agent Builder

  3. Ogni agente mantiene le proprie connessioni al server MCP

  4. L'agente supervisore registra agenti specializzati come strumenti

  5. Strands SDK gestisce la selezione e la delega degli agenti