本地 (.NET)

Microsoft.Agents.AI.LocalCodeAct在代理环境中的子进程中运行生成的Python。 它提供 CodeAct 提供程序模式,无需 Hyperlight 来宾运行时。

此集成使用 CodeAct 模式,并依赖于主机环境进行隔离。

Warning

本地 CodeAct 不是安全沙盒。 仅应在外部容器、虚拟机或受管托管环境能够提供进程、文件系统、网络和凭据隔离时运行它。

FIDES 目前仅支持 Python,在此 .NET 提供程序中不可用。 其主机桥直接调用已注册的 AIFunction 工具,而无需智能体的每函数中间件管道。

对直接代理工具或外部 execute_code 调用的检查无法涵盖嵌套调用、代码内部中间值或文件和网络功能。 主机工具必须强制执行自己的授权和目标控制。 当需要单独的中间件检查时,请使用直接智能体工具;不要依赖本地 CodeAct 来获得 FIDES 保证。 请参阅 CodeAct 的当前限制。

安装软件包

dotnet add package Microsoft.Agents.AI.LocalCodeAct --prerelease

包需要显式Python可执行路径。

配置提供程序

通过 LocalCodeActProviderOptions 注册主机工具。 生成的代码只能通过 await call_tool(...) 调用这些工具。 将执行限制应用于绑定的子进程运行时和捕获的输出。

{
    Dictionary<string, IReadOnlyList<IReadOnlyDictionary<string, object>>> data = new()
    {
        ["users"] =
        [
            new Dictionary<string, object> { ["id"] = 1, ["name"] = "Alice", ["role"] = "admin" },
            new Dictionary<string, object> { ["id"] = 2, ["name"] = "Bob", ["role"] = "user" },
            new Dictionary<string, object> { ["id"] = 3, ["name"] = "Charlie", ["role"] = "admin" },
        ],
        ["products"] =
        [
            new Dictionary<string, object> { ["id"] = 101, ["name"] = "Widget", ["price"] = 9.99 },
            new Dictionary<string, object> { ["id"] = 102, ["name"] = "Gadget", ["price"] = 19.99 },
        ],
    };

    return data.TryGetValue(table, out var rows) ? rows : [];
}

// ── LocalCodeAct provider with sandbox-only host tools ───────────────────────

var codeActOptions = new LocalCodeActProviderOptions
{
    Tools =
    [
        AIFunctionFactory.Create(Compute, name: "compute"),
        AIFunctionFactory.Create(FetchData, name: "fetch_data"),
    ],
    ExecutionLimits = new ProcessExecutionLimits { TimeoutSeconds = 5 },
};

var codeAct = new LocalCodeActProvider(pythonExecutable, codeActOptions);

纵深防御控制措施

本地 CodeAct 提供:

  • AST 验证支持配置允许和阻止的导入项及内置项。
  • 直接Python子进程执行,而无需调用 shell。
  • 时间、输出、结果和捕获文件大小限制。
  • 显式主机工具注册。
  • 只读和读写文件装载。
  • 可配置的工作目录和子进程环境。

这些控制可降低风险,但不提供遏制。 请保持启用验证,传递受限的环境字典,仅公开有限的主机工具,并在安全性较高的外部沙盒中运行进程。

选择 CodeAct 运行时

运行时 在以下情况下选择它
Hyperlight 需要一个包含文件系统和网络控件的独立沙盒。
本地 CodeAct .NET代理已在外部沙盒环境中运行。
蒙蒂 你需要一个供 Python 代理使用的跨平台受限解释器。

后续步骤