Seleziona le tue preferenze relative ai cookie

Utilizziamo cookie essenziali e strumenti simili necessari per fornire il nostro sito e i nostri servizi. Utilizziamo i cookie prestazionali per raccogliere statistiche anonime in modo da poter capire come i clienti utilizzano il nostro sito e apportare miglioramenti. I cookie essenziali non possono essere disattivati, ma puoi fare clic su \"Personalizza\" o \"Rifiuta\" per rifiutare i cookie prestazionali.

Se sei d'accordo, AWS e le terze parti approvate utilizzeranno i cookie anche per fornire utili funzionalità del sito, ricordare le tue preferenze e visualizzare contenuti pertinenti, inclusa la pubblicità pertinente. Per continuare senza accettare questi cookie, fai clic su \"Continua\" o \"Rifiuta\". Per effettuare scelte più dettagliate o saperne di più, fai clic su \"Personalizza\".

Crea e configura l'agente manualmente

Modalità Focus
Crea e configura l'agente manualmente - 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à.

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

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 con 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 L'ARN del ruolo di servizio con le autorizzazioni per richiamare le operazioni API 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, scegli la scheda corrispondente al metodo che preferisci, quindi segui i passaggi:

Console
Per creare un agente
  1. Accedi all' AWS Management Console utilizzo di un ruolo IAM 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 all' AWS Management Console utilizzo di un ruolo IAM 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.

      Per impostazione predefinita, vengono visualizzati i modelli ottimizzati per gli agenti. Per vedere tutti i modelli supportati da Amazon Bedrock Agents, deseleziona Bedrock Agents optimized.

      Puoi creare agenti con qualsiasi modello di base. Attualmente, alcuni dei modelli offerti sono ottimizzati con prompt/parser ottimizzati per l'integrazione con l'architettura degli agenti. Nel tempo, intendiamo offrire l'ottimizzazione per tutti i modelli offerti.
    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:

      • Interprete del codice: (Facoltativo) Scegli se consentire all'agente di gestire attività che implicano la scrittura, l'esecuzione, il test e la risoluzione dei problemi del codice. Per informazioni dettagliate, consultare Genera, esegui e testa il codice con l'interpretazione del codice.

      • Input utente: (Facoltativo) Scegli se consentire all'agente di richiedere ulteriori informazioni all'utente se non dispone di informazioni sufficienti. Per informazioni dettagliate, consultare Configura l'agente per richiedere informazioni all'utente.

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

      • 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. Per la sezione Autorizzazioni IAM, per il ruolo delle risorse 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 chiavi KMS, 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.

    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 sapere 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 Amazon Bedrock Knowledge Bases. 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 Strategia di orchestrazione, puoi scegliere Modifica per personalizzare l'orchestrazione del tuo agente. Per ulteriori informazioni sulla strategia di orchestrazione che puoi utilizzare per il tuo agente, consulta. Personalizza la strategia di orchestrazione degli agenti

  7. Nella sezione Collaborazione multiagente, puoi scegliere Modifica per creare un team di collaborazione multiagente. Per ulteriori informazioni sulla collaborazione tra più agenti, consulta. Usa la collaborazione multiagente con Amazon Bedrock Agents

  8. 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 Per specificare un ARN del ruolo di servizio con le autorizzazioni per richiamare le operazioni API sull'agente
Modello Foundation 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
Secondi di sessione inattiva TTLIn Durata dopo la quale l'agente termina la sessione ed elimina tutte le informazioni memorizzate.
customerEncryptionKeyArn ARN di una chiave KMS 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.
Configurazione Guardrail Per aggiungere un guardrail all'agente. Specificare l'ID o l'ARN del guardrail e la versione da utilizzare.
clientToken Per garantire che la richiesta API venga completata una sola volta. Per ulteriori informazioni, consulta Garantire l'idempotenza.
Stato di memorizzazione nella cache Per abilitare la memorizzazione immediata dell'input nell'agente. Per ulteriori informazioni, consulta Memorizzazione rapida nella cache per un'inferenza più rapida del modello.
reasoning_config Abilitare il ragionamento del modello in modo che il modello spieghi come ha raggiunto le sue conclusioni. Utilizzare all'interno di un additionalModelRequestFields campo. È necessario specificare il numero di budget_tokens quelli utilizzati per il ragionamento dei modelli, che sono un sottoinsieme dei token di output. Per ulteriori informazioni, consulta Migliora le risposte del modello con il ragionamento del modello.

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.

Per creare un agente
  1. Accedi all' AWS Management Console utilizzo di un ruolo IAM 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 all' AWS Management Console utilizzo di un ruolo IAM 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.

      Per impostazione predefinita, vengono visualizzati i modelli ottimizzati per gli agenti. Per vedere tutti i modelli supportati da Amazon Bedrock Agents, deseleziona Bedrock Agents optimized.

      Puoi creare agenti con qualsiasi modello di base. Attualmente, alcuni dei modelli offerti sono ottimizzati con prompt/parser ottimizzati per l'integrazione con l'architettura degli agenti. Nel tempo, intendiamo offrire l'ottimizzazione per tutti i modelli offerti.
    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:

      • Interprete del codice: (Facoltativo) Scegli se consentire all'agente di gestire attività che implicano la scrittura, l'esecuzione, il test e la risoluzione dei problemi del codice. Per informazioni dettagliate, consultare Genera, esegui e testa il codice con l'interpretazione del codice.

      • Input utente: (Facoltativo) Scegli se consentire all'agente di richiedere ulteriori informazioni all'utente se non dispone di informazioni sufficienti. Per informazioni dettagliate, consultare Configura l'agente per richiedere informazioni all'utente.

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

      • 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. Per la sezione Autorizzazioni IAM, per il ruolo delle risorse 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 chiavi KMS, 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.

    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 sapere 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 Amazon Bedrock Knowledge Bases. 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 Strategia di orchestrazione, puoi scegliere Modifica per personalizzare l'orchestrazione del tuo agente. Per ulteriori informazioni sulla strategia di orchestrazione che puoi utilizzare per il tuo agente, consulta. Personalizza la strategia di orchestrazione degli agenti

  7. Nella sezione Collaborazione multiagente, puoi scegliere Modifica per creare un team di collaborazione multiagente. Per ulteriori informazioni sulla collaborazione tra più agenti, consulta. Usa la collaborazione multiagente con Amazon Bedrock Agents

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

PrivacyCondizioni del sitoPreferenze cookie
© 2025, Amazon Web Services, Inc. o società affiliate. Tutti i diritti riservati.