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
<a name="configuring-agent-builder"></a>

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
<a name="system-prompt-configuration"></a>

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.

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

1. Includi istruzioni chiare per:
   + Ruolo e scopo dell'agente
   + Come utilizzare gli strumenti disponibili (server MCP)
   + Preferenze di formattazione delle risposte
   + Linee guida comportamentali

1. 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
<a name="mcp-server-integration"></a>

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

1. 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
<a name="memory-settings"></a>

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

1. Attiva **Abilita l'attivazione della memoria a lungo termine**.

1. 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
<a name="monitoring-agent-builder"></a>

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.

1. Seleziona **Dashboard** dalla barra di navigazione a sinistra.

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

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

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

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

1. Cerca modelli di richiesta IDs o errore specifici.