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. 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 IAMruolo con le autorizzazioni di 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 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.
    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 Per garantire che la API richiesta venga completata una sola volta. Per ulteriori informazioni, vedere Garantire l'idempotenza.
    tags Per associare i tag all'alias.

    Vedi esempi di codice

  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.