mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-22 06:31: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 个内置模板全部冒烟通过,含真实模型端到端验证。
102 lines
3.2 KiB
Python
102 lines
3.2 KiB
Python
from __future__ import annotations
|
||
|
||
import asyncio
|
||
from typing import Any
|
||
|
||
from app.core.config import settings
|
||
from app.sandbox.base import ExecResult, Sandbox, SandboxLimits
|
||
from app.sandbox.docker_sandbox import DockerSandbox
|
||
from app.sandbox.local_sandbox import LocalSandbox
|
||
|
||
|
||
class DisabledSandbox(Sandbox):
|
||
name = "off"
|
||
|
||
async def run(self, code: str, **kwargs: Any) -> ExecResult: # type: ignore[override]
|
||
return ExecResult(
|
||
ok=False,
|
||
backend=self.name,
|
||
error="沙箱已在设置中关闭(AGENTLAB_SANDBOX_BACKEND=off)",
|
||
)
|
||
|
||
async def health(self) -> dict[str, Any]:
|
||
return {"backend": self.name, "available": False, "reason": "已关闭"}
|
||
|
||
|
||
class SandboxManager:
|
||
"""按配置挑一个可用后端。auto = 有 Docker 用 Docker,没有就降级到本地子进程。"""
|
||
|
||
def __init__(self) -> None:
|
||
self._backend: Sandbox | None = None
|
||
self._lock = asyncio.Lock()
|
||
self._resolved_from: str = ""
|
||
|
||
async def get(self) -> Sandbox:
|
||
if self._backend is not None:
|
||
return self._backend
|
||
async with self._lock:
|
||
if self._backend is not None:
|
||
return self._backend
|
||
self._backend = await self._resolve()
|
||
return self._backend
|
||
|
||
async def _resolve(self) -> Sandbox:
|
||
choice = (settings.sandbox_backend or "auto").lower()
|
||
if choice == "off":
|
||
self._resolved_from = "配置关闭"
|
||
return DisabledSandbox()
|
||
if choice == "local":
|
||
self._resolved_from = "配置指定"
|
||
return LocalSandbox()
|
||
if choice == "docker":
|
||
self._resolved_from = "配置指定"
|
||
return DockerSandbox()
|
||
|
||
docker = DockerSandbox()
|
||
health = await docker.health()
|
||
if health.get("available"):
|
||
self._resolved_from = "自动探测到 Docker"
|
||
await docker.reap_orphans()
|
||
return docker
|
||
self._resolved_from = f"Docker 不可用({health.get('error', '未知原因')}),降级到本地"
|
||
return LocalSandbox()
|
||
|
||
async def run(
|
||
self,
|
||
code: str,
|
||
*,
|
||
language: str = "python",
|
||
limits: SandboxLimits | None = None,
|
||
session_id: str | None = None,
|
||
env: dict[str, str] | None = None,
|
||
files: dict[str, str] | None = None,
|
||
) -> ExecResult:
|
||
backend = await self.get()
|
||
return await backend.run(
|
||
code,
|
||
language=language,
|
||
limits=limits,
|
||
session_id=session_id,
|
||
env=env,
|
||
files=files,
|
||
)
|
||
|
||
async def health(self) -> dict[str, Any]:
|
||
backend = await self.get()
|
||
info = await backend.health()
|
||
info["selected_because"] = self._resolved_from
|
||
info["configured"] = settings.sandbox_backend
|
||
info["defaults"] = SandboxLimits().model_dump()
|
||
return info
|
||
|
||
async def cleanup(self, session_id: str) -> None:
|
||
backend = await self.get()
|
||
await backend.cleanup(session_id)
|
||
|
||
async def close(self) -> None:
|
||
if self._backend:
|
||
await self._backend.close()
|
||
|
||
|
||
sandbox_manager = SandboxManager()
|