APA 技能包的创建、管理及使用
APA 创建操作步骤总览
下面以真实的 12306 订票系统为例进行APA技能创建。
步骤一：安装网页插件
进入设置-插件安装，安装到对应浏览器即可。在浏览器的扩展程序 chrome://extensions 中可以看到 Cowork 插件，保证其正常开启。
步骤二：配置模型
可选择官方内置的模型服务，或者自行添加模型，支持 OpenAI / Anthropic 标准协议。
如果自行添加，填写正确的 BaseUrl 和 ApiKey 后，点击获取，拉取模型列表，选择添加模型即可。
标准协议的模型提供商，都支持获取模型列表。尽量不要手动添加模型，手动添加可能缺失模型基本信息，导致图片理解、上下文压缩等异常。
步骤三：新建助手
建议开启 「完全访问权限」，系统提示词可选择「教练引导」，岗位能力选择「执行编排」
步骤四：开始录制
选中「APA创建器」技能，并提示进入对应系统录制，星辰Cowork会自动根据提示词启动录制器，进入对应网页
成功进入12306官网，右上角会出现录制器，点击展开查看录制信息。包括：
当前页面录制内容
所有页面录制内容
最近一次操作的状态信息
接下来，正常点击页面中的各种功能，录制器会实时记录点击过程，以及触发的请求等信息。
建议一开始录制，内容不要太多，可以只做一个简单场景，或者首页的部分功能即可。先把基本的技能框架搭建好，后续再不断扩展各类技能。
录制完毕后，输入录制结束即可。星辰Cowork 会自动冻结并分析录制到的内容。（工作空间中可以查看录制快照）
步骤五：生成 APA
接下来，直接生产初版 APA。
这一步会比较耗时，会结合APA创建器技能，分析录制到的大量录制数据，将关键能力转化为 Agent 可以直接使用的技能。
输出中能够看到产物的基本架构，包括技能包 skills 和代码模块 runtime/python工作空间中也能看到相应的 APA 成品
步骤六：进行测试
直接对话即可调用
注：示例中12306车票查询不需要登录认证，所以能够直接查到车次列表。
但部分能力、以及其他企业系统等，可能需要严格的登录认证，所以需要尝试破解登录态，或者通过浏览器插件桥接，借助网页登录态执行（对难以解密的系统，或者想快速体验能力）。具体参考第3部分生产建议
简单的登录态加密，Cowork很容易破解；但复杂的需要多次调试，或者有代码经验的来尝试，效率会更高。
此外，部分比较复杂的业务场景，如电路图（涉及拓扑关联）、超大表单填写（强依赖模型的生成准确性）等，建议和技术人员一起来做，效率会更高。
也可以用代码编辑器（有开发功底）直接查看生产好的技能包，更详细的了解技能开发情况。
或者直接和星辰Cowork 自由对话也可以，查看技能包可以提效，但不是必须。
比如：提问有哪些能力？
步骤七：安装 APA 技能包
技能包在Cowork助手中，被称为插件，直接让 Cowork 安装即可。
录制&生产 全流程截图
星辰Cowork 生产企业技能，强大的能力在于只需要和助手对话，以及在企业系统中做日常操作（流程）或各功能点的触发，就能实时录制相关能力的实现细节，后续经过星辰Cowork 分析后即可生产出技能包。
整个过程完全不需要写或看一行代码，也不用手动搭建任意工作流。
但推荐去看具体的中文 Skill 内容，或者让 Cowork 总结，了解生产情况，加快效率
示例中的流程完全是对话式生成
APA插件管理
安装完插件后，在插件市场-我的插件中可以看到 「12306车票助手」，点击进入可以看到已经做好的所有技能。
所有技能详情页
插件也可分享到团队市场，以供团队成员下载和二次开发。
APA技能插件使用
点击左侧栏上方「+」（1）、或助手库->我的助手（2），新建助手，在岗位能力页面选择已安装的 12306 插件，点击创建助手
可在助手对话页面进行能力询问。
使用车票查询能力
示例中合肥到昆明运行失败，因为录制未能抓到合肥、昆明两地的车站编码，因此录制时，最好能尽可能把相关城市及车站挨个点过去，拿到尽量完整的编码表，星辰Cowork会自动做进Skill包中。
生产建议
企业系统认证适配与登录会话复用
不同企业系统的认证机制复杂度不同。对于使用常规 Cookie、Token 或请求头认证的系统，Cowork 通常可以通过一轮录制识别认证参数，并生成能够独立调用系统接口的能力。
部分系统可能使用动态 Token、单点登录、请求签名、验证码或多因素认证，需要继续与 Cowork 交互并补充录制。对于难度较高的系统，可以由技术人员通过浏览器 Network 控制台观察认证接口、请求头和 Token 更新过程，协助 Cowork 完成认证适配。
推荐优先完成独立的认证接入，使能力能够生成为纯代码运行的技能包，减少对浏览器页面的依赖。在满足运行依赖、网络连通和账号权限等条件时，这类技能包可以部署到不同机器，或接入其他 Agent 使用。
如果暂时无法完成独立认证接入，可以根据 APA 创建器的引导采集已授权的会话参数，或通过浏览器插件桥接，复用用户已经登录的网页会话。
动态参数、请求签名与复杂接口
部分企业系统的接口包含动态参数、时间戳、随机数、设备信息、请求签名或加密数据；还有一些接口必须按照固定顺序调用。仅录制一次时，Cowork 可能难以准确区分固定参数和动态参数。
遇到这种情况，建议将关键能力单独录制，并使用不同业务数据重复操作几次，让 Cowork 对比多轮请求，识别参数变化规律。技术人员也可以通过 Network 控制台检查请求与响应，帮助确认签名、加密和接口依赖关系。
如果接口仍然无法稳定复现，可以先缩小能力范围，分别生成和测试关键接口；对于只能通过页面触发的能力，可以使用浏览器插件桥接作为执行方式。
查看和维护技能包
技能开发过程中，有开发经验的用户可以使用代码编辑器查看技能包中的 skill （感兴趣可看 runtime/python）。
业务人员不需要阅读或修改任何代码，可以直接让 Cowork 总结技能包内容、执行测试、分析问题并补充能力。查看技能包能够帮助了解生产结果和提高调试效率，但不是使用 APA 的必要条件。
复杂业务流程与条件分支
部分业务流程包含多个页面、条件判断、审批节点、异常处理或跨系统操作。如果一次录制的流程过长，可能导致能力边界不清晰，也会增加后续分析和测试的难度。
建议先将完整流程拆分为查询、创建、修改、提交、审批、下载等较小的原子能力，分别录制并验证。各项能力稳定后，再由 Agent 根据业务任务进行组合。
第一次录制可以优先覆盖最常见的正常流程，后续再通过补充录制增加条件分支、异常处理和特殊业务规则，不需要一次完成全部场景。
特殊页面组件与图形化交互
Canvas、电路图、图形拓扑、拖拽组件、虚拟列表、富文本编辑器等页面元素，通常没有稳定的标准控件结构，录制和定位难度会高于普通表单。遇到此类页面时，应优先尽可能让 Cowork 判断是否存在可直接调用的接口。如果能够识别底层接口，可以将其生成为更稳定的纯代码能力。
如果必须依赖页面操作，可以适当放慢操作速度，围绕关键动作进行补充录制，并通过浏览器插件桥接执行。涉及拓扑关系、坐标计算或特殊数据结构时，与技术人员协作会更加高效。
超大表单与批量数据处理
超大表单通常包含大量字段、条件联动、格式要求和校验规则。完全依赖模型一次生成全部字段，对模型有较高要求，可能出现漏填、格式错误或字段对应不准确等问题。必要时与技术人员协作开发更加高效。
批量任务应先使用小规模数据进行测试，确认字段映射和执行结果正确后再扩大范围。对于提交、删除、付款等高风险操作，建议增加预览和人工确认。
跨系统数据映射
在连接 CRM、ERP、OA 等多个系统时，同一个客户、订单、部门或产品可能使用不同的字段名称、编码和数据格式，直接传递数据容易出现对应错误。此时需要尽可能通过多次录制、并深度分析录制数据，将转换规则沉淀到技能说明中。
完成单个系统能力验证后，再由 Agent 自由组合多个技能，实现跨系统流程执行和数据流转。
技能测试与持续完善
初版 APA 生成完成，并不代表已经覆盖所有业务情况。部分能力可能处于待验证或部分可用状态，需要通过测试继续完善。
可以直接询问 Cowork：
当前生成了哪些能力？
哪些能力还需要补充录制？
请测试这个技能并分析失败原因。
请根据新的录制内容修复并更新技能。
权限与敏感数据
录制内容可能包含账号信息、Cookie、Token、客户资料和其他业务敏感数据。建议在已授权的环境中使用测试账号进行录制，并遵循最小权限原则。
发布技能包前，应检查其中是否包含固定账号、认证信息或真实业务数据。认证凭证应由运行环境安全注入，不应直接写入技能包。涉及写入、删除、付款、审批等操作时，应增加权限校验、执行记录和人工确认。