mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-22 00:32:03 +00:00
964eeaa829
在画布上拖拽编排 agent 工作流,并实时看着它执行。 后端 FastAPI + LangGraph:把画布 JSON 编译成 StateGraph,15 种节点 (模型/Agent/多Agent、工具/沙箱、分支/循环/子图、记忆/检索/整形、 人工介入/结构校验)。选 LangGraph 是因为可视化编排真正难的是暂停、 恢复和回放,而 checkpointer + interrupt() 正好把这几件事做在了底层。 前端 React + React Flow:节点元数据驱动属性面板与连接桩,运行时 节点高亮、边流动画、卡片内流式 token 全部由同一份事件流驱动。 关键实现: - Agent 内工具审批用 @task 缓存模型调用,interrupt 重放时不重复计费 - 沙箱保持只读根文件系统,代码经 exec+base64 写入(put_archive 会被 只读容器拒绝),断网、非 root、内存/CPU/超时限额 - 检索为向量与 BM25 混合,本地哈希 embedding 零配置可用 - 分支条件走 AST 白名单求值器;HTTP 工具逐 IP 拦截内网与元数据地址 - Mock provider 让无 API Key 也能跑通完整链路 7 个内置模板全部冒烟通过,含真实模型端到端验证。
66 lines
1.7 KiB
Python
66 lines
1.7 KiB
Python
from __future__ import annotations
|
|
|
|
import time
|
|
import uuid
|
|
from enum import StrEnum
|
|
from typing import Any
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
|
|
class EventType(StrEnum):
|
|
"""前端与后端之间的实时协议。画布高亮、时间线、token 流全部基于这套事件。"""
|
|
|
|
# run 级
|
|
RUN_STARTED = "run.started"
|
|
RUN_FINISHED = "run.finished"
|
|
RUN_FAILED = "run.failed"
|
|
RUN_CANCELLED = "run.cancelled"
|
|
RUN_INTERRUPTED = "run.interrupted" # 等待人工介入
|
|
RUN_RESUMED = "run.resumed"
|
|
|
|
# 节点级
|
|
NODE_STARTED = "node.started"
|
|
NODE_FINISHED = "node.finished"
|
|
NODE_FAILED = "node.failed"
|
|
NODE_SKIPPED = "node.skipped"
|
|
EDGE_TAKEN = "edge.taken" # 条件分支实际走了哪条边
|
|
|
|
# 模型级
|
|
LLM_START = "llm.start"
|
|
LLM_TOKEN = "llm.token"
|
|
LLM_THINKING = "llm.thinking"
|
|
LLM_END = "llm.end"
|
|
|
|
# 工具 / 沙箱
|
|
TOOL_START = "tool.start"
|
|
TOOL_END = "tool.end"
|
|
TOOL_ERROR = "tool.error"
|
|
SANDBOX_START = "sandbox.start"
|
|
SANDBOX_END = "sandbox.end"
|
|
|
|
# 多 agent 协作中的单个 agent 步骤
|
|
AGENT_STEP_START = "agent.step.start"
|
|
AGENT_STEP_END = "agent.step.end"
|
|
|
|
# 人工介入
|
|
HUMAN_REQUESTED = "human.requested"
|
|
HUMAN_RESOLVED = "human.resolved"
|
|
|
|
# 其他
|
|
LOG = "log"
|
|
USAGE = "usage" # token / 成本累计
|
|
|
|
|
|
class RunEventModel(BaseModel):
|
|
id: str = Field(default_factory=lambda: uuid.uuid4().hex)
|
|
run_id: str
|
|
seq: int = 0
|
|
type: EventType
|
|
node_id: str | None = None
|
|
ts: float = Field(default_factory=time.time)
|
|
data: dict[str, Any] = Field(default_factory=dict)
|
|
|
|
def to_wire(self) -> dict[str, Any]:
|
|
return self.model_dump(mode="json")
|