mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-17 21:11:58 +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 个内置模板全部冒烟通过,含真实模型端到端验证。
108 lines
3.3 KiB
Python
108 lines
3.3 KiB
Python
from __future__ import annotations
|
|
|
|
from pathlib import Path
|
|
from typing import Any
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
from app.core.config import settings
|
|
from app.tools.registry import ToolContext, register
|
|
|
|
_MAX_READ = 200_000
|
|
|
|
|
|
def _resolve(rel: str, ctx: ToolContext) -> Path:
|
|
"""把相对路径锁死在这次运行自己的工作目录里。
|
|
|
|
先 resolve 再比较,所以 `../../etc/passwd` 和软链接都逃不出去。
|
|
"""
|
|
root = (settings.workspace_dir / (ctx.sandbox_session or "default")).resolve()
|
|
root.mkdir(parents=True, exist_ok=True)
|
|
target = (root / rel.lstrip("/")).resolve()
|
|
if target != root and root not in target.parents:
|
|
raise ValueError(f"路径越界:{rel}")
|
|
return target
|
|
|
|
|
|
class FileReadArgs(BaseModel):
|
|
path: str = Field(description="相对工作目录的文件路径")
|
|
|
|
|
|
@register(
|
|
name="file_read",
|
|
category="文件",
|
|
description="读取工作目录下的文件内容。",
|
|
args_schema=FileReadArgs,
|
|
)
|
|
async def file_read(ctx: ToolContext, **kwargs: Any) -> dict[str, Any]:
|
|
args = FileReadArgs(**kwargs)
|
|
try:
|
|
target = _resolve(args.path, ctx)
|
|
except ValueError as e:
|
|
return {"error": str(e)}
|
|
if not target.exists():
|
|
return {"error": f"文件不存在:{args.path}"}
|
|
if target.is_dir():
|
|
return {"error": f"{args.path} 是目录,用 file_list"}
|
|
data = target.read_bytes()[:_MAX_READ]
|
|
return {
|
|
"path": args.path,
|
|
"size": target.stat().st_size,
|
|
"content": data.decode("utf-8", errors="replace"),
|
|
"truncated": target.stat().st_size > _MAX_READ,
|
|
}
|
|
|
|
|
|
class FileWriteArgs(BaseModel):
|
|
path: str = Field(description="相对工作目录的文件路径")
|
|
content: str = Field(description="要写入的内容")
|
|
append: bool = Field(default=False, description="追加而不是覆盖")
|
|
|
|
|
|
@register(
|
|
name="file_write",
|
|
category="文件",
|
|
description="写入文件到工作目录。父目录会自动创建。",
|
|
args_schema=FileWriteArgs,
|
|
dangerous=True,
|
|
)
|
|
async def file_write(ctx: ToolContext, **kwargs: Any) -> dict[str, Any]:
|
|
args = FileWriteArgs(**kwargs)
|
|
try:
|
|
target = _resolve(args.path, ctx)
|
|
except ValueError as e:
|
|
return {"error": str(e)}
|
|
target.parent.mkdir(parents=True, exist_ok=True)
|
|
with target.open("a" if args.append else "w", encoding="utf-8") as f:
|
|
f.write(args.content)
|
|
return {"path": args.path, "bytes": target.stat().st_size, "ok": True}
|
|
|
|
|
|
class FileListArgs(BaseModel):
|
|
path: str = Field(default=".", description="要列出的目录")
|
|
|
|
|
|
@register(
|
|
name="file_list",
|
|
category="文件",
|
|
description="列出工作目录下的文件。",
|
|
args_schema=FileListArgs,
|
|
)
|
|
async def file_list(ctx: ToolContext, **kwargs: Any) -> dict[str, Any]:
|
|
args = FileListArgs(**kwargs)
|
|
try:
|
|
target = _resolve(args.path, ctx)
|
|
except ValueError as e:
|
|
return {"error": str(e)}
|
|
if not target.exists():
|
|
return {"path": args.path, "entries": []}
|
|
entries = [
|
|
{
|
|
"name": p.name,
|
|
"type": "dir" if p.is_dir() else "file",
|
|
"size": p.stat().st_size if p.is_file() else None,
|
|
}
|
|
for p in sorted(target.iterdir())[:500]
|
|
]
|
|
return {"path": args.path, "entries": entries}
|