文档

运行与运维 Ankole

部署 Ankole，了解运行时结构，并运维企业自行管理的实例。

从「介绍」开始

01快速上手

02使用指南

03开发者指南

架构说明控制面、Agent Computer Worker、Actor Runtime、Brain 和后台 Agent 任务如何构成 Ankole Agent Harness。
AIGateway APIOpenResponses 兼容的 AI 边界——HTTP、SSE、WebSocket 端点，无状态与有状态调用，以及 provider 路由。
SignalsGateway共享工作入口层——聊天、webhook 和 provider 事件如何变成 actor 事件，而又不把来源事实错写成执行状态。
Actor Runtime一个长时 session 如何存活、唤醒、失败与恢复——actor key、OTP 故障域、activation 隔离栏，以及 RuntimeFabric 的实时路径。
Background Agent Jobs跨越 worker 故障的持久、可恢复工作——job 状态机、等待输入、唤醒 owner，以及与 Actor Runtime 的边界。
主体与 AuthZAnkole 实例的权限边界，包括主体、授权规则、权限组成员关系和运行时权限检查。
Agent Library一个 agent 能做什么——skill 作为文件系统 bundle，Agent Plugin 作为 Codex 包，以及按 agent 解析的“默认再覆盖”启用模型。
Agent Computer WorkerBun + TypeScript 执行节点如何运行模型循环、工具、文件、终端状态与流式输出，以及控制面如何隔离每个回合。
Rust Kernel共享的原生层——对授权、RuntimeFabric 传输和 AI 数据面原语的一份 Rust 实现，同时被 Elixir 控制面和 Bun worker 加载。
Control Plane Plugins第一方 Elixir 扩展模型——已发现与已激活的 plugin、子系统契约、AppConfigure 键、受监督子进程，以及下一次启动才生效的启用边界。
开发 Skill 与 Control Plane Plugin为 Agent 增加工作方法，或为控制面增加身份源、聊天适配器、配置项和后台服务。
Worker CLI 能力把 Agent 能力做成 shell 命令，由 --help 承载契约，并把一句话指针放在 Agent 做相关决策的位置。
添加 provider如何声明一个 AIGateway provider——DSL、编译后的定义、设置、能力、prepare 函数、基于 plugin 的注册。
上下文压缩与 compactionAnkole 如何让长会话保持在模型上下文内——AIGateway 自动历史 compaction 与逐字用户原文保留。
Agent 循环控制面回合生命周期与 worker 侧 agent 循环之间的边界——各自拥有什么、如何通信、迭代预算与重试住在哪里。
Prompt 组装agent 每个回合看到的系统 prompt 如何构建——控制面数据提供者、两条传给 worker 的通道、worker 侧组装出最终 prompt 的过程。
Provider 运行时AIGateway 如何把选择符解析到 provider、构建准备好的请求、经 kernel 分发——从模型调用到 provider 响应的三阶段。
工具运行时Worker 如何为每个回合定义和分发工具，包括主回合的 Workflow 工具与受限的 Workflow 任务工具集。
轨迹与消息格式Ankole 如何存储和投影会话消息与后台任务轨迹——两种存储形态、ChatML 规范形式、剥离协议细节的模型可见投影。
代码执行Ankole Agent 如何在普通对话和持久的后台 Agent 任务中运行代码。
使用 MCP-backed Skill已启用的 Skill 如何通过 mcporter 把 Agent 或 Automation 脚本路由到 MCP server。
任务清单与澄清Ankole agent 如何为复杂任务做计划、如何在任务中途解决真正的歧义——todo 工具（按会话、同时最多一项进行中）和 clarify 工具（一个问题，持久记录，结束本回合）。agent 各拿它们做什么，运维不该期待它们做什么。
审计轨迹如何阅读 Ankole 的审计面——AuthZ 授权记录、控制面结构化日志、各自记录了谁在何时改了什么。
AIGateway API 使用外部调用方如何使用 AIGateway REST API——OpenResponses 兼容端点、agent vs admin token、无状态与有状态调用、完整示例。

04参考

05操作指南