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

Implementa e integra un agente Amazon Bedrock nella tua applicazione

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 API chiamate a 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 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. Quindi, scegli un agente nella sezione Agenti.

    3. Nella sezione Alias, scegli Crea.

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

    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 (consulta il link per i formati di richiesta e risposta e i dettagli dei campi) con 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.
    routingConfiguration 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 Identificatore per garantire che la richiesta venga completata una sola volta. API
    tags Per associare i tag all'alias.

    Vedi esempi di codice

  2. Implementa il tuo agente configurando l'applicazione per creare un 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.