智能体运行时适配器接入
输入目标 AI 智能体的 CLI 或 API 运行规范,编写覆盖服务端调度、前端控制与命令行展示的三端适配模块,实现第三方智能体在 Paperclip 平台中的
功能与用途
该功能指导开发者为 Paperclip 编排框架扩展全新的 AI 智能体适配器。适配器作为平台核心调度层与各类外部智能体(如 Claude Code、Codex CLI、自定义子进程或 HTTP 服务)之间的通信桥梁,需在统一的包规范下同时向服务端(负责执行调度与会话持久化)、前端 UI(负责日志解析与配置表单)以及命令行 CLI(负责终端彩色输出)提供实现,并包含运行环境预检能力,保障智能体在跨任务唤醒时保持上下文一致与稳定运行。
适用场景
- 新增第三方智能体运行时桥接:为 Claude Code、Codex CLI 等外部 Agent 编写适配包,实现对 Paperclip 核心调度系统的接入。
- 配置表单与运行日志解析定制:在 UI 端定制智能体的创建配置表单组件,并针对其特定输出格式解析流式运行日志。
- 智能体执行环境自检与状态持久化:实现环境诊断契约进行依赖与凭证排查,并通过会话编解码器确保跨任务上下文不丢失。
适用人群
- Paperclip 核心框架开发者
- 希望在 Paperclip 中集成自研 Agent 的 AI 平台架构师
- 构建本地多智能体协作环境的全栈工程师
使用步骤
- 在 packages/adapters/ 目录下初始化新的适配器包并配置四重导出(.、./server、./ui、./cli)
- 在根目录 index.ts 中导出基础元数据、模型列表以及面向 LLM 路由的配置文档(agentConfigurationDoc)
- 在 server/ 模块下实现 execute 核心调度、testEnvironment 环境检测合约与 sessionCodec 会话序列化逻辑
- 在 ui/ 和 cli/ 模块中分别实现标准输出流解析组件与终端彩色日志输出
- 分别将新模块注册到 server/src/adapters/registry.ts、ui/src/adapters/registry.ts 和 cli/src/adapters/registry.ts 中
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- AI工作流
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- master
- 最近更新
- 2026-09-23
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
>
依赖与权限
- ANTHROPIC_API_KEY
- PAPERCLIP_API_URL
- PAPERCLIP_API_KEY
- PATH
- 读取用户主动提供的内容