AI Agent准备查询客服数据时，认证方式应按客户端能力和团队管理方式选择：支持 OAuth 2.1 的客户端可用浏览器登录授权，不支持 OAuth 的客户端通常使用 API Key 作为 Bearer 凭据。先核对 Streamable HTTP、权限与地址，再用一条已知会话验证结果，能减少“连接成功却查不到数据”的排查成本。
准备把客户、会话或消息接入 AI Agent 前，先把使用方式说清楚。是管理员为固定客户端配置一次，还是多个同事各自登录并按账号授权？是只做客服数据查询，还是还要在用户确认后执行打开会话、批量消息等受控操作？这些问题决定了凭据如何保存、谁能撤销，以及出问题时怎样追查。
知你AI助手的连接器通过 Streamable HTTP 连接 AI 客户端。后台提供 API Key 和 OAuth 2.1 两种认证路径，二者选其一即可，不应在同一份配置里混放。千问办公、WorkBuddy、Codex、Claude Code、Cursor 等客户端的具体入口和版本支持要分别核对；“能使用 AI”不等于已经支持这种 MCP 传输。
选型时可以先列出三项条件：
API Key 更适合客户端没有 OAuth 流程、需要复制固定连接配置的场景。管理员先在知你AI助手后台创建或选择一个 Key，客户端把它作为 Bearer 凭据发送；Key 本身不是业务问题的参数，也不应放进文章、截图、代码仓库或共享聊天。一个团队若多人共用同一个 Key，后续很难区分调用来源，人员离开时也需要评估是否整体更换。
OAuth 2.1 更适合希望每位使用者通过浏览器登录知你账号并明确授权的场景。连接配置不需要 API Key，首次连接时客户端打开授权页面，用户完成登录和确认后由客户端管理访问令牌。这样可以把账号授权和客户端配置分开，但前提是客户端真的支持 OAuth 2.1，且登录窗口、回调和授权提示能正常完成。
下面是连接器页面的布局示意：客户端、认证方式、配置输出和能力范围分开呈现，Key 只显示打码示例。它不是某个 AI Agent 的实际窗口，示例账号与数据均为虚拟内容。
不要把“配置被保存”当成“客服数据已经能查”。建议用一条范围清楚、结果已知的问题做验证：例如限定某个已接入渠道和近 7 天，再查询一个测试客户曾经提到的关键词。结果返回后，回到知你客服原会话核对客户、消息时间和原话；如果命中为空，依次检查数据是否进入客服系统、时间表达是否对应消息发送时间、关键词是否过宽，以及当前账号是否有访问权限。
连接成功后，AI Agent 能调用哪些客服数据能力，要以后台当前连接说明、客户端实际发现的工具和账号授权范围为准。查询当前等待队列与查找过往沟通记录是不同任务；如果结果与预期不符，先确认调用的是哪类能力、查询条件是否完整，再回到原系统核对依据，不要把空结果直接解释成客户从未咨询。
可按下面顺序完成首次验证：
下图是查询验证的流程示意，不是知你AI助手后台页面；它强调“限定范围—查看依据—人工复核”的关系。
API Key 方式要检查保存位置、共享成员和撤销办法。后台当前页面提示同一个 API Key 每秒调用不超过 5 次，团队应按实际查询量安排 Key 和提问节奏，不把限流提示解释成业务数据缺失。OAuth 方式则要确认授权账号、浏览器回调和退出后的重新授权路径，避免同一台电脑残留错误账号。
还要把“查询”和“受控操作”分开验收。连接器资料列出的能力包括客户资料、会话和消息查询；批量打开对话或发送文本/图片消息需要明确选定 UID，并经过用户确认的二阶段流程。连接认证成功，不代表 AI Agent 可以修改客户资料、标签或自动把搜索结果当成收件人。该方案适合先从只读查询和人工复核开始试点，再根据团队权限评估是否启用受控操作。
如果更换客户端，先复制一份不含真实凭据的配置模板，再按该客户端的认证入口重新填写。不要把旧 Key 直接发给外部协作者，也不要因为一次连接失败就连续创建多个 Key；先记录错误、客户端版本、认证方式和验证问题，排查结果才可复用。
不需要同时配置。按客户端支持情况选择一种认证方式即可。
使用后台创建的API Key，以安全的Bearer凭据方式配置到客户端。
不需要。OAuth由浏览器登录授权，连接配置不放API Key。
先查数据、权限、时间和关键词，再用已知会话回到原系统核对。
当前连接器以查询为主，不应把认证成功理解成可修改客户资料或标签。
AI Agent接入客服数据时，API Key解决兼容性和固定配置问题，OAuth 2.1解决登录授权和账号分离问题。先按客户端能力选认证方式，再用范围明确的测试会话验证数据、权限和时间口径。评估时，把凭据管理、Streamable HTTP、原话复核和受控操作确认一起列入验收清单。
如果团队准备让 AI Agent 查询客户和历史会话，可以查看知你AI助手的连接器与授权说明。
也可以扫码联系知你客服：
全渠道智能客服系统，聚合微信、小红书、抖音等平台咨询，支持自动回复与多客服协同。
知你AI助手官网 >AI 驱动的智能接待助手，基于知识库生成可确认的推荐回复，提升响应效率。
知你快回官网 >浏览器插件，为小红书、抖音、网页客服场景提供快捷话术库与 AI 自动回复。
