Aster文档
搜索 Aster 文档
ESC
产品
版本

输入关键词开始搜索。

    文档目录

    ASTER ACL / 01

    Aster ACL 产品概览

    Agent Configuration Language 的语法、结构校验、规范摘要与宿主接纳边界。

    aster-acl 提供 Agent Configuration Language 的解析器、生成器和结构校验。当前源码版本为 0.3.0。Aster 用 ACL 描述模型、工具和宿主配置;具体字段与生效规则由消费该配置的组件声明。

    ACL 不是权限控制表的缩写。解析一份 ACL 文本,只表示语法和数据结构可读取,不表示其中的操作已获得授权。

    架构图ACL 从文本到宿主接纳有界解析产生 AST,Schema 检查结构,宿主核对语义与权限。规范字节与摘要用于标识内容,不替代接纳检查。
    ACL 的解析、校验与宿主边界文本先经过资源限制与语法解析,再由 Schema 检查结构。宿主负责取值、权限与激活。规范摘要只描述内容身份。内容身份,不代表授权ACL 文本资源限制与语法解析Document / Block / ValueSchema 结构校验宿主语义、取值与权限检查接纳并激活规范字节与 SHA-256 摘要

    文档、块与值

    providers "example" {
      api_key = env("EXAMPLE_API_KEY")
      models = ["example-model"]
    }
    

    providers 是块名,"example" 是标签,api_key 与 models 是属性。块可以嵌套,属性值可以是字符串、数字、布尔、列表、对象、null 或函数调用。

    解析结果使用 Document、Block 和 Value。env("EXAMPLE_API_KEY") 保留为 Value::Call,解析器不会因此读取环境变量。是否允许该调用、从哪里取值、是否可以激活配置,都由宿主决定。见 函数调用的 AST 表示 L42 ↗。

    能力与边界

    ACL 与宿主的分工
    环节ACL 负责宿主负责
    解析语法、值类型、源码位置和资源限制选择可信配置来源与读取上限
    结构校验已声明字段、值类型、标签数量和嵌套结构数值范围、路径、模型与工具是否可用
    生成与摘要ACL 文本、规范 UTF-8 和确定性摘要保存、签名、版本管理和发布策略
    激活提供已解析或已校验的数据凭据解析、工作区信任、权限与沙箱约束

    Schema 默认拒绝未知属性和块。需要额外字段时,应由拥有该结构的组件明确声明,而不是在各层重复猜测字段含义。Schema 的公开入口见 Schema 定义 L95 ↗。

    选择入口

    实现依据