Implementa un agente Amazon Bedrock

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. Seleziona la scheda corrispondente al metodo scelto e segui i passaggi.

   Console

   Per creare un alias (e facoltativamente una nuova versione)

   1. Accedi a e apri AWS Management Console 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 univoco per l'alias e fornisci una descrizione opzionale.

   5. Selezionare 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. (Facoltativo) Per selezionare Provisioned Throughput per il tuo alias, seleziona il pulsante Provisioned Throughput (PT). Se avete già creato un modello Provisioned Throughput, sarà possibile selezionarlo nel menu a discesa Select Provisioned Throughput. Se non è stato creato alcun modello Provision Throughput, l'opzione per selezionare un modello non sarà disponibile. Per creare un modello Provisioned Throughput, selezionare Manage Provisioned Throughput. Per ulteriori informazioni, consulta Throughput assegnato per Amazon Bedrock.

   7. Seleziona Create alias. Nella parte superiore viene visualizzato un banner di successo.

   API

   Per creare un alias per un agente, invia una CreateAgentAliasrichiesta (consulta il link per i formati di richiesta e risposta e i dettagli dei campi) con un endpoint di build Agents for Amazon Bedrock. Per creare una nuova versione e associarla a questo alias, lascia l'oggetto non specificato. routingConfiguration

   Vedi esempi di codice

2. Implementa il tuo agente configurando l'applicazione per effettuare una InvokeAgentrichiesta (consulta il link per i formati di richiesta e risposta e i dettagli sui campi) 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.

Per informazioni su come gestire le versioni e gli alias degli agenti, seleziona uno dei seguenti argomenti.

Argomenti

• Gestisci le versioni degli agenti in Amazon Bedrock
• Gestione degli alias degli agenti in Amazon Bedrock