Prerequisiti

Nota

La configurazione e l’invocazione di una funzionalità di agente in linea è una versione in anteprima per Amazon Bedrock ed è soggetta a modifiche.

Completa i seguenti prerequisiti prima di invocare l’agente in linea:

1. Decidi il modello di fondazione che desideri utilizzare per configurare l’agente in linea, la Regione in cui desideri invocare l’agente e un’istruzione che indichi all’agente in linea cosa deve fare.

2. Crea o prepara una o più delle seguenti proprietà di Agent per Amazon Bedrock che desideri utilizzare per il l’agente in linea.

   Campo	Caso d’uso
   actionGroups	Fornisci un elenco di gruppi di azione con ciascun gruppo di azioni che definisce le azioni che l’agente in linea può eseguire. Ad esempio, è possibile definire un gruppo di azioni Appointment che aiuti gli utenti a eseguire azioni come CreateAppointment GetAppointment CancelAppointment,, ecc.
   guardrailConfiguration	Configura i guardrail per bloccare gli argomenti, prevenire allucinazioni e implementare misure di sicurezza per l’applicazione.
   knowledgeBases	Associa knowledgeBases all’agente in linea per aumentare la risposta generata dal modello. Le knowledge base possono essere utilizzate non solo per rispondere alle domande degli utenti e per analizzare i documenti, ma anche per aumentare i prompt forniti ai modelli di fondazione, fornendo un contesto al prompt.
   promptOverridenConfiguration	Configura i prompt di override in diverse parti di una sequenza di agenti per migliorare la precisione dell’agente in linea.
   customerEncryptionArn	Specificate l'Amazon Resource Name (ARN) della AWS KMS chiave da utilizzare per crittografare il vostro agente in linea.

3. Crea un ruolo AWS Identity and Access Management (IAM) e associa al ruolo la policy menzionata in questo passaggio.

   Prima di poter invocare un agente in linea, devi creare un ruolo IAM che fornisca le autorizzazioni necessarie per utilizzare l’API InvokeInlineAgent e accedere a risorse come funzioni Lambda, knowledge base e modelli di fondazione.

   Crea un ruolo di servizio personalizzato per l’agente in linea seguendo le fasi in Creazione di un ruolo per delegare le autorizzazioni a un utente IAM. Dopo aver creato il ruolo IAM, collega al ruolo la seguente policy.

   Nota

   Come procedura consigliata per motivi di sicurezza, sostituisci ${region}${account-id}, e *.ids con Region, l'ID dell'account e gli ID delle risorse specifici dopo averli creati.