{"repo":"lastingyeh/adk-insurance-recommendation-agent","free":true,"listed":false,"github":"https://github.com/lastingyeh/adk-insurance-recommendation-agent","clone":"git clone https://github.com/lastingyeh/adk-insurance-recommendation-agent.git","description":"基於 Google ADK 與 MCP Toolbox 的保險科技推薦 Agent 原型。核心 Agent 能理解保險需求、主動追問，並透過受控 SQL 工具查詢醫療、意外、家庭與收入保障產品。後端採 FastAPI 提供 SSE 串流與 WebSocket 即時互動，前端以 Next.js 呈現對話介面。知識庫結合 PostgreSQL 與 pgvector 實現 FAQ 語意搜尋與 RAG 查詢，並支援多模態 Live Agent 語音互動。安全層涵蓋 JWT 驗證、PII 脫敏與 SHA-256 雜湊鏈防篡改稽核日誌。品質保證採 ADK evalsets 評估驅動開發，部署支援 Docker Compose、Cloud Run 與 Terraform 多環境配置。","language":"TypeScript","stars":21,"topics":["adk","ai-agents","fastapi","gcp","insurtech","live-streaming","mcp","nextjs"],"license":null,"category":"ai-agents","readme_excerpt":"保險推薦 Agent 這是一個以 Google ADK 為核心的保險推薦 Agent 範例專案。系統整合 FastAPI、Next.js、MCP Toolbox、PostgreSQL/pgvector 與 Gemini/Vertex AI，示範如何建立具備產品查詢、FAQ 語意搜尋、會話記憶、稽核紀錄、PII 保護，以及即時語音/影像互動能力的 AI Agent。 👉 線上展示專案：https://lastingyeh.github.io/adk-insurance-recommendation-agent/ 這份 README 的目標是讓使用者快速完成三件事： 1. 了解這個專案解決什麼問題。 2. 在本機把系統跑起來。 3. 知道要深入架構、測試或部署時該看哪些文件。 核心功能 - Google ADK Agent：理解保險需求、主動追問、查詢產品並產生推薦回覆。 - MCP Toolbox：透過受控 SQL 工具查詢保險產品、推薦規則與 FAQ 知識庫。 - FastAPI 後端：提供 REST API、SSE 串流回覆與 WebSocket 即時互動。 - Next.js 前端：提供保險推薦對話介面、Live mode 與 Agent 狀態視覺化。 - PostgreSQL + pgvector：儲存產品、FAQ、Session、Audit Log 與向量資料。 - Multimodal Live Agent：支援即時語音、畫面與互動式對話。 - 安全與合規設計：包含 JWT 驗證、PII redaction、public state filtering 與 audit hash chain。 - 評估驅動開發：使用 ADK evalsets 驗證推薦品質、安全性、session-aware 行為與 Live mode。 - 雲端部署準備：提供 Docker Compose、Cloud Run 與 Terraform dev/staging/prod 部署入口。 系統架構 技術組成 類別 技術 ---------------- ------------------------------------ Agent 框架 Google ADK LLM / 多模態模型 Gemini / Vertex AI 後端 API FastAPI, Uvicorn 前端 Next.js 15, React 19, NextAuth.js 資料庫 PostgreSQL, pgvector 工具層 MCP Toolbox for Databases 驗證 JWT, NextAuth 基礎設施 Docker Compose, Cloud Run, Terraform 測試與評估 pytest, ADK eval, Locust 套件管理 uv, npm 專案目錄 前置需求 本專案本機開發需準備以下工具、套件與環境。詳細 macOS 本機安裝與核准檢核，請參閱完整的 環境安裝與核准檢查清單 (setup-env.md)。 📋 必備工具與套件 (Required Tools & Dependencies) - Python 3.12 - uv - Node.js 20 或更新版本 - npm - Docker 與 Docker Compose - Google Cloud credentials：使用 Vertex AI、embedding、雲端部署或 Toolbox 語意搜尋時需要 先建立本機環境設定檔： 接著依照你的環境修改 .env 。 快速開始 方式一：","default_branch":null,"files":null,"tree":[],"storefront":"/r/lastingyeh","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/lastingyeh/adk-insurance-recommendation-agent/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}