Files
AgentLab/backend/app/blueprints/templates/__init__.py
T
ThearchyHelios 277982ead3 普通用户建应用(后端):
- 蓝图:bp_* 操作和逐卡白名单、蓝图检查、留痕、按蓝图判权限;五个场景模板加自由形(骨架、关节、应用骨架、定时任务),实例化与骨架比对;BlueprintApplier / TemplateApplier(只收模板声明过的关节)与自查;look 新类别口径卡;蓝图对话和填关节两个流式接口,不同组的关节并行填、出错的组串行重试;模板列表
- 试运行与发布单:四种起点(对话、模板、问数据的一轮、已发布版本);试运行是探索运行,草稿应用按这次运行解析、印章写试运行,流程类派给自己、不触发升级;发布单九步、预检只读、每步留痕、停下后接着做、核对卡片指纹和应用管理权、启动时整理中断的单;白话层覆盖全部问题编号
- 记录表与文件:平台托管只追加的记录表、按高水位固定数据、连接上的临时视图做行级可见、写入走动作(records_append)、表版本在发布时切换、草稿不影响线上、记录列表遮敏感列;文件按哈希存、两步上传、提交时绑定运行、下载按读权限、清理、file_text、按配方导入一期(table_import_period)
- 个人应用:存成个人应用(问数据的约束)、刷新(遮罩、只读、每日上限)、只有拥有者看得见、提交审核与共享副本、开关下发到认人接口;页面编辑的候选;隐藏组件不下发;三条新检查
2026-10-15 12:09:29 +08:00

85 lines
3.7 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""场景模板 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