

# Prerequisiti
<a name="insights-prerequisites"></a>

Prima di iniziare a utilizzare AgentCore Insights, assicurati di disporre di quanto segue:

**Topics**
+ [Requisiti](#insights-prereqs-requirements)
+ [autorizzazioni IAM](#insights-prereqs-iam)
+ [Ruolo di esecuzione](#insights-prereqs-execution-role)

## Requisiti
<a name="insights-prereqs-requirements"></a>
+  ** AWS Account** con autorizzazioni IAM appropriate
+  CloudWatchAccesso ad **Amazon** per leggere le tracce delle sessioni degli agenti e visualizzare i risultati delle analisi
+  **Transaction Search** è abilitato in CloudWatch : consulta [AgentCore Observability per le istruzioni di](observability.md) configurazione
+  ** AWS Distro for OpenTelemetry (ADOT) SDK** strumenta il tuo agente: il tuo agente deve emettere tracce nei log CloudWatch 
+  **Un agente attivo** con almeno una sessione completata che produca tracce nei registri CloudWatch 

## autorizzazioni IAM
<a name="insights-prereqs-iam"></a>

Il tuo utente o ruolo IAM necessita delle seguenti autorizzazioni per configurare ed eseguire Insights:

```
{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateOnlineEvaluationConfig",
                "bedrock-agentcore:GetOnlineEvaluationConfig",
                "bedrock-agentcore:ListOnlineEvaluationConfigs",
                "bedrock-agentcore:UpdateOnlineEvaluationConfig",
                "bedrock-agentcore:DeleteOnlineEvaluationConfig",
                "bedrock-agentcore:StartBatchEvaluation",
                "bedrock-agentcore:GetBatchEvaluation",
                "bedrock-agentcore:ListBatchEvaluations"
            ],
            "Resource": "*"
        }
    ]
}
```

## Ruolo di esecuzione
<a name="insights-prereqs-execution-role"></a>

La configurazione di valutazione online richiede un ruolo di esecuzione (`evaluationExecutionRoleArn`) che consenta al servizio di:
+ Leggere le tracce dai CloudWatch log
+ Richiama i modelli Amazon Bedrock per l'analisi delle informazioni
+ Archivia e recupera i risultati delle analisi

Se hai già configurato un ruolo di esecuzione per AgentCore Evaluations, lo stesso ruolo funziona per gli approfondimenti. Vedi [Evaluations Prerequisiti](evaluations-prerequisites.md) per i dettagli sulla creazione di questo ruolo.

**Nota**  
Se prevedi di utilizzare i risultati di Insights per generare configurazioni ottimizzate tramite [consigli di AgentCore ottimizzazione](optimization-recommendations.md), sono necessari anche`bedrock-agentcore:StartRecommendation`, `bedrock-agentcore:GetRecommendation``bedrock-agentcore:ListRecommendations`, e `bedrock-agentcore:DeleteRecommendation` le autorizzazioni. Per i dettagli, consulta [Prerequisiti di ottimizzazione](optimization-prereqs.md).