【Agent进阶专题】Extension 基本结构

本篇简单记录 Extension 的接口、运行上下文和生命周期。

Extension 接口

1
2
3
4
5
6
export interface Extension {
id: string;
setup(context: ExtensionSetupContext): Awaitable<void>;
start?(context: ExtensionRuntimeContext): Awaitable<void>;
stop?(context: ExtensionRuntimeContext): Awaitable<void>;
}
  • id:Extension 的唯一标识。
  • setup:注册能力和事件监听,必须实现。
  • start:获取其他能力并开始运行,可选。
  • stop:释放资源,可选。

两个 Context

setup 和运行阶段使用不同的 Context:

1
2
3
4
5
6
7
8
9
10
11
export interface ExtensionSetupContext {
add<T>(name: string, value: T): void;
on<T>(event: string, handler: EventHandler<T>): Unsubscribe;
}

export interface ExtensionRuntimeContext {
get<T>(name: string): T;
all<T>(name: string): T[];
on<T>(event: string, handler: EventHandler<T>): Unsubscribe;
emit<T>(event: string, payload: T): Promise<unknown[]>;
}

Setup Context 用来注册能力和监听事件。Runtime Context 用来获取能力、监听事件和发布事实。

生命周期

Kernel 按以下顺序运行 Extension:

1
2
3
4
5
6
7
按安装顺序 setup
↓
按安装顺序 start
↓
运行
↓
按安装顺序倒序 stop

暂定设计为所有 setup 完成后才执行 start,避免 Extension 在能力尚未注册完成时提前使用。启动失败时,Kernel 也会倒序停止已经启动的 Extension。

到这里,P0 的基础设计已经介绍完成。下一篇开始进入 Agent 核心基座的具体实现。