AI-powered bilingual (English/Spanish) chatbot for the ISU pork industry. Answers questions using a Bedrock Knowledge Base and streams responses with source citations. Low-confidence queries can be escalated to an admin via email; admin replies with PDFs are ingested into the KB.
Customers are responsible for making their own independent assessment of the information in this document. This document:
(a) is for informational purposes only,
(b) references AWS product offerings and practices, which are subject to change without notice,
(c) does not create any commitments or assurances from AWS and its affiliates, suppliers or licensors. AWS products or services are provided "as is" without warranties, representations, or conditions of any kind, whether express or implied. The responsibilities and liabilities of AWS to its customers are controlled by AWS agreements, and this document is not part of, nor does it modify, any agreement between AWS and its customers, and
(d) is not to be considered a recommendation or viewpoint of AWS.
Additionally, you are solely responsible for testing, security and optimizing all code and assets on GitHub repo, and all such code and assets should be considered:
(a) as-is and without warranties or representations of any kind,
(b) not suitable for production environments, or on production or other critical data, and
(c) to include shortcuts in order to support rapid prototyping such as, but not limited to, relaxed authentication and authorization and a lack of strict adherence to security best practices.
All work produced is open source. More information can be found in the GitHub repo.
| Index | Description |
|---|---|
| High-Level Architecture | Component interactions and data flow |
| Deployment | How to deploy the project |
| User Guide | End-user usage instructions |
| Directories | Project directory structure |
| API Documentation | Chat streaming API reference |
| Modification Guide | Extending or changing the system |
The frontend (Next.js on Amplify) sends chat messages to a Lambda Function URL. The Lambda runs a Strands AI agent backed by Amazon Nova 2 Lite and a Bedrock Knowledge Base (OpenSearch Serverless, web crawlers, and S3 email data). Responses stream back via SSE with source citations. Email escalation and admin reply ingestion use SES and EventBridge-triggered sync.
Detailed architecture: Docs/architectureDeepDive.md
├── Backend/
│ └── isu-pork-project/
│ ├── bin/ # CDK app entry point
│ ├── lambda/ # Chatbot (Docker), email processor, KB sync
│ └── lib/ # CDK stacks
├── Docs/ # Project documentation
├── Frontend/
│ └── V2-frontend-ISU-pork/
│ └── isu-chatbot-v2/ # Next.js chat UI
└── README.md
- Backend/isu-pork-project — AWS CDK (TypeScript). Stacks: Knowledge Base (OpenSearch Serverless, web crawlers), main backend (Lambda, DynamoDB, SES), Amplify frontend, SES receiving, KB sync scheduler.
- Docs — Architecture, deployment, user guide, API doc, modification guide.
- Frontend/V2-frontend-ISU-pork/isu-chatbot-v2 — Next.js app with chat widget, i18n (en/es), and Amplify build config.
This application was architected and developed by Loveneet Singh, Sayantika Paul, and Shristi Pathak, with solutions architect Arun Arunachalam, program manager and product manager Rachel Hayden. Thanks to the ASU Cloud Innovation Centre Technical and Project Management teams for their guidance and support.
This project is distributed under the MIT LICENSE in this repository.