用途:当用户希望为智能体框架记录或回放执行时,先选择最小且诚实的受支持集成;只有在没有受支持路径满足所需的记录与回放边界时,才在用户项目内构建适配器。保留框架的公开入口,并如实报告所选或自定义适配器能观测、记录、回放和恢复的内容。
主要能力与原则:从只读检查用户项目与已安装包开始;优先使用 Kitaru 受支持适配器、导入器或 OTLP 导出;对已用 Langfuse、Braintrust、LangSmith、Logfire、Arize Phoenix 插桩的 Python 智能体,先检查提供方的导入器支持适配器,再考虑自定义代码;以用户已安装的 SDK 与框架为准;只使用公开框架钩子,否则提供更粗边界或停止;先在用户项目中实现,不编辑 Kitaru 核心;隔离每次运行的会话 ID、客户端、节点索引、缓冲、回放状态与框架上下文;部分记录的运行只能视为部分或失败证据;回放视为执行而非事务,未获批准时阻止未知或可写副作用。
使用方式:从包含真实智能体入口的项目开始,读仓库说明并检查工作树;识别包管理器、锁文件、运行时、语言、框架与版本、Kitaru 包与版本、公开入口及调用模式;按入口运行时路由:Python 读 Python 适配器参考,TypeScript 读 TypeScript 适配器参考,其他运行时以不支持语言报告停止。所有 Kitaru CLI 命令与 SDK 脚本需设置 KITARU_ACTIVE_SKILL=kitaru-adapter-builder。用 --concurrency 10 启动或重启由用户控制的 worker;仅当启动面通过环境变量暴露 worker 设置时使用 KITARU_WORKER_CONCURRENCY=10。
限制与停止条件:若已有兼容适配器、导入器或 OTLP 路由满足请求,或项目不是 Python/TypeScript,或没有可用公开 Kitaru SDK 契约,或框架在所需边界无公开钩子,或唯一入口为同步而可用契约是异步且无文档化安全钩子,或行为依赖隐藏提供方活动,或回放安全需要已安装 SDK 不暴露的契约,或不完整导入基线无法证明有效回放所需调用,或所需依赖未发布且用户未批准本地路径时,应停止并给出确切原因。不得用手写 REST 调用、临时事件循环桥、私有导入或复制的草稿插件代码替代缺失的 SDK 契约。安装依赖、调用需要凭据的提供方、创建远程 Kitaru 会话、执行可写工具、发布更改等均需相应批准。完成后按能力报告格式说明哪些用假件验证、哪些对真实 Kitaru 会话验证、哪些仍不支持或未验证。