需通过四步完成WorkBuddy与龙虾Skills集成：一、配置服务端接入点并启用认证；二、注册单个技能至本地目录并启用沙箱隔离；三、在流程中拖入外部AI技能节点并绑定输入输出；四、开启上下文透传机制，配置白名单字段并验证日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望在WorkBuddy中集成龙虾Skills以增强AI任务处理能力，则需通过标准化接口与技能注册机制完成能力注入。以下是实现该集成的具体步骤：
一、配置龙虾Skills服务端接入点
此步骤旨在为WorkBuddy提供可通信的龙虾Skills服务地址，确保后续调用时能准确定位并建立HTTPS连接。服务端需已部署并启用健康检查接口。
1、获取龙虾Skills服务的公网域名或内网IP及端口，确认其响应路径为/v1/skills/health并返回HTTP 200状态码。
2、登录WorkBuddy管理后台，在【系统设置】→【AI扩展】→【外部技能源】页面点击“新增源”。
3、在“名称”栏输入longxia-skills-prod，在“基础URL”栏粘贴完整服务地址（含协议与路径前缀，如https://skills.longxia.ai/api/）。
4、勾选“启用认证”，在Token字段填入由龙虾Skills平台签发的Bearer令牌（格式为eyJhbGciOiJIUzI1Ni...）。
二、注册单个技能到WorkBuddy技能目录
该操作将龙虾Skills中已发布的具体能力单元（如“合同条款比对”“多语种会议纪要生成”）同步至WorkBuddy本地技能索引，使其可被工作流节点调用。
1、在龙虾Skills控制台进入【技能发布】页，找到目标技能卡片，点击右侧“复制ID”，ID格式为skill-7a3f9b2e-dc11-4e8c-b5a6-8f0e1a2b3c4d。
2、返回WorkBuddy【AI扩展】→【技能目录】页，点击“手动注册”，粘贴ID至“技能唯一标识”输入框。
3、点击“预检”，系统自动拉取该技能的元数据（包括名称、描述、输入参数schema、输出结构），校验通过后显示“签名有效，参数定义完整”提示。
4、勾选“启用运行时沙箱隔离”，点击“提交注册”，技能状态变为“已就绪（Ready）”。
三、在自动化流程中调用龙虾Skills节点
此步骤将已注册的龙虾Skills作为独立执行单元嵌入WorkBuddy工作流，支持传入动态变量并捕获结构化输出结果，无需编写代码即可复用AI能力。
1、进入WorkBuddy【流程编排】页，新建或编辑任一工作流，拖入一个“外部AI技能”节点至画布。
2、双击该节点，在下拉菜单中选择已注册的龙虾Skills条目，例如“多语种会议纪要生成（v2.3）”。
3、在“输入映射”区域，将上游节点输出字段（如meeting_transcript_text）绑定至技能参数input_text，将language_code设为固定值zh-CN。
4、在“输出解析”区域，勾选“启用JSON Schema校验”，粘贴龙虾Skills文档中提供的响应schema片段，确保返回字段summary、action_items、attendees可被下游节点直接引用。
四、启用双向上下文透传机制
该机制允许WorkBuddy会话上下文（如用户身份、历史消息ID、当前项目编号）自动注入龙虾Skills执行环境，使技能输出具备业务语境感知能力，避免重复传递上下文参数。
1、在WorkBuddy【系统设置】→【AI扩展】→【上下文透传】页，开启“会话级上下文自动注入”开关。
2、在“透传字段白名单”中添加三项：session_id、user_org_id、current_project_key，每项均需匹配龙虾Skills接收端约定的header名，例如X-WorkBuddy-Session-ID。
3、验证方式：触发一次含龙虾Skills节点的流程，在WorkBuddy日志页筛选关键词“context-injected: true”，确认日志中出现对应header键值对。
4、若龙虾Skills返回错误码401且日志显示“missing X-WorkBuddy-User-Org-ID”，则需检查白名单字段拼写是否与Skills端完全一致（区分大小写）。
