Verifica e risolvi i problemi del comportamento degli agenti - 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à.

Verifica e risolvi i problemi del comportamento degli agenti

Dopo aver creato un agente, avrai una bozza funzionante. La bozza di lavoro è una versione dell'agente da utilizzare per costruire l'agente in modo iterativo Ogni volta che apporti modifiche al tuo agente, la bozza di lavoro viene aggiornata. Quando sei soddisfatto delle configurazioni del tuo agente, puoi creare una versione, che è un'istantanea del tuo agente, e un alias, che rimanda alla versione. Puoi quindi distribuire l'agente nelle tue applicazioni chiamando l'alias. Per ulteriori informazioni, consulta Implementa e integra un agente Amazon Bedrock nella tua applicazione.

L'elenco seguente descrive come testare il proprio agente:

  • Nella console Amazon Bedrock, apri la finestra di test laterale e invii l'input al tuo agente a cui rispondere. Puoi selezionare la bozza di lavoro o una versione che hai creato.

  • InAPI, la bozza di lavoro è la DRAFT versione. Invii input al tuo agente utilizzando InvokeAgentcon l'alias test o un alias diverso che punta a una versione statica. TSTALIASID

Per aiutarti a risolvere i problemi di comportamento del tuo agente, Amazon Bedrock Agents offre la possibilità di visualizzare la traccia durante una sessione con il tuo agente. La traccia mostra il processo di ragionamento dell'agente. step-by-step Per ulteriori informazioni sulla traccia, vedereTieni traccia del processo di step-by-step ragionamento dell'agente utilizzando trace.

Di seguito sono riportati i passaggi per testare il tuo agente. Seleziona la scheda corrispondente al metodo scelto e segui i passaggi.

Console
Per testare un agente

  1. Accedi a 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 Agenti, seleziona il link relativo all'agente che desideri testare dall'elenco degli agenti.

  4. La finestra Test viene visualizzata in un riquadro sulla destra.

    Nota

    Se la finestra Test è chiusa, puoi riaprirla selezionando Test nella parte superiore della pagina dei dettagli dell'agente o in qualsiasi pagina al suo interno.

  5. Dopo aver creato un agente, è necessario impacchettarlo con la bozza di modifica di lavoro preparandolo in uno dei seguenti modi:

    • Nella finestra Test, selezionate Prepara.

    • Nella pagina Bozza di lavoro, seleziona Prepara nella parte superiore della pagina.

    Nota

    Ogni volta che aggiorni la bozza di lavoro, devi preparare l'agente a impacchettare l'agente con le ultime modifiche. Come best practice, ti consigliamo di controllare sempre l'ora dell'ultima preparazione dell'agente nella sezione Panoramica dell'agente della pagina Bozza di lavoro per verificare che il tuo agente stia testando le configurazioni più recenti.

  6. Per scegliere un alias e la versione associata da testare, utilizza il menu a discesa nella parte superiore della finestra Test. Per impostazione predefinita, è selezionata la combinazione TestAlias: Working draft.

  7. (Facoltativo) Per selezionare Provisioned Throughput come alias, il testo sotto l'alias di test selezionato indicherà Using or Using ODT PT. Per creare un modello Provisioned Throughput, selezionare Change. Per ulteriori informazioni, consulta Aumenta la capacità di invocazione del modello con Provisioned Throughput in Amazon Bedrock.

  8. Per testare l'agente, inserisci un messaggio e scegli Esegui. Mentre aspetti che la risposta venga generata o dopo che è stata generata, hai le seguenti opzioni:

    • Per visualizzare i dettagli di ogni fase del processo di orchestrazione dell'agente, inclusi il prompt, le configurazioni di inferenza e il processo di ragionamento dell'agente per ogni fase e l'utilizzo dei relativi gruppi di azioni e knowledge base, seleziona Mostra traccia. La traccia viene aggiornata in tempo reale in modo da poterla visualizzare prima che venga restituita la risposta. Per espandere o comprimere la traccia per un passaggio, seleziona una freccia accanto a un passaggio. Per ulteriori informazioni sulla finestra Trace e sui dettagli che vengono visualizzati, vedereTieni traccia del processo di step-by-step ragionamento dell'agente utilizzando trace.

    • Se l'agente richiama una knowledge base, la risposta contiene note a piè di pagina. Per visualizzare il link all'oggetto S3 contenente le informazioni citate per una parte specifica della risposta, seleziona la nota a piè di pagina pertinente.

    • Se si imposta l'agente in modo che restituisca il controllo anziché utilizzare una funzione Lambda per gestire il gruppo di azioni, la risposta contiene l'azione prevista e i relativi parametri. Fornisci un esempio di valore di output della funzione API o per l'azione, quindi scegli Invia per generare una risposta dell'agente. Guarda l'immagine seguente per un esempio:

      Richiesta della finestra di prova per fornire un output di esempio per l'azione.

    È possibile eseguire le seguenti azioni nella finestra Test:

    • Per iniziare una nuova conversazione con l'agente, seleziona l'icona di aggiornamento.

    • Per visualizzare la finestra Trace, seleziona l'icona di espansione. Per chiudere la finestra Trace, selezionate l'icona di riduzione.

    • Per chiudere la finestra Test, selezionate l'icona con la freccia destra.

È possibile abilitare o disabilitare i gruppi di azioni e le knowledge base. Utilizzate questa funzionalità per risolvere i problemi del vostro agente isolando quali gruppi di azioni o knowledge base devono essere aggiornati valutandone il comportamento con impostazioni diverse.

Per abilitare un gruppo di azione o una knowledge base

  1. Accedere a 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 Agenti, seleziona il link relativo all'agente che desideri testare dall'elenco degli agenti.

  4. Nella pagina dei dettagli dell'agente, nella sezione Bozza di lavoro, seleziona il collegamento per la bozza di lavoro.

  5. Nella sezione Gruppi di azione o Basi di conoscenza, passa il mouse sullo Stato del gruppo di azione o della knowledge base di cui desideri modificare lo stato.

  6. Viene visualizzato un pulsante di modifica. Seleziona l'icona di modifica, quindi scegli dal menu a discesa se il gruppo di azioni o la knowledge base sono abilitati o disabilitati.

  7. Se un gruppo di azioni è disabilitato, l'agente non utilizza il gruppo di azioni. Se una knowledge base è disattivata, l'agente non utilizza la knowledge base. Abilita o disabilita i gruppi di azioni o le knowledge base, quindi utilizza la finestra Test per risolvere i problemi del tuo agente.

  8. Scegli Prepara per applicare le modifiche apportate all'agente prima di testarlo.

API

Prima di testare l'agente per la prima volta, è necessario allegarlo alla bozza di modifica provvisoria inviando un PrepareAgentrichiesta (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. Includi nella richiesta. agentId Le modifiche si applicano alla DRAFT versione a cui fa riferimento l'TSTALIASIDalias.

Vedi esempi di codice

Nota

Ogni volta che aggiorni la bozza di lavoro, devi preparare l'agente a impacchettare l'agente con le ultime modifiche. Come procedura ottimale, ti consigliamo di inviare un GetAgentrichiedi (consulta il link per i formati di richiesta e risposta e i dettagli sui campi) con un endpoint di build Agents for Amazon Bedrock e controlla l'preparedAtorario in cui il tuo agente deve verificare che stai testando il tuo agente con le configurazioni più recenti.

Per testare il tuo agente, invia 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.

Nota

Il AWS CLI non supporta InvokeAgent.

Vedi esempi di codice

Nella richiesta sono presenti i seguenti campi:

  • Fornisci almeno i seguenti campi obbligatori:

    Campo Breve descrizione
    agentId ID dell'agente
    agentAliasId ID dell'alias. TSTALIASIDDa utilizzare per richiamare la versione DRAFT
    sessionId ID alfanumerico per la sessione (2—100 caratteri)
    inputText Il prompt dell'utente da inviare all'agente

  • I seguenti campi sono opzionali:

    Campo Breve descrizione
    enableTrace TRUESpecificare per visualizzare la traccia.
    endSession TRUESpecificare di terminare la sessione con l'agente dopo questa richiesta.
    sessionState Include il contesto che influenza il comportamento dell'agente o il comportamento delle knowledge base collegate all'agente. Per ulteriori informazioni, consulta Contesto della sessione dell'agente di controllo.

La risposta viene restituita in un flusso di eventi. Ogni evento contiene unchunk, che contiene parte della risposta nel bytes campo, che deve essere decodificata. Se l'agente ha richiesto una knowledge base, include anche. chunk citations È inoltre possibile restituire i seguenti oggetti: