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\".

Implementa e integra un agente Amazon Bedrock nella tua applicazione

Modalità Focus
Implementa e integra un agente Amazon Bedrock nella 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à.

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

Quando crei per la prima volta un agente Amazon Bedrock, hai una bozza di versione funzionante (DRAFT) e un alias di test (TSTALIASID) che rimandano alla versione bozza di lavoro. Quando apporti modifiche al tuo agente, le modifiche si applicano alla bozza di lavoro. Ripeti la bozza di lavoro finché non sei soddisfatto del comportamento del tuo agente. Quindi, puoi configurare il tuo agente per la distribuzione e l'integrazione nell'applicazione creando alias del tuo agente.

Per distribuire il tuo agente, devi creare un alias. Durante la creazione dell'alias, Amazon Bedrock crea automaticamente una versione del tuo agente. L'alias rimanda alla versione appena creata. In alternativa, puoi indirizzare l'alias a una versione del tuo agente creata in precedenza. Quindi, configuri l'applicazione per effettuare chiamate API verso quell'alias.

Una versione è un'istantanea che conserva la risorsa così com'era al momento della creazione. Se necessario, potete continuare a modificare la bozza di lavoro e creare nuovi alias (e di conseguenza, versioni) del vostro agente. In Amazon Bedrock, per generare una nuova versione dell'agente, crea un alias che rimanda per impostazione predefinita a questa versione. Amazon Bedrock crea le versioni in ordine numerico, a partire da 1.

Le versioni sono immutabili perché fungono da istantanea dell'agente al momento della creazione. Per aggiornare un agente in produzione, è necessario creare una nuova versione e configurare l'applicazione per effettuare chiamate all'alias che punta a quella versione.

Con gli alias, potete passare in modo efficiente da una versione all'altra dell'agente senza che l'applicazione tenga traccia della versione. Ad esempio, puoi modificare un alias in modo che rimanda a una versione precedente del tuo agente se ci sono modifiche che devi ripristinare rapidamente.

Per distribuire il tuo agente
  1. Crea un alias e una versione del tuo agente. Scegli la scheda relativa al metodo che preferisci, quindi segui i passaggi:

    Console
    Per creare un alias (e facoltativamente una nuova versione)
    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. Nella sezione Alias, scegli Crea.

    4. Inserisci un nome alias univoco e fornisci una descrizione facoltativa.

    5. In Associa una versione, scegli una delle seguenti opzioni:

      • Per creare una nuova versione, scegli Crea una nuova versione e associala a questo alias.

      • Per utilizzare una versione esistente, scegli Usa una versione esistente per associare questo alias. Dal menu a discesa, scegli la versione a cui desideri associare l'alias.

    6. In Seleziona la velocità effettiva, seleziona una delle seguenti opzioni:

    7. Seleziona Create alias.

    API

    Per creare un alias per un agente, invia una CreateAgentAliasrichiesta a un endpoint di build Agents for Amazon Bedrock.

    I seguenti campi sono obbligatori:

    Campo Caso d'uso
    agentId Per specificare l'ID dell'agente per il quale creare un alias.
    agentName Per specificare un nome per l'alias.

    I seguenti campi sono facoltativi:

    Campo Caso d'uso
    description Per fornire una descrizione dell'alias.
    Configurazione del routing Per specificare una versione a cui associare l'alias (lasciare vuoto per creare una nuova versione) e un Provisioned Throughput da associare all'alias.
    clientToken Per garantire che la richiesta API venga completata una sola volta. Per ulteriori informazioni, consulta Garantire l'idempotenza.
    tags Per associare i tag all'alias.

    Vedi esempi di codice

    Per creare un alias (e facoltativamente una nuova versione)
    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. Nella sezione Alias, scegli Crea.

    4. Inserisci un nome alias univoco e fornisci una descrizione facoltativa.

    5. In Associa una versione, scegli una delle seguenti opzioni:

      • Per creare una nuova versione, scegli Crea una nuova versione e associala a questo alias.

      • Per utilizzare una versione esistente, scegli Usa una versione esistente per associare questo alias. Dal menu a discesa, scegli la versione a cui desideri associare l'alias.

    6. In Seleziona la velocità effettiva, seleziona una delle seguenti opzioni:

    7. Seleziona Create alias.

  2. Implementa il tuo agente configurando l'applicazione per creare un InvokeAgentrichiesta con un endpoint di runtime Agents for Amazon Bedrock. Nel agentAliasId campo, specifica l'ID dell'alias che punta alla versione dell'agente che desideri utilizzare.

    Il flusso di InvokeAgent risposta contiene più eventi con blocchi per ogni parte della risposta in ordine. Facoltativamente, puoi abilitare lo streaming impostando su true nelle configurazioni streamFinalResponse di streaming.

    • Se il tuo agente è configurato con un Guardrail, puoi anche specificarlo applyGuardrailInterval nella casellaStreamingConfigurations, per controllare la frequenza con cui viene effettuata una ApplyGuardrail chiamata sui caratteri di risposta in uscita (ad esempio, ogni 50 caratteri)

    • Lo streaming di risposte è attualmente supportato solo con il prompt di orchestrazione.

    • Le citazioni non sono attualmente supportate con lo streaming.

    • Assicurati che il ruolo di esecuzione dell'agente includa l'bedrock:InvokeModelWithResponseStreamautorizzazione per il modello di agente configurato.

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