mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-20 05:02:00 +00:00
277982ead3
- 蓝图:bp_* 操作和逐卡白名单、蓝图检查、留痕、按蓝图判权限;五个场景模板加自由形(骨架、关节、应用骨架、定时任务),实例化与骨架比对;BlueprintApplier / TemplateApplier(只收模板声明过的关节)与自查;look 新类别口径卡;蓝图对话和填关节两个流式接口,不同组的关节并行填、出错的组串行重试;模板列表 - 试运行与发布单:四种起点(对话、模板、问数据的一轮、已发布版本);试运行是探索运行,草稿应用按这次运行解析、印章写试运行,流程类派给自己、不触发升级;发布单九步、预检只读、每步留痕、停下后接着做、核对卡片指纹和应用管理权、启动时整理中断的单;白话层覆盖全部问题编号 - 记录表与文件:平台托管只追加的记录表、按高水位固定数据、连接上的临时视图做行级可见、写入走动作(records_append)、表版本在发布时切换、草稿不影响线上、记录列表遮敏感列;文件按哈希存、两步上传、提交时绑定运行、下载按读权限、清理、file_text、按配方导入一期(table_import_period) - 个人应用:存成个人应用(问数据的约束)、刷新(遮罩、只读、每日上限)、只有拥有者看得见、提交审核与共享副本、开关下发到认人接口;页面编辑的候选;隐藏组件不下发;三条新检查
85 lines
3.7 KiB
Python
85 lines
3.7 KiB
Python
"""场景模板 agentlab.template/1(docs/design/normal-user-apps.md §2.3、§3.3、§3.4):骨架锁住,关节可填。
|
||
|
||
一个模板是一份登记(和组件目录同一种做法):骨架(带占位的图)、关节、应用骨架、定时任务、卡片约束、说明。
|
||
关节分两种:确定性关节由蓝图直接填,不经模型;生成关节只有 sql 和 metric_expr 两类,模型在 TemplateApplier 下
|
||
只能用 fill_joint 填模板声明过的关节。实例化后的图和骨架逐节点比对,只许关节位置不同(tpl.skeleton_changed)。
|
||
|
||
开发者扩展时,模板定义、实例化、测试三样都要给;check_registry 在启动时核对。
|
||
"""
|
||
from __future__ import annotations
|
||
|
||
from collections.abc import Callable
|
||
from dataclasses import dataclass, field
|
||
from typing import Any
|
||
|
||
TEMPLATE_FORMAT = "agentlab.template/1"
|
||
#: 首批五个,外加「自由形」(从已有运行或工作流版本导入,没有关节)
|
||
TEMPLATE_IDS = ("periodic_board", "approval", "exception_handling", "records", "reconcile_writeback", "freeform")
|
||
#: 关节类型(§3.4)
|
||
JOINT_KINDS = ("sql", "metric_expr", "fields", "assignee", "policy", "due", "on_timeout", "threshold", "capability",
|
||
"contract")
|
||
#: 交给模型填的关节类型;其余由蓝图确定性地填
|
||
GENERATED_JOINT_KINDS = ("sql", "metric_expr")
|
||
|
||
|
||
@dataclass(frozen=True)
|
||
class Joint:
|
||
"""骨架里允许填的一个位置:node_id 节点的 field(配置里的 JSON 指针,如 /args/sql、/metrics/0/expression)。
|
||
from_card 是确定性关节取自蓝图的哪里(JSON 指针);生成关节为 None。group 相同的生成关节一起填,不同的并行填。"""
|
||
|
||
id: str
|
||
kind: str
|
||
node_id: str
|
||
field: str
|
||
from_card: str | None = None
|
||
group: str | None = None
|
||
label: str = ""
|
||
|
||
|
||
@dataclass
|
||
class TemplateDef:
|
||
id: str
|
||
version: int
|
||
label: str
|
||
description: str
|
||
#: 给助手看的适用条件(一两句话)
|
||
applies_when: str
|
||
#: 这个模板用到哪些卡片(blueprints/spec.CARDS 的子集)和各自的约束说明
|
||
cards: dict[str, str]
|
||
#: 个人应用(使用者)能不能用、能用哪一部分(None = 不能用)
|
||
personal: str | None
|
||
#: skeleton(bp) -> (GraphSpec 的 JSON, [Joint]):按蓝图出骨架和关节(关节里的值还没填)
|
||
skeleton: Callable[[dict[str, Any]], tuple[dict[str, Any], list[Joint]]]
|
||
#: app_skeleton(bp, graph) -> agentlab.app/1:在 derive_app 的结果上按模板排布
|
||
app_skeleton: Callable[[dict[str, Any], dict[str, Any]], dict[str, Any]] | None = None
|
||
#: schedule(bp) -> 定时任务参数 | None
|
||
schedule: Callable[[dict[str, Any]], dict[str, Any] | None] | None = None
|
||
tags: list[str] = field(default_factory=list)
|
||
|
||
|
||
_REGISTRY: dict[str, TemplateDef] = {}
|
||
|
||
|
||
def register(template: TemplateDef) -> TemplateDef:
|
||
if template.id in _REGISTRY:
|
||
raise ValueError(f"模板「{template.id}」重复登记")
|
||
_REGISTRY[template.id] = template
|
||
return template
|
||
|
||
|
||
def get_template(template_id: str) -> TemplateDef | None:
|
||
return _REGISTRY.get(template_id)
|
||
|
||
|
||
def list_templates() -> list[TemplateDef]:
|
||
return [_REGISTRY[t] for t in TEMPLATE_IDS if t in _REGISTRY] + [
|
||
t for k, t in _REGISTRY.items() if k not in TEMPLATE_IDS]
|
||
|
||
|
||
def check_registry() -> list[str]:
|
||
"""启动时核对:首批模板都登记了、关节类型都认得。交回问题清单(空 = 没问题)。"""
|
||
problems = [f"模板「{t}」没有登记" for t in TEMPLATE_IDS if t not in _REGISTRY]
|
||
return problems
|
||
|
||
from app.blueprints.templates import approval, exception_handling, freeform, periodic_board, reconcile_writeback, records # noqa: E402,F401
|