# 应用内助手

**Assistant** 是 DailyPlay 的内置聊天机器人。它使用与远程 [MCP 服务器](/zh/api/mcp/) 相同的组织范围能力 — 创建游戏、生成素材、管理兑换码、阅读报告等 — 无需离开面板或创建 API key。

:::note[所有层级均可用]
Assistant 在**所有订阅层级**上可用。远程 MCP 与 API Keys 仍需 **Business** 或更高。聊天中的连接工具遵循您计划的 Connections 页面访问权限（Professional+）。
:::

## 打开助手

您需要已登录且拥有有效组织。

| 入口 | 方式 |
| --- | --- |
| 悬浮面板 | 点击应用右下角的助手按钮 |
| 完整页面 | 在侧边栏打开 **Assistant**，或前往 `/assistant` |
| Create with AI | 在 **Create** 上描述您的游戏并提交 — 会打开带该提示的 Assistant |

两个视图共享同一用户 + 组织的对话与聊天历史。

## 您可以问什么

与助手工具良好对应的示例：

- 「列出幸运转盘活动的游戏模板」
- 「用模板 X 和我们的品牌色创建草稿游戏」
- 「为每个模板素材生成美术，然后发布游戏」
- 「创建兑换码集并导入这些代码」
- 「汇总过去 30 天的游玩数据」
- 「为游戏 42 生成游玩会话链接」

助手代表您使用已登录角色（viewer、analyst、editor、admin 或 owner）调用工具。您无权使用的工具会自动隐藏。

## 工作原理

1. 您在面板或 `/assistant` 上发送消息
2. DailyPlay 流式返回回复（SSE），同时模型可能调用工具
3. 工具活动显示为紧凑摘要（可展开查看单个工具）
4. 消息保存到该组织的对话历史

长时间多步骤任务（尤其是批量图片生成）可能在达到工具轮次限制时暂停并显示 **Continue** 提示。点击继续可从相同上下文恢复。

### 实时游戏预览

助手创建或更新游戏（及相关测验/奖品工具）后，聊天中可能出现 **Live preview**，以便您无需离开对话即可试玩。若素材已更改且需要更新预览，请使用 **Refresh**。

### 附件与建议回复

- 附加品牌美术或简报（图片/文档），以便助手在生成素材或活动计划时分析它们
- 当助手提供**建议回复**时，点击一个继续 — 或输入您自己的回答

## 对话

- 从历史列表开始**新聊天**
- 在过去的对话之间切换
- 不再需要时删除对话

对话标题来自您的第一条消息。

## 限制与访问

| 约束 | 行为 |
| --- | --- |
| Auth | 已登录的 Clerk 用户 + 有效组织（不接受 API keys） |
| Role | 工具按组织角色筛选 |
| Tier | 除非计划包含 Connections，否则隐藏连接工具 |
| Rate limit | 默认每位用户在组织中每分钟 **20** 条消息、每天 **200** 条 |

超过速率限制会返回临时错误；请等待后重试。

## 隐私

敏感工具数据在发回模型及存入聊天历史之前会被脱敏。包括：

- CTA 线索 PII（姓名、邮箱、电话、自定义字段）
- 兑换码
- 记分板玩家姓名
- 凭据 / 密钥

汇总与资源 ID 保留，以便助手继续工作。使用 API key 调用工具的远程 MCP 客户端仍会收到该密钥范围内的完整载荷。

## Assistant 与 MCP

| | 应用内助手 | 远程 MCP |
| --- | --- | --- |
| 使用者 | 面板用户 | 外部智能体（Cursor、Claude 等） |
| Auth | 已登录会话 | 组织 API key（`dpk_…`） |
| Tier | 所有层级 | Business+ |
| 设置 | 无需 | 客户端配置 + 密钥上的 MCP 范围 |

## 下一步

- [MCP 服务器](/zh/api/mcp/) — 连接 Cursor、Claude 或其他智能体
- [MCP 工具参考](/zh/api/mcp-tools/) — 助手可调用的每项能力
- [API Keys](/zh/api/api-keys/) — 远程 MCP 访问的范围