代理和主题 ID 规范

本文档描述了代理 ID 和主题 ID 的结构、约束和行为。

代理 ID

必需属性

type（类型）

• 类型：string

• 描述：代理类型不是代理类。它将代理与特定的工厂函数关联，该函数生产相同代理类型的代理实例。例如，不同的工厂函数可以生产相同的代理类，但具有不同的构造函数参数。

• 约束：UTF8，只能包含字母数字字符（a-z）和（0-9），或下划线（_）。有效标识符不能以数字开头，也不能包含任何空格。

• 示例：

  • code_reviewer

  • WebSurfer

  • UserProxy

key（键）

• 类型：string

• 描述：代理键是给定代理类型的实例标识符

• 约束：UTF8，只能包含 ASCII 32（空格）到 126（~）之间（包含）的字符。

• 示例：

  • default

  • 内存地址

  • UUID 字符串

主题 ID

必需属性

type（类型）

• 类型：string

• 描述：主题类型通常由应用程序代码定义，用于标记主题所针对的消息类型。

• 约束：UTF8，只能包含字母数字字符（a-z）和（0-9），或下划线（_）。有效标识符不能以数字开头，也不能包含任何空格。

• 示例：

  • GitHub_Issues

source（来源）

• 类型：string

• 描述：主题来源是主题类型内的主题唯一标识符。它通常由应用程序数据定义。

• 约束：UTF8，只能包含 ASCII 32（空格）到 126（~）之间（包含）的字符。

• 示例：

  • github.com/{repo_name}/issues/{issue_number}