View a markdown version of this page

Configurazione di Agent Builder - Generative AI Application Builder su AWS
Configurazione del prompt di sistemaIntegrazione del server MCPImpostazioni della memoriaMonitoraggio delle implementazioni di Agent 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à.

Configurazione di Agent Builder

Agent Builder offre opzioni di configurazione complete per la creazione di agenti AI pronti per la produzione. Questa sezione descrive come configurare e gestire le distribuzioni di Agent Builder.

Configurazione del prompt di sistema

Il prompt di sistema definisce il comportamento, la personalità e le capacità dell'agente. Per configurare il prompt di sistema:

  1. Nella procedura guidata di Agent Builder, vai al passaggio Configura agente.

  2. Modifica il modello di prompt di sistema nell'editor di testo.

  3. Includi istruzioni chiare per:

    • Ruolo e scopo dell'agente

    • Come utilizzare gli strumenti disponibili (server MCP)

    • Preferenze di formattazione delle risposte

    • Linee guida comportamentali

  4. Se necessario, utilizzate il pulsante Ripristina le impostazioni predefinite per ripristinare il modello originale.

Procedure consigliate per i prompt degli agenti:

  • Sii specifico sulle capacità e i limiti dell'agente

  • Fornisci esempi chiari del comportamento desiderato

  • Includi istruzioni per l'utilizzo degli strumenti e quando richiamarli

  • Definisci le aspettative relative al formato di risposta

  • Stabilisci dei limiti per il comportamento degli agenti

Integrazione del server MCP

I server Model Context Protocol (MCP) forniscono agli agenti l'accesso a strumenti e fonti di dati aziendali. Per configurare i server MCP:

  1. Nel passaggio Configure Agent, individua la sezione Server MCP.

  2. Seleziona uno dei server MCP disponibili nel menu a discesa.

Nota

I server MCP devono essere configurati e accessibili prima della distribuzione degli agenti. L'agente scoprirà e utilizzerà automaticamente gli strumenti esposti dai server MCP configurati. Fate riferimento alla documentazione MCP per la configurazione del server e degli strumenti.

Impostazioni della memoria

Agent Builder fornisce due tipi di memoria per mantenere il contesto e le conoscenze:

Memoria a breve termine

Attivato per impostazione predefinita per tutti gli agenti:

  • Mantiene il contesto della conversazione all'interno delle sessioni

  • Acquisisce automaticamente i messaggi degli utenti e le risposte degli agenti

  • Organizzato da actorID e sessionID per un corretto isolamento

  • Nessuna configurazione richiesta

Memoria a lungo termine

Funzionalità opzionale per l'archiviazione di informazioni dettagliate tra le sessioni:

  1. Nel passaggio Configure Agent, individua la sezione Configurazione della memoria.

  2. Attiva Abilita l'attivazione della memoria a lungo termine.

  3. Se abilitato, l'agente può:

    • Estrarre e archiviare informazioni importanti tra le conversazioni

    • Recupera il contesto pertinente dalle sessioni precedenti

    • Acquisisci conoscenze sulle preferenze e sulla cronologia degli utenti

Nota

La memoria a lungo termine utilizza AgentCore la memoria con una strategia di memoria semantica e impostazioni di conservazione predefinite.

Monitoraggio delle implementazioni di Agent Builder

Agent Builder offre un monitoraggio completo tramite CloudWatch dashboard e metriche.

CloudWatch Accesso ai pannelli di controllo

  1. Accedi alla CloudWatch console nel tuo account AWS.

  2. Seleziona Dashboard dalla barra di navigazione a sinistra.

  3. Trova il nome AgentBuilder-<UseCaseId> del pannello di controllo.

  4. Visualizza le metriche in tempo reale e i dati storici sulle prestazioni.

Accesso e analisi dei log

I registri degli agenti sono disponibili nella sezione CloudWatch Registri:

  1. Accedi a CloudWatch Logs nella console AWS.

  2. Trova i gruppi di log con il prefisso. /aws/bedrock-agentcore/runtimes/

  3. Usa CloudWatch Insights per interrogare e analizzare i log.

  4. Cerca modelli di richiesta IDs o errore specifici.