Python与Ollama的开发案例
「实操教程」OpenAI 大会之后：如何在 Playground 使用 Assistant API 打造专属知识库
作者: xiaoxin.gao
2025-06-26
一、前言
今天，我将为大家实操演示两种使用 Assistants API 的方法，由易到难。Assistants API 是 OpenAI 刚刚新鲜出炉的助手 API，它为所有 APP 的开发者集成 AI 功能带来了极大的便利。在 OpenAI 开发者大会刚结束两天之际，让我们来看看如何在 OpenAI 的 Playground 中使用 Assistant API 打造专属知识库。
二、OpenAI Playground 简介
OpenAI 的 Playground（platform.openai.com）是一个供开发者测试和练习 API 的平台。它新增加了 Assistants 功能，这就是新推出的 Assistants API 的 Playground。在这里，你可以创建和管理你的 Assistants，并通过它们来实现各种功能。
三、创建个人知识库
（一）创建新的 Assistant
- 进入 Playground：登录到 OpenAI 的 Playground 平台。
- 选择 Assistants：在左侧菜单中选择 Assistants。
- 创建新 Assistant：点击左上角的菜单，选择创建一个新的 Assistant。
- 命名 Assistant：给你的 Assistant 起一个名字，例如“Axton 博客”。
- 编写 Prompt：在 Instruction 部分编写 Prompt，这相当于 System Message。例如：
你将担任 Axton 的高级内容分析师。Axton 是一位在 AI 自动化、高效工作流程、ChatGPT、Notion Make、Prompt Engineer 等领域具有丰富经验的内容创作者。你的任务是基于 Axton 上传的博客文章内容，回答用户的问题，并提供深入的洞见。- 选择模型：选择最新的模型，如 GPT-4-1106 Preview（GPT-4-Turbo）。
- 添加工具：选择“retrieval”工具，用于从上传的文章中检索信息。
- 上传文件：点击“upload”，上传你的博客文章或其他相关文件。
- 保存 Assistant：上传完成后，点击保存。
（二）测试 Assistant
- 提问：在用户输入框中输入问题，例如“请简单谈一下苹果的 AI 技术和产品逻辑”。
- 运行：点击“Add and Run”按钮，运行 Assistant。
- 查看结果：查看 Assistant 的回答，并检查引用的文件和内容是否正确。
（三）复杂示例
- 合并文件：如果文件数量超过 20 个，可以将多个文件合并为一个大文件。例如，将所有 YouTube 视频字幕文件合并为一个 JSON 文件。
- 创建新 Assistant：按照上述步骤创建一个新的 Assistant，命名为“Axton 视频”。
- 修改 Prompt：编写更详细的 Prompt，确保 Assistant 能够正确引用视频 ID 和链接。例如：
你将担任 Axton 的高级内容分析师。你的任务是基于 Axton 上传的视频字幕内容，回答用户的问题，并提供视频链接。如果字幕中没有相关内容，请直接回答“我不知道”。 - 上传文件：上传合并后的 JSON 文件。
- 测试：提问并运行 Assistant，检查回答和引用的链接是否正确。
四、注意事项
- Prompt 的重要性：Prompt 的编写对 Assistant 的表现至关重要。简单和复杂的 Prompt 会导致完全不同的效果。
- 文件格式：确保上传的文件格式正确，例如 JSON 文件的结构应包含视频 ID 和内容。
- API 稳定性：由于 API 刚刚开放，可能会出现不稳定的情况。如果遇到问题，可以稍后再试。
五、总结
通过以上步骤，你可以在 OpenAI 的 Playground 中使用 Assistant API 打造专属的知识库。无论是简单的博客文章还是复杂的视频字幕，都可以通过 Assistant API 实现高效的检索和回答。更多详细内容和调试过程，我将在实战派课程中更新，敬请期待。
原文引自YouTube视频：https://www.youtube.com/watch?v=kAeR80hZoNw
🔥