Crea un agente per la tua applicazione - Amazon Bedrock

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

Crea un agente per la tua applicazione

Per creare un agente con Amazon Bedrock, configuri i seguenti componenti:

  • La configurazione dell'agente, che definisce lo scopo dell'agente e indica il modello di base (FM) che utilizza per generare richieste e risposte.

  • Almeno uno dei seguenti:

    • Gruppi di azioni che definiscono le azioni per cui l'agente è progettato.

    • Una base di conoscenza di fonti di dati per aumentare le capacità generative dell'agente consentendo la ricerca e l'interrogazione.

È possibile creare in minima parte un agente che abbia solo un nome. Per preparare un agente in modo da poterlo testare o distribuire, è necessario configurare almeno i seguenti componenti:

Configurazione Descrizione
Ruolo delle risorse dell'agente Il ruolo ARN di servizio con le autorizzazioni per richiamare API le operazioni sull'agente
Modello Foundation (FM) Un FM che l'agente può richiamare per eseguire l'orchestrazione
Istruzioni Linguaggio naturale che descrive cosa deve fare l'agente e come deve interagire con gli utenti

È inoltre necessario configurare almeno un gruppo di azione o una knowledge base per l'agente. Se prepari un agente senza gruppi di azione o knowledge base, restituirà risposte basate solo sulla FM, sulle istruzioni e sui modelli di prompt di base.

Per imparare a creare un agente, seleziona la scheda corrispondente al metodo che preferisci e segui i passaggi.

Console
Per creare un agente

  1. Accedi al AWS Management Console utilizzando un IAMruolo con autorizzazioni Amazon Bedrock e apri la console Amazon Bedrock all'indirizzo. https://console.aws.amazon.com/bedrock/

  2. Seleziona Agenti dal riquadro di navigazione a sinistra.

  3. Nella sezione Agenti, scegli Crea agente.

  4. (Facoltativo) Modifica il nome generato automaticamente per l'agente e fornisci una descrizione facoltativa.

  5. Scegli Create (Crea) . Il tuo agente viene creato e verrai indirizzato all'Agent Builder dell'agente appena creato, dove puoi configurarlo.

  6. Puoi continuare con la seguente procedura per configurare l'agente o tornare all'Agent Builder in un secondo momento.

Per configurare il tuo agente

  1. Se non sei già nell'Agent Builder, procedi come segue:

    1. Accedi a AWS Management Console utilizzando un IAMruolo con autorizzazioni Amazon Bedrock e apri la console Amazon Bedrock all'indirizzo. https://console.aws.amazon.com/bedrock/

    2. Seleziona Agenti dal riquadro di navigazione a sinistra. Quindi, scegli un agente nella sezione Agenti.

    3. Scegli Modifica in Agent Builder.

  2. Nella sezione Dettagli dell'agente, puoi configurare le seguenti configurazioni:

    1. Modificare il nome o la descrizione dell'agente.

    2. Per il ruolo di risorsa Agente, selezionate una delle seguenti opzioni:

      • Crea e usa un nuovo ruolo di servizio: lascia che Amazon Bedrock crei il ruolo di servizio e configuri le autorizzazioni richieste per tuo conto.

      • Usa un ruolo di servizio esistente: utilizza un ruolo personalizzato che hai impostato in precedenza.

    3. Per Select model, selezionate un FM che il vostro agente possa richiamare durante l'orchestrazione.

    4. In Istruzioni per l'agente, inserisci i dettagli per dire all'agente cosa deve fare e come deve interagire con gli utenti. Le istruzioni sostituiscono il segnaposto $instructions$ nel modello di prompt di orchestrazione. Di seguito è riportato un esempio di istruzioni:

      You are an office assistant in an insurance agency. You are friendly and polite. You help with managing insurance claims and coordinating pending paperwork.

    5. Se espandi Impostazioni aggiuntive, puoi modificare le seguenti configurazioni:

      Input dell'utente: scegli se consentire all'agente di richiedere ulteriori informazioni all'utente se non dispone di informazioni sufficienti.

      • Se scegli Abilitato, l'agente restituisce un'osservazione che richiede all'utente ulteriori informazioni se deve richiamare un membro di un API gruppo di azioni, ma non dispone di informazioni sufficienti per completare la richiesta. API

      • Se scegli Disabilitato, l'agente non richiede all'utente ulteriori dettagli e lo informa invece che non dispone di informazioni sufficienti per completare l'attività.

      • KMSselezione delle chiavi: (Facoltativo) Per impostazione predefinita, AWS crittografa le risorse dell'agente con una chiave AWS gestita. Per crittografare il tuo agente con la tua chiave gestita dal cliente, nella sezione di selezione delle KMS chiavi, seleziona Personalizza le impostazioni di crittografia (avanzate). Per creare una nuova chiave, seleziona Crea una AWS KMS chiave, quindi aggiorna questa finestra. Per utilizzare una chiave esistente, seleziona una chiave per Scegli una AWS KMS chiave.

      • Timeout della sessione inattiva: per impostazione predefinita, se un utente non risponde per 30 minuti in una sessione con un agente Amazon Bedrock, l'agente non conserva più la cronologia delle conversazioni. La cronologia delle conversazioni viene utilizzata sia per riprendere un'interazione sia per aumentare le risposte in base al contesto della conversazione. Per modificare questo periodo di tempo predefinito, inserisci un numero nel campo Timeout della sessione e scegli un'unità di tempo.

    6. Nella sezione delle IAMautorizzazioni, per il ruolo di risorsa dell'agente, scegli un ruolo di servizio. Per consentire ad Amazon Bedrock di creare il ruolo di servizio per tuo conto, scegli Crea e usa un nuovo ruolo di servizio. Per utilizzare un ruolo personalizzato creato in precedenza, scegli Usa un ruolo di servizio esistente.

      Nota

      Il ruolo di servizio che Amazon Bedrock crea per te non include le autorizzazioni per le funzionalità disponibili in anteprima. Per utilizzare queste funzionalità, assegna le autorizzazioni corrette al ruolo di servizio.

    7. (Facoltativo) Per impostazione predefinita, AWS crittografa le risorse dell'agente con un Chiave gestita da AWS. Per crittografare il tuo agente con la tua chiave gestita dal cliente, nella sezione di selezione delle KMS chiavi, seleziona Personalizza le impostazioni di crittografia (avanzate). Per creare una nuova chiave, seleziona Crea un AWS KMS chiave e quindi aggiorna questa finestra. Per usare una chiave esistente, seleziona una chiave per Scegli un AWS KMS chiave.

    8. (Facoltativo) Per associare tag a questo agente, nella sezione Tag — opzionale, scegli Aggiungi nuovo tag e fornisci una coppia chiave-valore.

    9. Al termine della configurazione dell'agente, seleziona Avanti.

  3. Nella sezione Gruppi di azioni, puoi scegliere Aggiungi per aggiungere gruppi di azioni al tuo agente. Per ulteriori informazioni sulla configurazione dei gruppi di azione, consultaUtilizza i gruppi di azioni per definire le azioni da eseguire per il tuo agente. Per informazioni su come aggiungere gruppi di azioni al tuo agente, consultaAggiungi un gruppo d'azione al tuo agente in Amazon Bedrock.

  4. Nella sezione Knowledge base, puoi scegliere Aggiungi per associare i gruppi di conoscenza al tuo agente. Per ulteriori informazioni sulla configurazione delle knowledge base, consultaRecupera dati e genera risposte AI con le knowledge base. Per informazioni su come associare le knowledge base al proprio agente, consultaAumenta la generazione di risposte per il tuo agente con la knowledge base.

  5. Nella sezione dei dettagli di Guardrails, puoi scegliere Modifica per associare un guardrail al tuo agente per bloccare e filtrare i contenuti dannosi. Seleziona un guardrail che desideri utilizzare dal menu a discesa sotto Seleziona guardrail, quindi scegli la versione da utilizzare in Versione Guardrail. Puoi selezionare Visualizza per vedere le impostazioni di Guardrail. Per ulteriori informazioni, consulta Blocca i contenuti dannosi nei modelli che utilizzano Amazon Bedrock Guardrails.

  6. Nella sezione Richieste avanzate, puoi scegliere Modifica per personalizzare le istruzioni che vengono inviate alla FM dal tuo agente in ogni fase dell'orchestrazione. Per ulteriori informazioni sui modelli di prompt che è possibile utilizzare per la personalizzazione, vedere. Migliora la precisione degli agenti utilizzando modelli di prompt avanzati in Amazon Bedrock Per informazioni su come configurare i prompt avanzati, consulta. Configurazione di modelli di prompt avanzati

  7. Al termine della configurazione dell'agente, seleziona una delle seguenti opzioni:

    • Per rimanere nell'Agent Builder, scegli Salva. Puoi quindi preparare l'agente per testarlo con le configurazioni aggiornate nella finestra di test. Per sapere come testare il tuo agente, consultaVerifica e risolvi i problemi del comportamento degli agenti.

    • Per tornare alla pagina dei dettagli dell'agente, scegli Salva ed esci.

API

Per creare un agente, invia un CreateAgentrichiesta (consulta il link per i formati di richiesta e risposta e i dettagli sui campi) con un endpoint in fase di costruzione Agents for Amazon Bedrock.

Vedi esempi di codice

Per preparare il tuo agente e testarlo o installarlo, in modo da poterlo testare o distribuire, devi includere almeno i seguenti campi (se preferisci, puoi saltare queste configurazioni e configurarle in un secondo momento inviando un UpdateAgentrichiesta):

Campo Caso d'uso
agentResourceRoleBraccio Specificare uno ARN dei ruoli di servizio con le autorizzazioni per chiamare API le operazioni sull'agente
foundationModel Per specificare un modello di base (FM) con cui l'agente può orchestrare
istruzione Fornire istruzioni per dire all'agente cosa fare. Utilizzato nel segnaposto $instructions$ del modello di prompt di orchestrazione.

I seguenti campi sono facoltativi:

Campo Caso d'uso
description Descrive cosa fa l'agente
idleSessionTTLInSeconds Durata dopo la quale l'agente termina la sessione ed elimina tutte le informazioni memorizzate.
customerEncryptionKeyArn ARNdi una KMS chiave per crittografare le risorse degli agenti
tags Per associare i tag al tuo agente.
promptOverrideConfiguration Per personalizzare i prompt inviati alla FM in ogni fase dell'orchestrazione.
guardrailConfiguration Per aggiungere un guardrail all'agente. Specificare l'ID o ARN del guardrail e la versione da utilizzare.
clientToken Identificatore per garantire che la API richiesta venga completata una sola volta.

La risposta restituisce un CreateAgentoggetto che contiene dettagli sull'agente appena creato. Se il tuo agente non viene creato, CreateAgentl'oggetto nella risposta restituisce un elenco di failureReasons e un elenco recommendedActions di cui risolvere i problemi.