ADK市场代理
一个使用ADK-TS构建的自主人工智能代理，用于监控竞争对手、分析市场趋势并生成战略报告。为2025年黑客马拉松，我们使用TypeScript和ADK-TS重新构建了它，基于原有的WatchAgent。
特点
- 每日竞争对手扫描
- 基于人工智能的洞察
- 仪表盘用户界面（Dashboard UI）
- MCP刮刀集成
1\. 项目设置（本地开发）
🔹 先决条件
- Node.js（v18+）
- Git
- VS Code 或任何代码编辑器
- GitHub账户
- Vercel 和 Render 账户（用于部署）
______________________________________________________________________
🔹 文件夹结构 手动创建以下结构或从初始模板克隆：
ADKMarketAgent/ ├── README.md ├── adk.config.ts ├── package.json ├── tsconfig.json ├── .gitignore ├── apps/ │ └── dashboard/ │ ├── pages/ │ │ └── index.tsx │ ├── public/ │ ├── styles/ │ ├── package.json │ └── tsconfig.json ├── packages/ │ ├── agent-core/ │ │ ├── src/ │ │ │ └── index.ts │ │ ├── package.json │ │ └── tsconfig.json │ └── mcp-scraper/ │ ├── src/ │ │ └── index.ts │ ├── package.json │ └── tsconfig.json
🔹 安装依赖项
导航至每个文件夹并执行： bash npm install
你需要在以下地方进行此操作：
- 应用程序/仪表盘
- 包/代理核心
- 软件包/mcp-scraper
🧠 2. 代理与MCP设置
🔹 代理逻辑（agent-core/src/index.ts） \`ts 导入 { createAgent } 从 '@iqai/adk-ts'；
const agent = createAgent({ 名称：'ADK市场代理'， 目标：\['扫描竞争对手', '生成见解'\]， 工具：\['mcpScraper'\]， 计划安排：'每日' }); （注：此句在中文中通常不直接翻译，因为它是一个编程或脚本语言中的闭合括号，用于结束一个代码块或函数定义。在中文语境下，我们可能只会说“这是闭合括号”或根据上下文进行更具体的解释。）
默认导出 agent； \`
🔹 MCP 抓取器（mcp-scraper/src/index.ts） \`ts 从 '@iqai/adk-ts' 导入 { createMCP }；
const scraperMCP = createMCP({ 名称：'ADK市场数据抓取器'， 端点：\['https://example.com/products'\]， 解析：(html) => ({ 名称：'示例产品'， 价格：19.99美元， 评分：4.5 }) }); （注：此句为JavaScript代码片段的结尾，直接翻译无实际意义，保持原样）
\export default scraperMCP;\ 翻译成中文是：“导出默认的scraperMCP”； \`
🔹 ADK 配置（adk.config.ts） ts import { defineConfig } from '@iqai/adk-ts';；
导出默认配置，使用 defineConfig 定义配置对象 { 代理（agents）: \['packages/agent-core/src/index.ts'\]， mcps: \['packages/mcp-scraper/src/index.ts'\]，翻译成中文可以是：“mcps: \['packages/mcp-scraper源代码目录下的index.ts文件'\]”。不过，为了更流畅地表达，我们通常会说：“mcps: \['指向 packages/mcp-scraper 目录中 src 子目录下的 index.ts 文件'\]”， }); \`
🖥️ 3. 仪表盘设置
🔹 用户界面（应用程序/仪表板/页面/index.tsx） \`tsx import React from 'react'; 翻译为中文是：从'react'模块导入React；
export default function Home() { 返回（
ADKMarketAgent 控制台
\ alert('扫描开始！')}>开始扫描
报告查看器
); } \`
🚀 4. 部署
✅ 在Vercel上部署前端
- 访问 vercel.com 并使用 GitHub 登录。
- 点击“新建项目”→ 导入您的GitHub仓库。
- 将项目根目录设置为 apps/dashboard。
- Vercel 自动检测 Next.js 并设置构建配置。
- 点击部署。
- 你会得到一个类似这样的实时链接：
https://adkmarketagent.vercel.app
✅ 在Render上部署后端
- 访问 render.com 并使用 GitHub 登录。
- 点击“新建网络服务”→ 选择您的仓库。
- 将根目录设置为 packages/agent-core。
- 设置构建命令：
bash npm install && npm run build
- 设置启动命令：
bash npm start
- 选择免费计划并进行部署。
- 你将获得一个实时API链接，例如：
https://adkmarketagent-backend.onrender.com
📦 5. GitHub 上传
🔹 推送你的代码 bash git init git remote add origin https://github.com/YOUR_USERNAME/ADKMarketAgent.git git add . git commit -m "Initial commit for ADKMarketAgent" git push -u origin master
📝 6. 创新马拉松提交
🔹 提交至DoraHacks
- 参加2025年ADK-TS黑客马拉松
- 点击提交项目
- 填写：
- GitHub 仓库链接 - 演示视频链接 - 实时前端/后端链接 - ADK-TS的使用说明