Skip to main content
创建一个新的 Actor。Actor 代表会话中的参与者——通常是终端用户或系统身份,其交互会生成记忆。创建 Actor 后,您可以将其绑定到工作空间,使其能够参与该工作空间项目中的会话。
所需权限: actor:create

请求体

string
required
调用方定义的外部标识符。在您的账户中必须唯一。使用此字段将 Actor 映射到您自己系统中的身份。
string
Actor 类型。可选值:HUMAN(默认,终端用户)或 ASSISTANT(AI Agent — 通常在创建 Agent 时自动生成)。
string
required
人类可读的名称,显示在控制台中并在 API 响应中返回。
string
Actor 角色或用途的自由文本描述。
object
任意键值对,用于调用方定义的元数据。适用于为 Actor 添加层级、地区或部门等属性标签。

响应

object