View a markdown version of this page

Bereitstellung eines eigenständigen Bedrock Agent-Anwendungsfalls - Generativer KI-Anwendungsgenerator auf AWS

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Bereitstellung eines eigenständigen Bedrock Agent-Anwendungsfalls

Folgen Sie den step-by-step Anweisungen in diesem Abschnitt, um die Lösung zu konfigurieren und in Ihrem Konto bereitzustellen.

Zeit bis zur Bereitstellung: Ungefähr 10-30 Minuten

  1. Melden Sie sich bei der AWS-Managementkonsole an und klicken Sie auf die Schaltfläche, um die CloudFront Vorlage zu starten.

    BedrockAgent.vorlage

    Launch solution

  2. Die Vorlage wird standardmäßig in der Region USA Ost (Nord-Virginia) gestartet. Um die Lösung in einer anderen AWS-Region zu starten, verwenden Sie die Regionsauswahl in der Navigationsleiste der Konsole.

    Anmerkung

    Diese Lösung verwendet Amazon Bedrock, das derzeit nicht in allen AWS-Regionen verfügbar ist. Wenn Sie diese Funktionen verwenden, müssen Sie diese Lösung in einer AWS-Region starten, in der diese Services verfügbar sind. Die aktuelle Verfügbarkeit nach Regionen finden Sie in der Liste der regionalen AWS-Dienste.

  3. Vergewissern Sie sich auf der Seite Stack erstellen, dass sich die richtige Vorlagen-URL im Textfeld Amazon S3 S3-URL befindet, und wählen Sie Weiter.

  4. Weisen Sie Ihrem Lösungsstapel auf der Seite „Stack-Details angeben“ einen Namen zu. Informationen zu Einschränkungen bei der Benennung von Zeichen finden Sie unter {https---docs-aws-amazon-com- https---docs-aws-amazon-com -IAM-Latest- UserGuide -reference-iam-limits-html} [IAM- und AWS STS STS-Kontingente] im AWS Identity and Access Management-Benutzerhandbuch.

  5. Überprüfen Sie unter Parameter die Parameter für diese Lösungsvorlage und ändern Sie sie nach Bedarf. Diese Lösung verwendet die folgenden Standardwerte.

    Parameter Standardeintrag Description

    UseCaseUUID

    <_Requires input_>

    36 Zeichen lang UUIDv4 , um diesen bereitgestellten Anwendungsfall innerhalb einer Anwendung zu identifizieren.

    UseCaseConfigRecordKey

    <Requires input>

    Schlüssel, der dem Datensatz entspricht, der Konfigurationen enthält, die von der Lambda-Funktion des Chat-Anbieters zur Laufzeit benötigt werden.

    Der Datensatz in der Tabelle muss ein Schlüsselattribut haben, das diesem Wert entspricht, und ein Konfigurationsattribut, das die gewünschte Konfiguration enthält.

    Dieser Datensatz wird von der Bereitstellungsplattform aufgefüllt, falls sie verwendet wird. Für eigenständige Bereitstellungen dieses Anwendungsfalls ist ein manuell erstellter Eintrag in der in definierten Tabelle UseCaseConfigTableNameerforderlich.

    UseCaseConfigTableName

    <Requires input>`

    Der Stack liest die Anwendungsfallkonfiguration aus der hier bereitgestellten Tabelle und verwendet dabei den in UseCaseConfigRecordKeydefinierten Datensatzschlüssel.

    DefaultUserEmail

    placeholder@example.com

    E-Mail des Standardbenutzers für diesen Anwendungsfall. Die Lösung erstellt einen Amazon Cognito Cognito-Benutzer für diese E-Mail, um auf den Anwendungsfall zuzugreifen.

    ExistingRestApiId

    (Optionale Eingabe)

    Bestehende API-Gateway-REST-API-ID, die verwendet werden soll. Falls nicht angegeben, wird eine neue API-Gateway-REST-API erstellt. Wird normalerweise bei der Bereitstellung über das Deployment-Dashboard bereitgestellt.

    Hinweis: Die Verwendung von APIs Existing kann dazu beitragen, die Duplizierung von Ressourcen zu reduzieren und die Verwaltung zu vereinfachen, APIs wenn Sie mehrere eigenständige Anwendungsfälle bereitstellen müssen. Bei der Bereitstellung vorhandener Daten APIs für einen eigenständigen Anwendungsfall sind Sie dafür verantwortlich, sicherzustellen, dass die API mit den erforderlichen Routen und den erwarteten Modellen konfiguriert ist. Eine erforderliche vorkonfigurierte /details-Route (ruft Anwendungsfalldetails während des Chats ab) und optional eine /feedback-Route (falls FeedbackEnabledso eingestellt, dass sie die Erfassung von Feedback für LLM-Chat-Antworten ermöglicht) Yes müssen konfiguriert werden. Zusätzlich ExistingCognitoUserPoolIdund ExistingCognitoGroupPolicyTableNamemuss ebenfalls ExistingApiRootResourceIdangegeben werden.

    ExistingApiRootResourceId

    (Optionale Eingabe)

    Bestehende API-Gateway-REST-API-Root-Ressourcen-ID, die verwendet werden soll. Die REST-API-Root-Ressourcen-ID kann von der AWS-Konsole abgerufen werden, indem Sie die Root-Ressource (/) im Abschnitt „Ressourcen“ der API auswählen. Die Ressourcen-ID wird dann im Bereich mit den Ressourcendetails angezeigt. Sie können alternativ einen API-Aufruf zur Beschreibung Ihrer REST-API ausführen, um die Root-Ressourcen-ID zu ermitteln.

    FeedbackEnabled

    No

    Wenn diese Option auf Nein gesetzt ist, hat der bereitgestellte Anwendungsfallstapel keinen Zugriff auf die Feedback-Funktion.

    CognitoDomainPrefix

    (Optionale Eingabe)

    Geben Sie einen Wert ein, wenn Sie eine Domain für den Amazon Cognito Cognito-Benutzerpool-Client bereitstellen möchten. Wenn Sie keinen Wert angeben, generiert die Lösung einen.

    ExistingCognitoUserPoolId

    (Optionale Eingabe)

    UserPoolIdeines vorhandenen Amazon Cognito Cognito-Benutzerpools, mit dem Sie diesen Anwendungsfall authentifizieren möchten. HINWEIS: In der Regel geben Sie diese ID bei der Bereitstellung über das Bereitstellungs-Dashboard an. Sie können sie jedoch weglassen, wenn Sie diesen Anwendungsfall-Stack eigenständig bereitstellen.

    ExistingCognitoUserPoolClient

    (Optionale Eingabe)

    Stellen Sie einen Benutzerpool-Client (App-Client) bereit, um einen vorhandenen zu verwenden. Wenn Sie keinen Benutzerpool-Client bereitstellen, erstellt die Lösung einen. Sie können diesen Parameter nur angeben, wenn Sie einen angegeben haben ExistingCognitoUserPoolId.

    ExistingCognitoGroupPolicyTableName

    (Optionale Eingabe)

    Name der DynamoDB-Tabelle, die Benutzergruppenrichtlinien enthält. Dies wird vom benutzerdefinierten Autorisierer für die API des Anwendungsfalls verwendet. HINWEIS: Normalerweise geben Sie diesen Namen bei der Bereitstellung über das Deployment-Dashboard an. Sie können ihn jedoch weglassen, wenn Sie diesen Anwendungsfall-Stack eigenständig bereitstellen.

    VpcEnabled

    No

    Ob die Stack-Ressourcen innerhalb einer VPC bereitgestellt werden.

    CreateNewVpc

    No

    Wählen Sie aus, Yes ob die Lösung eine neue VPC für Sie erstellen und für diesen Anwendungsfall verwenden soll. HINWEIS: Dieser Parameter ist nur relevant, wenn er relevant VpcEnabledistYes.

    IPAMPoolId

    (Optionale Eingabe)

    Wenn Sie den CIDR-Bereich mithilfe von IPAM zuweisen möchten, geben Sie die zu verwendende IPAM-Pool-ID an. HINWEIS: Dieser Parameter ist nur relevant, wenn er und VpcEnabledistYes. CreateNewVpcNo

    ExistingVpcId

    (Optionale Eingabe)

    VPC-ID einer vorhandenen VPC, die für den Anwendungsfall verwendet werden soll. HINWEIS: Dieser Parameter ist nur relevant, wenn er Yes und VpcEnabledCreateNewVpcist. No

    ExistingPrivateSubnetIds

    (Optionale Eingabe)

    Durch Kommas getrennte Liste der Subnetze IDs vorhandener privater Subnetze, die für die Bereitstellung der Lambda-Funktion verwendet werden sollen. HINWEIS: Dieser Parameter ist nur relevant, wenn VpcEnableder ist und ist. Yes CreateNewVpcNo

    ExistingSecurityGroupIds

    (Optionale Eingabe)

    Durch Kommas getrennte Liste der Sicherheitsgruppen der vorhandenen VPC, die für die Konfiguration von Lambda-Funktionen verwendet werden sollen. HINWEIS: Dieser Parameter ist nur relevant, wenn VpcEnableder und ist. Yes CreateNewVpcNo

    VpcAzs

    (Optionale Eingabe)

    Durch Kommas getrennte Liste, AZs in welcher Subnetze von erstellt wurden VPCs

    Hinweis: Nur relevant, wenn VpcEnabledist Yes und CreateNewVpcist. No

    BedrockAgentId

    <Requires input>

    Die ID des Amazon Bedrock Agents, der verwendet werden soll.

    BedrockAgentAliasId

    <Requires input>

    Die Alias-ID des Amazon Bedrock Agents, der verwendet werden soll.

    Stellen Sie die Benutzeroberfläche bereit

    Yes

    Wählen Sie die Option zur Bereitstellung der Frontend-Chat-Benutzeroberfläche für diese Bereitstellung aus. Die Auswahl No führt zur Erstellung der Infrastruktur für das Hosten der APIs, der Authentifizierung für die APIs und der Backend-Verarbeitung ohne die Chat-Benutzeroberfläche.

  6. Wählen Sie Weiter aus.

  7. Wählen Sie auf der Seite Configure stack options (Stack-Optionen konfigurieren) Next (Weiter) aus.

  8. Überprüfen und bestätigen Sie die Einstellungen auf der Seite Review. Aktivieren Sie das Kästchen zur Bestätigung, dass die Vorlage IAM-Ressourcen erstellt.

  9. Wählen Sie Stack erstellen aus, um den Stack bereitzustellen.

Sie können den Status des Stacks in der CloudFormation AWS-Konsole in der Spalte Status anzeigen. Sie sollten in etwa 10 bis 30 Minuten den Status CREATE_COMPLETE erhalten.