source-management

数据源管理

如果你看到不熟悉的占位符，或需要检查哪些工具已连接，请参阅 CONNECTORS.md。

了解有哪些数据源可用，帮助连接新的数据源，并管理数据源的查询方式。

检查可用数据源

通过检查可用工具来确定哪些 MCP 数据源已连接。每个数据源对应一组 MCP 工具：

数据源	主要能力
~~chat	搜索消息，读取频道和话题串
~~email	搜索消息，读取单封邮件
~~cloud storage	搜索文件，获取文档内容
~~project tracker	搜索任务，输入即搜索
~~CRM	查询记录（客户、联系人、商机）
~~knowledge base	语义搜索，关键词搜索

如果某个工具前缀可用，则说明该数据源已连接且可以搜索。

引导用户连接数据源

当用户进行搜索，但只连接了很少或没有连接任何数据源时：

You currently have [N] source(s) connected: [list].

To expand your search, you can connect additional sources in your MCP settings:
- ~~chat — messages, threads, channels
- ~~email — emails, conversations, attachments
- ~~cloud storage — docs, sheets, slides
- ~~project tracker — tasks, projects, milestones
- ~~CRM — accounts, contacts, opportunities
- ~~knowledge base — wiki pages, knowledge base articles

The more sources you connect, the more complete your search results.

当用户询问某个未连接的特定工具时：

[Tool name] isn't currently connected. To add it:
1. Open your MCP settings
2. Add the [tool] MCP server configuration
3. Authenticate when prompted

Once connected, it will be automatically included in future searches.

数据源优先级排序

不同类型的查询适合优先搜索特定的数据源。这些优先级用于为结果加权，而不是跳过其他数据源：

按查询类型

决策类查询（“我们决定了什么……”）：

1. ~~chat (conversations where decisions happen)
2. ~~email (decision confirmations, announcements)
3. ~~cloud storage (meeting notes, decision logs)
4. Wiki (if decisions are documented)
5. Task tracker (if decisions are captured in tasks)

状态类查询（“……的状态如何”）：

1. Task tracker (~~project tracker — authoritative status)
2. ~~chat (real-time discussion)
3. ~~cloud storage (status docs, reports)
4. ~~email (status update emails)
5. Wiki (project pages)

文档类查询（“……的文档在哪里”）：

1. ~~cloud storage (primary doc storage)
2. Wiki / ~~knowledge base (knowledge base)
3. ~~email (docs shared via email)
4. ~~chat (docs shared in channels)
5. Task tracker (docs linked to tasks)

人员类查询（“谁在负责……” / “谁了解……”）：

1. ~~chat (message authors, channel members)
2. Task tracker (task assignees)
3. ~~cloud storage (doc authors, collaborators)
4. ~~CRM (account owners, contacts)
5. ~~email (email participants)

事实/政策类查询（“我们关于……的政策是什么”）：

1. Wiki / ~~knowledge base (official documentation)
2. ~~cloud storage (policy docs, handbooks)
3. ~~email (policy announcements)
4. ~~chat (policy discussions)

默认优先级（通用查询）

当查询类型不明确时：

1. ~~chat (highest volume, most real-time)
2. ~~email (formal communications)
3. ~~cloud storage (documents and files)
4. Wiki / ~~knowledge base (structured knowledge)
5. Task tracker (work items)
6. CRM (customer data)

速率限制注意事项

MCP 数据源可能设有速率限制。请妥善处理：

检测

速率限制响应通常表现为：

• HTTP 429 响应
• 错误信息中提到“rate limit”、“too many requests”或“quota exceeded”
• 被节流或延迟的响应

处理

当某个数据源受到速率限制时：

1. 不要立即重试，应遵守限制
2. 继续查询其他数据源，不要阻塞整个搜索
3. 告知用户：

Note: [Source] is temporarily rate limited. Results below are from
[other sources]. You can retry in a few minutes to include [source].

4. 对于摘要汇总：如果在扫描过程中触发速率限制，请注明在达到限制前已覆盖的时间范围

预防

• 避免不必要的 API 调用，查询前先判断该数据源是否可能有相关结果
• 尽可能使用有针对性的查询，而不是大范围扫描
• 对于摘要汇总，如果 API 支持，则合并批量请求
• 注意缓存：如果刚刚运行过某个搜索，避免立即重复运行相同的查询

数据源健康状态

在会话期间跟踪数据源的可用性：

Source Status:
  ~~chat:        ✓ Available
  ~~email:        ✓ Available
  ~~cloud storage:  ✓ Available
  ~~project tracker:        ✗ Not connected
  ~~CRM:   ✗ Not connected
  ~~knowledge base:      ⚠ Rate limited (retry in 2 min)

报告搜索结果时，请注明搜索了哪些数据源，以便用户了解答案的范围。

添加自定义数据源

企业搜索插件可与任何通过 MCP 连接的数据源配合使用。随着新的 MCP 服务可用，可将其添加到 .mcp.json 配置中。搜索和摘要命令会根据可用工具自动检测并纳入新的数据源。

添加新数据源的步骤：

1. 将 MCP 服务配置添加到 .mcp.json
2. 如需要，完成身份验证
3. 之后的搜索会自动包含该数据源