Crea un flusso in Amazon Bedrock

Nota

I flussi di prompt sono disponibili in anteprima e sono soggetti a modifiche.

Per creare un flusso di prompt, devi almeno fornire un nome e una descrizione per il flusso di prompt e specificare un ruolo di servizio con le autorizzazioni appropriate (oppure consenti alla console Amazon Bedrock di crearne uno automaticamente per te). Definirai quindi il flusso di prompt configurando i nodi, che fungono da passaggi nel flusso di prompt, e le connessioni tra i nodi. Prima di creare un flusso, ti consigliamo di leggere Come funzionano i flussi rapidi per Amazon Bedrock per acquisire familiarità con i concetti e i termini di Prompt flows for Amazon Bedrock e per conoscere i tipi di nodi disponibili. Per imparare a creare un flusso di prompt, seleziona la scheda corrispondente al metodo scelto e segui i passaggi.

Console

Per creare un flusso

1. Accedi all' AWS Management Console utilizzo di un ruolo IAM con autorizzazioni Amazon Bedrock e apri la console Amazon Bedrock in Getting Started with the. AWS Management Console

2. Seleziona Prompt flows dal riquadro di navigazione a sinistra.

3. Nella sezione Prompt flows, scegli Crea flusso di prompt.

4. Inserisci un nome per il flusso e una descrizione opzionale.

5. Per il nome del ruolo di servizio, scegli una delle seguenti opzioni:

   • Crea e usa un nuovo ruolo di servizio: lascia che Amazon Bedrock crei un ruolo di servizio da utilizzare.

   • Usa un ruolo di servizio esistente: seleziona un ruolo di servizio personalizzato che hai impostato in precedenza. Per ulteriori informazioni, consulta Crea un ruolo di servizio per i flussi Prompt in Amazon Bedrock.

6. (Facoltativo) Per crittografare il flusso di prompt con una chiave KMS, seleziona Personalizza le impostazioni di crittografia (avanzate) e scegli la chiave. Per ulteriori informazioni, consulta Politica chiave per consentire ad Amazon Bedrock di crittografare e decrittografare un flusso.

7. Scegli Create (Crea) . Il flusso viene creato e verrai indirizzato al prompt flow builder dove puoi creare il tuo flusso.

8. Puoi continuare con la procedura seguente per creare il flusso o tornare al prompt flow builder in un secondo momento.

Per creare il tuo flusso

1. Se non utilizzi già il Prompt Flow Builder, procedi come segue:

   1. Accedi all' AWS Management Console utilizzo di un ruolo IAM con autorizzazioni Amazon Bedrock e apri la console Amazon Bedrock in Getting Started with the. AWS Management Console

   2. Seleziona Prompt flows dal riquadro di navigazione a sinistra. Quindi, scegli un flusso nella sezione Prompt flows.

   3. Scegli Modifica in Prompt Flow Builder.

2. Nella sezione Prompt Flow Builder, il riquadro centrale mostra un nodo di input Flow e un nodo di output Flow. Questi sono i nodi di input e output per il flusso.

3. Per aggiungere e configurare nodi

   1. Nel riquadro Prompt Flow Builder, seleziona Nodes.

   2. Trascina un nodo che desideri utilizzare per la prima fase del flusso e rilascialo nel riquadro centrale.

   3. I cerchi sui nodi sono punti di connessione. Per connettere il nodo di input del flusso al secondo nodo, trascina una linea dal cerchio sul nodo di input Flow al cerchio nella sezione Input del nodo appena aggiunto.

   4. Seleziona il nodo che hai appena aggiunto.

   5. Nella sezione Configura del riquadro Prompt flow Builder, fornisci le configurazioni per il nodo selezionato e definisci nomi, tipi di dati ed espressioni per gli input e gli output del nodo.

   6. Nel riquadro Prompt flow builder, seleziona Nodes.

   7. Ripeti i passaggi per aggiungere e configurare i nodi, i nodi rimanenti del flusso.

      Nota

      Se utilizzi un ruolo di servizio che Amazon Bedrock ha creato automaticamente per te, il ruolo verrà aggiornato con le autorizzazioni appropriate man mano che aggiungi nodi. Tuttavia, se utilizzi un ruolo di servizio personalizzato, devi aggiungere le autorizzazioni appropriate alla policy allegata al tuo ruolo di servizio facendo riferimento a. Crea un ruolo di servizio per i flussi Prompt in Amazon Bedrock

4. Connect l'Output dell'ultimo nodo del flusso con il nodo di output Input of the Flow. Puoi avere più nodi di output Flow. Per aggiungere altri nodi di uscita del flusso, trascina il nodo di uscita Flow e rilascialo accanto al nodo in cui desideri che il flusso si interrompa. Assicuratevi di tracciare connessioni tra i due nodi.

5. Puoi continuare con la procedura successiva Prova un flusso di prompt in Amazon Bedrock o tornare più tardi. Per continuare con il passaggio successivo, scegli Salva. Per tornare più tardi, scegli Salva ed esci.

Elimina un nodo o una connessione

Durante il processo di creazione del flusso, potrebbe essere necessario eliminare un nodo o rimuovere le connessioni dei nodi.

Per eliminare un nodo

1. Seleziona un nodo che desideri eliminare.

2. Nel riquadro Prompt flow Builder, scegli l'icona di eliminazione () .

   Nota

   Se utilizzi un ruolo di servizio che Amazon Bedrock ha creato automaticamente per te, il ruolo verrà aggiornato con le autorizzazioni appropriate man mano che aggiungi nodi. Se elimini i nodi, tuttavia, le autorizzazioni pertinenti non verranno eliminate. Ti consigliamo di eliminare le autorizzazioni che non ti servono più seguendo la procedura descritta in Modificare un ruolo.

Per rimuovere una connessione

• Nella pagina di Flow Builder, passa il mouse sulla connessione che desideri rimuovere finché non viene visualizzata l'icona di espansione, quindi trascina la connessione lontano dal nodo.

API

Per creare un flusso, invia una CreateFlowrichiesta (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	Descrizione di base
nome	Un nome per il flusso.
executionRoleArn	L'ARN del ruolo di servizio con le autorizzazioni per creare e gestire i flussi.

I seguenti campi sono facoltativi:

Campo	Caso d'uso
definizione	Contiene gli nodes e connections che compongono il flusso.
description	Per descrivere il flusso.
tags	Per associare tag al flusso. Per ulteriori informazioni, consulta Aggiunta di tag alle risorse .
customerEncryptionKeyArn	Per crittografare il flusso con una chiave KMS. Per ulteriori informazioni, consulta Politica chiave per consentire ad Amazon Bedrock di crittografare e decrittografare un flusso.
clientToken	Per evitare la duplicazione delle richieste.

Sebbene il definition campo sia facoltativo, è necessario per il funzionamento del flusso. Puoi scegliere di creare prima un flusso senza la definizione e aggiornare invece il flusso in un secondo momento.

Per ogni nodo dell'nodeselenco, specifichi il tipo di nodo nel type campo e fornisci la configurazione corrispondente del nodo nel config campo. Per informazioni dettagliate sulla struttura delle API dei diversi tipi di nodi, consultaTipi di nodi nel flusso rapido.

I seguenti requisiti si applicano alla creazione di un flusso:

• Il flusso deve avere solo un nodo di ingresso del flusso e almeno un nodo di uscita del flusso.

• Non è possibile includere input per un nodo di input del flusso.

• Non è possibile includere uscite per un nodo di uscita del flusso.

• Ogni uscita in un nodo deve essere collegata a un ingresso in un nodo a valle (nell'API, ciò avviene tramite a FlowConnectionwith a FlowDataConnectionConfiguration).

• Ogni condizione (inclusa quella predefinita) in un nodo di condizione deve essere connessa a un nodo a valle (nell'API, ciò avviene tramite a FlowConnectionwith a FlowConditionalConnectionConfiguration).

I seguenti puntatori si applicano alla creazione di un flusso:

• Inizia impostando il tipo di dati per l'uscita del nodo di input del flusso. Questo tipo di dati deve corrispondere a quello che prevedi di inviare come input quando richiami il flusso.

• Quando definisci gli input per un flusso utilizzando le espressioni, verifica che il risultato corrisponda al tipo di dati che scegli per l'input.

• Se includi un nodo iteratore, includi un nodo collettore a valle dopo aver inviato l'output attraverso i nodi di cui hai bisogno. Il nodo collector restituirà gli output in un array.