# PC DIY 商店 AI 助手使用说明

## 功能概述

AI 助手集成了 Anthropic 的 Claude AI，可以帮助用户：

1. **查询配件信息** - 按类型、品牌、价格范围搜索配件
2. **获取配件类型** - 查看所有可用的配件类型
3. **智能推荐** - 基于用户需求提供配件推荐
4. **价格对比** - 帮助用户比较不同配件的价格和性能

## 环境配置

### 1. 安装依赖

确保已安装 Anthropic SDK：

```bash
bun add @anthropic-ai/sdk
```

### 2. 环境变量

在 `.env.local` 文件中添加：

```env
ANTHROPIC_API_KEY=your_anthropic_api_key_here
NEXT_PUBLIC_APP_URL=http://localhost:3000
```

### 3. 获取 Anthropic API Key

1. 访问 [Anthropic Console](https://console.anthropic.com/)
2. 注册/登录账户
3. 创建 API Key
4. 将 API Key 添加到环境变量中

## API 使用

### 发送查询请求

```javascript
const response = await fetch('/api/ai', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ 
    query: '推荐一些价格在1000-2000元的显卡' 
  }),
});

const data = await response.json();
console.log(data.response);
```

### 支持的工具调用

#### 1. query-components
查询配件信息，支持以下参数：

- `type`: 配件类型ID
- `brand`: 品牌名称
- `minPrice`: 最低价格
- `maxPrice`: 最高价格
- `search`: 搜索关键词
- `page`: 页码（默认1）
- `limit`: 每页数量（默认12）

#### 2. get-component-types
获取所有配件类型列表，无需参数。

## 使用示例

### 示例查询

1. **查询配件类型**
   ```
   "显示所有配件类型"
   "有哪些配件类型可以选择？"
   ```

2. **搜索特定配件**
   ```
   "推荐一些价格在1000-2000元的显卡"
   "查找华硕品牌的主板"
   "有什么高性能的CPU推荐"
   ```

3. **价格筛选**
   ```
   "500元以下的内存条有哪些"
   "3000元左右的显卡推荐"
   ```

4. **品牌筛选**
   ```
   "华硕的所有配件"
   "英特尔的CPU产品"
   ```

### 页面访问

访问 `/ai-assistant` 页面可以使用图形界面与 AI 助手交互。

## 技术架构

### 文件结构

```
lib/
  ai-assistant.ts        # AI 助手核心逻辑
app/
  api/ai/route.ts        # AI API 端点
  ai-assistant/page.tsx  # AI 助手前端页面
components/
  Navbar.tsx            # 导航栏（已添加AI助手链接）
```

### 核心组件

1. **MCPClient 类** - 封装 Anthropic API 调用
2. **工具调用处理** - 处理 AI 对数据库的查询需求
3. **消息处理** - 管理对话上下文和工具结果

## 注意事项

1. **API Key 安全** - 确保 API Key 不要提交到版本控制系统
2. **错误处理** - AI 助手包含完整的错误处理机制
3. **费用控制** - Anthropic API 按 token 计费，建议设置使用限制
4. **网络依赖** - 需要稳定的网络连接到 Anthropic 服务

## 故障排除

### 常见问题

1. **API Key 错误**
   - 检查环境变量是否正确设置
   - 确认 API Key 是否有效

2. **网络连接问题**
   - 检查网络连接
   - 确认 Anthropic 服务是否可访问

3. **数据库连接问题**
   - 确保数据库正常运行
   - 检查 Prisma 配置

### 调试方法

1. 查看浏览器控制台错误
2. 检查服务器端日志
3. 验证 API 响应格式

## 后续扩展

可以考虑添加：

1. **用户偏好记忆** - 记住用户的配件偏好
2. **配置推荐** - 根据预算推荐完整的装机配置
3. **性能对比** - 添加配件性能参数对比功能
4. **库存提醒** - 监控配件库存状态