Microsoft.Agents.AI.LocalCodeAct 會在代理程式環境中的子程序內執行產生的 Python 程式碼。 它提供了 CodeAct 提供者模式,而不需要 Hyperlight 客體執行階段。
此整合採用 CodeAct 模式,並依賴主機環境進行隔離。
Warning
Local CodeAct 不是安全沙盒。 僅在外部容器、虛擬機或受管理主機環境提供程序、檔案系統、網路及憑證隔離的地方執行。
FIDES 目前僅支援 Python,且無法在這個 .NET 提供者中使用。 其主機橋接器直接呼叫已註冊的 AIFunction 工具,不經代理程式的每函式中介軟體管線。
直接代理工具或外部 execute_code 呼叫的檢查不涵蓋巢狀呼叫、程式碼內部中間值,或檔案與網路功能。 主機工具必須自行強制執行本身的授權與目的地控制。 需要個別中介軟體檢查時,請使用直接代理工具;不要依賴 Local 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 執行階段
| Runtime | 在以下時機加以選擇 |
|---|---|
| 超光速 | 你需要一個獨立的沙盒,並有檔案系統和網路控制。 |
| 本機 CodeAct | 你的 .NET 代理程式已經運行在外部沙盒環境中。 |
| 蒙提 | 你需要一個跨平台的限制直譯器來處理 Python 代理。 |