用户交互

用户如何在 ChatGPT 中发现、参与、激活和管理可用的应用。

发现

发现是指用户或模型了解你的应用及其提供的工具的不同方式:自然语言提示、目录浏览和主动入口点。Apps SDK 依赖于你的工具元数据和过去的使用情况来做出智能选择。

命名提及

当用户在提示的开头提到你的应用名称时,你的应用将自动在响应中呈现。用户必须在提示的开头指定你的应用名称。

对话内发现

当用户发送提示时,模型会评估:

对话上下文 - 聊天历史,包括先前的工具结果、记忆和明确的工具偏好
对话品牌提及和引用 - 查询中是否明确请求了你的品牌,或者你的品牌是否作为搜索结果中的来源/引用呈现
工具元数据 - 你在 MCP 服务器中提供的名称、描述和参数文档
用户链接状态 - 用户是否已授予对你的应用的访问权限,或者在工具运行之前是否需要连接它

你可以通过以下方式影响对话内发现:

编写面向操作的工具描述
在资源 UI 模板元数据上编写清晰的 Component 描述
在 ChatGPT 开发者模式下定期测试你的黄金提示集

目录

目录将为用户提供一个可浏览的界面,以在对话之外查找应用。你的列表将包括:

应用名称和图标
简短和详细描述
标签或类别
可选的入门说明或屏幕截图

入口点

一旦用户链接了你的应用,ChatGPT 可以通过几个入口点呈现它。

对话内入口

已链接的工具始终在模型的上下文中处于激活状态。当用户编写提示时,助手根据对话状态和元数据决定是否调用你的工具。

最佳实践:

保持工具描述面向操作
返回引用稳定 ID 的结构化内容
为客户端渲染提供 _meta 提示

启动器

启动器(可从编辑器中的 + 按钮访问)是一个高意图入口点,用户可以在其中明确选择应用。

考虑因素:

深度链接 - 包含启动提示或预填充参数
上下文感知 - 根据当前对话状态调整应用行为

本文档详细说明了应用在 ChatGPT 生态系统中的发现和使用方式,为开发者提供了优化用户体验的指导。