a13nDocs

软件包目录

发行包名、导入路径、源码位置、可运行示例和发布组。

查找适合你的集成所需的库、应用或示例。Python 发行包名使用连字符(a13n-harness),导入路径使用下划线(a13n_harness)。

Python 软件包

发行包源码用途与指南
a13n-harnesspackages/a13n-harnessAgent 组合与执行、工具、状态和 provider
a13n-stream-protocolpackages/a13n-stream-protocol将 Harness 观测转换为 AG-UI 事件
a13n-harness-uipackages/a13n-harness-ui终端和浏览器工作台,也可作为可嵌入的 App使用
a13n-envd-clientpackages/a13n-envd-client用于 Envd 会话、文件、进程和输出的 Python EIP 客户端
a13n-servicepackages/a13n-service提供身份管理、资源和持久执行的托管 agent 运行时
a13n-loggingpackages/a13n-logging为库和应用提供结构化日志

Environments 是 Harness 的一部分,也可以在不使用 agent 的情况下单独使用。

原生守护进程

crates/a13n-envd 构建 Envd 守护进程。它通过 EIP 提供 Envd 会话、文件、命令、进程和保留输出。请参阅安装、配置和 Python 客户端。

Harness 的 Local Envd provider 将守护进程连接到环境。选择此 provider 时,Harness UI 可以自动获取匹配的可执行文件。

Service SDK 与 CLI

Service 客户端分别位于独立的 Python、TypeScript、Go 和 Rust 仓库。Rust 仓库还提供 a13n-service-cli。这些客户端调用 Service HTTP API;要直接嵌入 agent 执行,请使用 Harness。

SDK 与 CLI链接到各客户端的安装说明和示例。HTTP 参考描述本仓库的 Service API。

前端源码

源码用途
frontend/apps/a13n-consoleService 的浏览器界面,用于资源和对话管理
frontend/apps/a13n-harness-uiHarness UI 的 WebUI
frontend/packages/a13n-ui共享 React 组件、设计 token 和品牌素材

Console 随 Service 发布,WebUI 随 a13n-harness-ui 发行包发布。两者都打包在各自的 wheel 和 sdist 中,安装使用时无需 Node.js。前端开发请遵循前端 README。

可运行的示例项目

每个项目都有自己的依赖、测试和运行说明。请从各自的 README 开始:

示例演示内容
Agent 应用离线流式轮次、状态保存和重启恢复
环境 provider直接使用 Local、Local Envd 和 Docker 的生命周期
能力与插件自定义能力、Harness 插件、环境 provider 和运行扩展
已安装的 provider 插件打包环境 provider 并加载已安装的入口
MCP App带交互式浏览器计数器的 stdio MCP 服务器

示例索引列出了运行命令和前置条件。环境示例介绍了其他内置 provider。

发布

发布组版本关系
Harness 和 Stream Protocol使用相同版本;Stream Protocol 依赖该精确版本的 Harness
Envd 及其 Python 客户端使用相同版本
Harness UI、Service、Logging独立发布;软件包元数据声明兼容的依赖版本

前端随其所属应用发布。示例项目不属于生产发布。源码树中的软件包版本是开发占位值;选择部署版本时请以已发布软件包的元数据为准。

贡献者环境配置请参阅贡献指南。仓库和发布约定请参阅仓库模型。

本页目录