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à.
Implementazione di un caso d'uso autonomo di Bedrock Agent
Segui le step-by-step istruzioni in questa sezione per configurare e distribuire la soluzione nel tuo account.
Tempo di implementazione: circa 10-30 minuti
-
Accedi alla Console di gestione AWS
e seleziona il pulsante per avviare il CloudFront modello. -
Per impostazione predefinita, il modello viene avviato nella regione Stati Uniti orientali (Virginia settentrionale). Per avviare la soluzione in un'altra regione AWS, utilizza il selettore della regione nella barra di navigazione della console.
Nota
Questa soluzione utilizza Amazon Bedrock, che attualmente non è disponibile in tutte le regioni AWS. Se utilizzi queste funzionalità, devi avviare questa soluzione in una regione AWS in cui questi servizi sono disponibili. Per la disponibilità più aggiornata per regione, consulta l'AWS Regional Services List
. -
Nella pagina Create stack, verifica che l'URL del modello corretto sia nella casella di testo URL Amazon S3 e scegli Avanti.
-
Nella pagina Specificare i dettagli dello stack, assegna un nome allo stack di soluzioni. Per informazioni sulle limitazioni dei caratteri di denominazione, consulta {https---docs-aws-amazon-com- https---docs-aws-amazon-com -iam-Latest- UserGuide -reference-iam-limits-html} [quote IAM e AWS STS] nella AWS Identity and Access Management User Guide.
-
In Parametri, esamina i parametri per questo modello di soluzione e modificali se necessario. Questa soluzione utilizza i seguenti valori predefiniti.
Parametro Voce predefinita Description UseCaseUUID
<_Requires input_>36 caratteri di lunghezza UUIDv4 per identificare questo caso d'uso distribuito all'interno di un'applicazione.
UseCaseConfigRecordKey
<Requires input>Chiave corrispondente al record che contiene le configurazioni richieste dalla funzione Lambda del provider di chat in fase di esecuzione.
Il record nella tabella deve avere un attributo chiave che corrisponda a questo valore e un attributo config contenente la configurazione desiderata.
Questo record verrà compilato dalla piattaforma di distribuzione se è in uso. Per le distribuzioni autonome di questo caso d'uso, è richiesta una voce creata manualmente nella tabella definita in. UseCaseConfigTableName
UseCaseConfigTableName
<Requires input>`Lo stack leggerà la configurazione del caso d'uso dalla tabella fornita qui e utilizzando la chiave di registrazione definita in. UseCaseConfigRecordKey
DefaultUserEmail
placeholder@example.comE-mail dell'utente predefinito per questo caso d'uso. La soluzione crea un utente Amazon Cognito per questa e-mail per accedere allo use case.
ExistingRestApiId
(Inserimento opzionale)
ID API REST API Gateway esistente da utilizzare. Se non viene fornita, verrà creata una nuova API API Gateway REST. In genere viene fornita durante la distribuzione dalla dashboard di distribuzione.
Nota: l'utilizzo di APIs Existing può aiutare a ridurre la duplicazione delle risorse e semplificare la gestione APIs quando è necessario implementare più casi d'uso autonomi. Quando si fornisce una soluzione esistente APIs per un caso d'uso indipendente, è responsabilità dell'utente garantire che l'API sia configurata con le route richieste con i modelli previsti. È necessario configurare un percorso /details preconfigurato obbligatorio (recupera i dettagli dei casi d'uso durante la chat) e, facoltativamente, un percorso /feedback (se impostato per consentire FeedbackEnabledla raccolta di feedback per le risposte
Yesalle chat LLM). Inoltre, e deve anche essere ExistingApiRootResourceIdfornito ExistingCognitoUserPoolId. ExistingCognitoGroupPolicyTableNameExistingApiRootResourceId
(Input opzionale)
ID risorsa principale dell'API REST di API Gateway esistente da utilizzare. Il Root Resource ID dell'API REST può essere ottenuto dalla console AWS selezionando la risorsa root (/) nella sezione «Risorse» dell'API. L'ID risorsa verrà quindi visualizzato nel pannello dei dettagli della risorsa. In alternativa, puoi eseguire una chiamata API description sulla tua API REST per trovare il Root Resource ID.
FeedbackEnabled
NoSe impostato su No, lo stack di use case distribuito non avrà accesso alla funzionalità di feedback.
CognitoDomainPrefix
(Input opzionale)
Inserisci un valore se desideri fornire un dominio per il client del pool di utenti di Amazon Cognito. Se non fornisci un valore, la soluzione ne genera uno.
ExistingCognitoUserPoolId
(Input opzionale)
UserPoolIddi un pool di utenti Amazon Cognito esistente con cui desideri autenticare questo caso d'uso. NOTA: in genere fornisci questo ID durante la distribuzione dalla dashboard di Deployment, ma puoi ometterlo quando distribuisci questo stack di use case standalone.
ExistingCognitoUserPoolClient
(Input opzionale)
Fornisci un client del pool di utenti (client dell'app) per utilizzarne uno esistente. Se non fornisci un client per il pool di utenti, la soluzione ne crea uno. Puoi fornire questo parametro solo se hai fornito un ExistingCognitoUserPoolId.
ExistingCognitoGroupPolicyTableName
(Input opzionale)
Nome della tabella DynamoDB contenente le politiche dei gruppi di utenti. Viene utilizzato dall'autorizzatore personalizzato sull'API del caso d'uso. NOTA: in genere si fornisce questo nome durante la distribuzione dalla dashboard di Deployment, ma è possibile ometterlo quando si distribuisce questo stack di use case standalone.
VpcEnabled
NoSe le risorse degli stack devono essere distribuite all'interno di un VPC.
CreateNewVpc
NoSeleziona
Yesse desideri che la soluzione crei un nuovo VPC per te e lo utilizzi per questo caso d'uso. NOTA: questo parametro è rilevante solo se lo VpcEnabledèYes.IPAMPoolId
(Input opzionale)
Se desideri assegnare l'intervallo CIDR utilizzando IPAM, fornisci l'ID del pool IPAM da utilizzare. NOTA: questo parametro è rilevante solo se VpcEnabledè ed è.
YesCreateNewVpcNoExistingVpcId
(Input opzionale)
ID VPC di un VPC esistente da utilizzare per lo use case. NOTA: questo parametro è rilevante solo se VpcEnabledè
Yesed CreateNewVpcè.NoExistingPrivateSubnetIds
(Input opzionale)
Elenco separato da virgole IDs di sottoreti private esistenti da utilizzare per distribuire la funzione Lambda. NOTA: questo parametro è rilevante solo se è ed è. VpcEnabled
YesCreateNewVpcNoExistingSecurityGroupIds
(Input opzionale)
Elenco separato da virgole dei gruppi di sicurezza del VPC esistente da utilizzare per configurare le funzioni Lambda. NOTA: questo parametro è rilevante solo se è ed è. VpcEnabled
YesCreateNewVpcNoVpcAzs
(Input opzionale)
Elenco separato da virgole AZs in cui vengono create le sottoreti di VPCs
Nota: rilevante solo se VpcEnabledè
Yesed CreateNewVpcè.NoBedrockAgentId
<Requires input>L'ID dell'agente Amazon Bedrock da utilizzare.
BedrockAgentAliasId
<Requires input>L'ID alias dell'agente Amazon Bedrock da utilizzare.
Implementa l'interfaccia utente
YesSeleziona l'opzione per implementare l'interfaccia utente di chat frontend per questa distribuzione. La selezione
Nocomporta la creazione dell'infrastruttura per ospitare APIs, l'autenticazione per l'elaborazione e il APIs backend senza l'interfaccia utente della chat. -
Scegli Next (Successivo).
-
Nella pagina Configure stack options (Configura opzioni pila), scegliere Next (Successivo).
-
Nella pagina Rivedi, verifica e conferma le impostazioni. Seleziona la casella per confermare che il modello creerà risorse IAM.
-
Seleziona Create (Crea) per implementare lo stack.
Puoi visualizzare lo stato dello stack nella CloudFormation console AWS nella colonna Status. Dovresti ricevere lo stato CREATE_COMPLETE in circa 10-30 minuti.