base on Example Jupyter notebooks 📓 and code scripts 💻 for using Amazon Bedrock Agents 🤖 and its functionalities <h2 align="center">Amazon Bedrock Agent Samples&nbsp;</h2> <p align="center"> :wave: :wave: Welcome to the Amazon Bedrock Agent Samples repository :wave: :wave: </p> > [!CAUTION] > The examples provided in this repository are for experimental and educational purposes only. They demonstrate concepts and techniques but are not intended for direct use in production environments. Make sure to have Amazon Bedrock Guardrails in place to protect against [prompt injection](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-injection.html). This repository provides examples and best practices for working with [Amazon Bedrock Agents](https://aws.amazon.com/bedrock/agents/). Amazon Bedrock Agents enables you to automate complex workflows, build robust and scalable end-to-end solutions from experimentation to production and quickly adapt to new models and experiments. With [Amazon Bedrock multi-agent collaboration](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-multi-agents-collaboration.html) you can plan and execute complex tasks across agents using supervisor mode. You can also have unified conversations across agents with built-in intent classification using the supervisor with routing mode and fallback to supervisor mode when a single intention cannot be detected. Amazon Bedrock Agents provides you with traces to observe your agents' behavior across multi-agent flows and provides guardrails, security and privacy that are standard across Amazon Bedrock features.  <p align="center"> <a href="/examples/multi_agent_collaboration/startup_advisor_agent/"><img src="https://img.shields.io/badge/Example-Startup_Advisor_Agent-blue" /></a> </p> <h3>Demo Video</h3> <hr /> This one-hour video takes you through a deep dive introduction to Amazon Bedrock multi-agent collaboration, including a pair of demos, and a walkthrough of Unifying customer experiences, and Automating complex processes. You’ll also see a customer explain their experience with multi-agent solutions. <p align="center"> <a href="https://youtu.be/7pvEYLW1yZw"><img src="https://markdown-videos-api.jorgenkh.no/youtube/7pvEYLW1yZw?width=640&height=360&filetype=jpeg" /></a> </p> ## �� Table of Contents �� - [Overview](#overview) - [Repository Structure](#repository-structure) - [Getting Started](#getting-started) - [Amazon Bedrock Agents examples](#agents-examples) - [Amazon Bedrock multi-agent collaboration examples](#multi-agent-collaboration-examples) - [Best Practices](#best-practices) - [Security](#security) - [License](#license) ## Overview Amazon Bedrock Agents enables you to create AI-powered assistants that can perform complex tasks and interact with various APIs and services. This repository provides practical examples to help you understand and implement agentic solutions. The solutions presented here use the [boto3 SDK in Python](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/bedrock-agent.html), however, you can create Bedrock Agents solutions using any of the AWS SDKs for [C++](https://sdk.amazonaws.com/cpp/api/LATEST/aws-cpp-sdk-bedrock-agent/html/annotated.html), [Go](https://docs.aws.amazon.com/sdk-for-go/api/service/bedrockagent/), [Java](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/bedrockagent/package-summary.html), [JavaScript](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/bedrock-agent/), [Kotlin](https://sdk.amazonaws.com/kotlin/api/latest/bedrockagent/index.html), [.NET](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/BedrockAgent/NBedrockAgent.html), [PHP](https://docs.aws.amazon.com/aws-sdk-php/v3/api/namespace-Aws.BedrockAgent.html), [Ruby](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/BedrockAgent.html), [Rust](https://docs.rs/aws-sdk-bedrockagent/latest/aws_sdk_bedrockagent/), [SAP ABAP](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/bdr/index.html) or [Swift](https://sdk.amazonaws.com/swift/api/awsbedrockruntime/0.34.0/documentation/awsbedrockruntime) <details> <summary> <h2>Repository Structure<h2> </summary> ```bash ├── examples/agents/ │ ├── agent_with_code_interpretation/ │ ├── user_confirmation_agents/ │ ├── inline_agent/ | └── .... ├── examples/multi_agent_collaboration/ │ ├── 00_hello_world_agent/ │ ├── devops_agent/ │ ├── energy_efficiency_management_agent/ | └── .... ├── src/shared/ │ ├── working_memory/ │ ├── stock_data/ │ ├── web_search/ | └── .... ├── src/utils/ │ ├── bedrock_agent_helper.py | ├── bedrock_agent.py | ├── knowledge_base_helper.py | └── .... ``` - [examples/agents/](/examples/agents/): Shows Amazon Bedrock Agents examples. - [examples/multi_agent_collaboration/](/examples/multi_agent_collaboration/): Shows Amazon Bedrock multi-agent collaboration examples. - [src/shared](/src/shared/): This module consists of shared tools that can be reused by Amazon Bedrock Agents via Action Groups. They provide functionality like [Web Search](/src/shared/file_store/), [Working Memory](/src/shared/working_memory/), and [Stock Data Lookup](/src/shared/stock_data/). - [src/utils](/src/utils/): This module contains utilities for building and using various Amazon Bedrock features, providing a higher level of abstraction than the underlying APIs. </details> ## Getting Started 1. Navigate to [`src/`](/src/) for more details. 2. To get started, navigate to the example you want to deploy in the [`examples/*`](/examples/) directory. 3. Follow the deployment steps in the `examples/*/*/README.md` file of the example. ## Agents examples - [Analyst assistant using Code Interpretation](/examples/agents/agent_with_code_interpretation/) - [Agent using Amazon Bedrock Guardrails](/examples/agents/agent_with_guardrails_integration/) - [Agent using Amazon Bedrock Knowledge Bases](/examples/agents/agent_with_knowledge_base_integration/) - [Agent with long term memory](/examples/agents/agent_with_long_term_memory/) - [Agent using models not yet optimized for Bedrock Agents](/examples/agents/agent_with_models_not_yet_optimized_for_bedrock_agents/) - [AWS CDK Agent](/examples/agents/cdk_agent/) - [Computer use Agent](/examples/agents/computer_use/) - [Custom orchestration Agent](/examples/agents/custom_orchestration_agent/) - [Configure an inline agent at runtime](/examples/agents/inline_agent/) - [Utilize LangChain Tools with Amazon Bedrock Inline Agents](/examples/agents/langchain_tools_with_inline_agent/) - [Provide conversation history to Amazon Bedrock Agents](/examples/agents/manage_conversation_history/) - [Agent using OpenAPI schema](/examples/agents/open_api_schema_agent/) - [Agents with user confirmation before action execution](/examples/agents/user_confirmation_agents/) - [Agents with access to house security camera in cloudformation](/examples/agents/connected_house_agent/) - [Agents with metadata filtering](/examples/agents/metadata_filtering_amazon_bedrock_agents/) - [Agents with human_in_the_loop](/examples/agents/human_in_the_loop/) ## Multi-agent collaboration examples - [00_hello_world_agent](/examples/multi_agent_collaboration/00_hello_world_agent/) - [DevOps Agent](/examples/multi_agent_collaboration/devops_agent/) - [Energy Efficiency Management Agent](/examples/multi_agent_collaboration/energy_efficiency_management_agent/) - [Mortgage Assistant Agent](/examples/multi_agent_collaboration/mortgage_assistant/) - [Portfolio Assistant Agent](/examples/multi_agent_collaboration/portfolio_assistant_agent/) - [Real Estate Investment Agent](/examples/multi_agent_collaboration/real_estate_investment_agent/) - [Startup Advisor Agent](/examples/multi_agent_collaboration/startup_advisor_agent/) - [Support Agent](examples/multi_agent_collaboration/support_agent) - [Team Poems Agent](/examples/multi_agent_collaboration/team_poems_agent/) - [Trip Planner Agent](/examples/multi_agent_collaboration/trip_planner_agent/) - [Voyage Virtuso Agent](/examples/multi_agent_collaboration/voyage_virtuoso_agent/) - [Contract Assistant Agent](/examples/multi_agent_collaboration/contract_assistant_agent/) - [Financial Assitant Agent](/examples/multi_agent_collaboration/Financial-Analyst-Agents) - [Investment Research Agent](/examples/multi_agent_collaboration/investment_research_agent/) ## UX Demos - [Streamlit Demo UI](/examples/agents_ux/streamlit_demo/) - [Data Analyst Assistant for Video Game Sales](/examples/agents_ux/video_games_sales_assistant_with_amazon_bedrock_agents/) - [Dynamic AI Assistant Demo using Amazon Bedrock Inline Agents](/examples/agents_ux/inline-agent-hr-assistant/) ## Best Practices The code samples highlighted in this repository focus on showcasing different Amazon Bedrock Agents capabilities. Please check out our two-part blog series for best practices around building generative AI applications with Amazon Bedrock Agents: - [Best practices for building robust generative AI applications with Amazon Bedrock Agents – Part 1](https://aws.amazon.com/blogs/machine-learning/best-practices-for-building-robust-generative-ai-applications-with-amazon-bedrock-agents-part-1/) - [Best practices for building robust generative AI applications with Amazon Bedrock Agents – Part 2](https://aws.amazon.com/blogs/machine-learning/best-practices-for-building-robust-generative-ai-applications-with-amazon-bedrock-agents-part-2/) Understand Bedrock Multi-agents Collaboration concepts by reading our [blog post](https://aws.amazon.com/blogs/machine-learning/unlocking-complex-problem-solving-with-multi-agent-collaboration-on-amazon-bedrock/) written by Bedrock Agent's science team 🔗 **Related Links**: - [Amazon Bedrock Agents Documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html) - [Amazon Bedrock multi-agent collaboration](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-multi-agents-collaboration.html) - [Boto3 Python SDK Documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/bedrock-agent.html) - [Amazon Bedrock Samples](https://github.com/aws-samples/amazon-bedrock-samples/tree/main) ## Security See [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more information. ## License This project is licensed under the Apache-2.0 License. > [!IMPORTANT] > Examples in this repository are for demonstration purposes. > Ensure proper security and testing when deploying to production environments. ## Contributors :muscle: <a href="https://github.com/awslabs/amazon-bedrock-agent-samples/graphs/contributors"> <img src="https://contrib.rocks/image?repo=awslabs/amazon-bedrock-agent-samples" /> </a> ## Stargazers :star: [](https://github.com/awslabs/amazon-bedrock-agent-samples/stargazers) ## Forkers :raised_hands: [](https://github.com/awslabs/amazon-bedrock-agent-samples/network/members) ", Assign "at most 3 tags" to the expected json: {"id":"13250","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"