This app deploys a Bedrock Agent with a Bedrock Agent Action Group that provides a function to query a website to answer a question, using the web crawler construct.
By providing reusable constructs following AWS best practices, this app helps you quickly build custom generative AI apps on AWS. The constructs abstract complexity of orchestrating AWS services like S3, Bedrock, etc.
Here is the architecture diagram of the sample application:
This sample application codebase is organized into folders : the backend code lives in bin/bedrock-web-crawler.ts and uses the AWS CDK resources defined in the lib folder.
The key folders are:
samples/bedrock-web-crawler
│
├── bin
│ └── bedrock-web-crawler.ts # CDK app
├── lib
| ├── action-group.yaml # action group openapi schema
│ ├── bedrock-web-crawler-stack.ts # Stack deploying the web crawler, Bedrock Agent, Action Group
- An AWS account. We recommend you deploy this solution in a new account.
- AWS CLI: configure your credentials
aws configure --profile [your-profile]
AWS Access Key ID [None]: xxxxxx
AWS Secret Access Key [None]:yyyyyyyyyy
Default region name [None]: us-east-1
Default output format [None]: json
- Node.js: v18.12.1
- AWS CDK: 2.143.0
- jq: jq-1.6
This project is built using the AWS Cloud Development Kit (CDK). See Getting Started With the AWS CDK for additional details and prerequisites.
-
Clone this repository.
git clone <this>
-
Enter the code sample backend directory.
cd samples/bedrock-web-crawler -
Install packages
npm install
-
Boostrap AWS CDK resources on the AWS account.
cdk bootstrap aws://ACCOUNT_ID/REGION
-
Enable Access to Amazon Bedrock Models
You must explicitly enable access to models before they can be used with the Amazon Bedrock service. Please follow these steps in the Amazon Bedrock User Guide to enable access to the models (
Anthropic::Claude):.
- Deploy the sample in your account.
$ cdk deploy
The command above will deploy one stack in your account. With the default configuration of this sample, the observed deployment time was ~381 seconds (6.5 minutes).
To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them. You will need to answer yes to get the stack deployed.
Navigate to the Bedrock Agents console in your region and find your new agent.
Ask some questions.
- what is https://github.com/awslabs/generative-ai-cdk-constructs about ?
- summarize this page: https://aws.amazon.com/bedrock/agents/
Do not forget to delete the stack to avoid unexpected charges.
First make sure to remove all data from the Amazon Simple Storage Service (Amazon S3) Bucket.
$ cdk destroyDelete all the associated logs created by the different services in Amazon CloudWatch logs
The sample code; software libraries; command line tools; proofs of concept; templates; or other related technology (including any of the foregoing that are provided by our personnel) is provided to you as AWS Content under the AWS Customer Agreement, or the relevant written agreement between you and AWS (whichever applies). You should not use this AWS Content in your production accounts, or on production or other critical data. You are responsible for testing, securing, and optimizing the AWS Content, such as sample code, as appropriate for production grade use based on your specific quality control practices and standards. Deploying AWS Content may incur AWS charges for creating or using AWS chargeable resources, such as running Amazon EC2 instances or using Amazon S3 storage.
This solution collects anonymous operational metrics to help AWS improve the quality and features of the solution. Data collection is subject to the AWS Privacy Policy (https://aws.amazon.com/privacy/). To opt out of this feature, simply remove the tag(s) starting with “uksb-” or “SO” from the description(s) in any CloudFormation templates or CDK TemplateOptions.