Files
AgentLab/backend/app/tools/builtin/files.py
T
ThearchyHelios 964eeaa829 AgentLab:可视化 Agent 编排实验台
在画布上拖拽编排 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 个内置模板全部冒烟通过,含真实模型端到端验证。
2026-09-13 17:27:00 +08:00

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}