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 代理使用的跨平台受限解释器。 |