工作空间文档是GoInsight.AI中用于创建、上传、管理和调用文档资料的统一空间。你可以在这里维护企业资料、业务说明、FAQ、流程文档、Prompt、代码片段、工作流读写数据、全局配置等内容，并根据使用场景选择不同类型的文档进行管理。
它既可以为 AI 提供上下文，支持 AI 基于文档内容进行理解、检索和回答；也可以作为工作流中的文本存储空间，用于跨工作流、跨会话地读取、写入和共享关键数据。
工作空间文档有什么用
工作空间文档的核心价值，是让资料、代码、Prompt 和配置内容从分散存放变成可管理、可复用、可调用的工作资产。你可以将工作空间文档用于以下场景。
1. 给 AI 提供上下文
工作空间文档可以作为 AI 的上下文来源。将产品说明、FAQ、操作手册、业务制度、培训资料等内容维护到工作空间文档后，AI 可以在回答问题、执行任务或生成内容时调用这些资料，减少只依赖模型通用知识带来的偏差。
适合用于：
- AI 问答
- RAG 检索
- 智能体调用资料
- 基于企业资料生成总结、回复、报告或说明
2. 存储纯文本，用在工作流中
工作空间文档也可以用于存储无格式文本，并在工作流中读取和写入。它不仅可以放普通资料，也可以承担类似代码库、Prompt 库和全局配置文件的作用。
你可以把它用作：
- 代码库：存储脚本、代码片段或可复用逻辑，在 Code 节点中读取和使用
- Prompt 库：存储常用 Prompt 模板，在 LLM 节点或 Agent 中调用
- 全局配置文件：存储跨流程、跨会话共享的配置和关键数据，类似 PC 中的 .ini 文件或注册表，让不同工作流、不同会话之间可以通过工作空间文档传递和复用信息
- 工作流数据文件：保存工作流运行中需要读取、更新或长期保留的文本数据
3. 进行版本管理
对于代码、Prompt、配置文件等内容，版本管理非常重要。
例如，当你调整了一个 Prompt 后，发现新版本效果不如之前，如果没有历史记录，就很难回到原来的版本。通过工作空间文档的历史版本和内容对比能力，可以查看文档变更记录，并在需要时参考或恢复之前的内容。
版本管理适合用于：
- Prompt 迭代与回退
- 代码片段修改记录
- 配置文件变更追踪
- 重要业务文档的历史对比
功能模块介绍
1. 工作空间文档库
1）企业文档库
企业文档适合存放团队或组织级资料，例如企业制度、产品文档、客服 FAQ、培训资料、项目交付文档、团队共享 Prompt、公共配置文件等。
2）个人文档库（Personal Data）
Personal Data 是成员在组织内的个人独立存储空间，与其他成员隔离。适合存放个人长期记忆、过程资料及其他个人使用的信息。个人文档主要面向个人使用，适合管理不需要团队共享的内容。
2. 工作空间文档
1）创建富文本文档
富文本文档支持Markdown格式，适合用于维护结构清晰、便于阅读、适合 AI 检索的知识内容，例如产品说明、FAQ、操作指引、制度文档、培训资料等。我们也提供了文档撰写的一些技巧，您可以在撰写技巧中随时查看。
2）创建代码或纯文本文档
代码或纯文本文档适合存放无格式文本内容，主要面向工作流数据读写、代码存储、Prompt 管理和配置维护。这类文档不会用于 AI 训练，更适合作为工作流运行过程中读取、写入或维护的数据内容。你可以在创建该文档时选择文档使用的编程语言，包括Plain Test、Json、Python等。
3）上传文档
如果已有本地文件，可以通过上传文档的方式添加到工作空间文档中。上传后，文件会进入当前目录，用户可以继续进行查看、整理和管理。支持上传的文件类型包括 Markdown、TXT、JSON、YAML、XML、Python、JavaScript、DOCX 等，具体支持范围以页面展示为准。
4）导入网页
导入网页可以将网页内容转换为工作空间中的文档，适合把在线帮助文档、产品说明页、公开资料等内容沉淀到工作空间文档中。导入网页后，强烈建议对内容进行检查和整理，删除无关的网页元素，例如导航栏、页脚、广告、推荐内容、重复链接、版权信息等。保留干净、准确、与业务相关的正文内容，可以提升后续阅读、检索和 AI 问答效果。
3. 历史版本与文档对比
工作空间文档支持对文档内容进行版本管理。当文档被修改后，可以通过历史版本查看之前的内容，并对比不同版本之间的差异。对于 Prompt、代码和配置文件来说，版本管理还可以帮助用户更安全地迭代内容。例如，当新的 Prompt 效果不如旧版本时，可以通过历史版本找到之前的内容，快速对比差异并恢复有效写法。
4. 工作空间文档权限
在企业文档库中，你可以为不同文件夹设置不同的权限，用于控制成员是否可以管理该文件夹下的成员、编辑文档、查看文档，或仅允许在机器人和工作流中调用文档内容。
当前支持以下权限：
- 可管理：可管理成员，编辑/删除文档。
- 可编辑：可查看/编辑文档。
- 仅查看：仅可查看文档。
- 仅执行：仅支持在机器人、工作流中进行调用，无法查看具体内容。适合需要保护文档内容，但又希望文档可以被自动化流程调用的场景。
「仅执行」权限适合用于保护 Prompt、配置文件、业务规则或内部资料。例如，企业可以允许机器人或工作流在运行时调用这些内容，但不允许成员直接查看文档原文。
需要注意的是，多级文件夹之间的权限不会自动继承。也就是说，父级文件夹配置的权限不会默认应用到子级文件夹，子级文件夹如需开放给相同成员或设置不同权限，需要单独配置。
推荐使用方式
为了让工作空间文档更容易维护和调用，建议：
- 团队共享资料优先放入企业文档
- 个人临时资料或个人工作流数据放入个人文档
- 用富文本文档维护适合阅读、检索和 AI 问答的知识内容
- 用无格式文档存放代码、Prompt、配置、日志、工作流读写数据等纯文本内容
- 将常用 Prompt 模板集中维护，便于 LLM 节点和 Agent 复用
- 将跨流程、跨会话需要共享的信息整理为配置文件
- 修改 Prompt、代码或配置前，注意保留历史版本，方便对比和回退
- 上传文件后及时归类到合适的文件夹
- 导入网页后先清理无关网页元素，再作为正式资料使用
- 用清晰的文件名和目录结构管理文档，方便后续搜索和调用
总结
工作空间文档是 GoInsight.AI 中统一管理和调用文档内容的空间。它不仅可以用于企业资料沉淀、个人资料整理和 AI 问答，也可以作为代码库、Prompt 库、工作流数据文件和全局配置文件使用。
通过选择合适的文档类型，并结合历史版本管理能力，工作空间文档可以帮助个人和团队更高效地维护资料、迭代 Prompt 和代码、共享配置，并让这些内容在 AI 和自动化流程中被稳定调用。
发表评论.