🚀 10 分鐘快速入門指南¶

從零開始，在 10 分鐘內構建受治理的 AI 智能體。

前置條件： Python 3.10+ / Node.js 18+ / .NET 8.0+（任選其一或多個）

架構概述¶

治理層在執行前攔截每個智能體操作：

graph LR
    A[AI Agent] -->|Tool Call| B{Governance Layer}
    B -->|Policy Check| C{PolicyEngine}
    C -->|Allowed| D[Execute Tool]
    C -->|Blocked| E[Security Block]
    D --> F[Audit Log]
    E --> F
    F --> G[OTEL / Structured Logs]

1. 安裝¶

安裝治理工具包：

pip install agent-governance-toolkit[full]

或安裝單獨的套件：

pip install agent-os-kernel        # 策略執行 + 框架整合
pip install agentmesh-platform     # 零信任身份 + 信任卡
pip install agent-governance-toolkit    # OWASP ASI 驗證 + 完整性 CLI
pip install agent-sre              # SLO、錯誤預算、混沌測試
pip install agentmesh-runtime       # 執行期監督 + 權限環
pip install agentmesh-marketplace      # 外掛生命週期管理
pip install agentmesh-lightning        # 強化學習訓練治理

TypeScript / Node.js¶

npm install @microsoft/agent-governance-sdk

.NET¶

dotnet add package Microsoft.AgentGovernance

如果您目前不在包含 .csproj 的目錄中，請明確傳入專案路徑：

dotnet add YourApp.csproj package Microsoft.AgentGovernance

在 Visual Studio 的 Package Manager Console 中，請先在 Default project 下拉選單中選取目標專案，再執行：

Install-Package Microsoft.AgentGovernance

2. 驗證安裝¶

執行內建的驗證腳本：

python scripts/check_gov.py

或直接使用治理 CLI：

agent-governance verify
agent-governance verify --badge

3. 您的第一個受治理智能體¶

建立一個名為 governed_agent.py 的檔案：

from agent_control_specification import AgentControl, HostSession

runtime = AgentControl.from_path("policies/manifest.yaml")
session = HostSession(
    runtime,
    agent_id="quickstart-agent",
    session_id="quickstart-session",
)

result = session.pre_tool_call(
    tool_name="delete_file",
    args={"path": "/etc/passwd"},
)
print(result.verdict)
print(result.reason_code)

執行：

python governed_agent.py

4. 包裝現有框架¶

工具包與所有主要智能體框架整合：

pip install agentmesh-langchain      # LangChain 轉接器
pip install llamaindex-agentmesh     # LlamaIndex 轉接器
pip install crewai-agentmesh         # CrewAI 轉接器

支援的框架：LangChain、OpenAI Agents SDK、AutoGen、CrewAI、 Google ADK、Semantic Kernel、LlamaIndex、Anthropic、Mistral、Gemini 等。

5. 檢查 OWASP ASI 2026 覆蓋率¶

驗證您的部署是否涵蓋了 OWASP 智能體安全威脅：

agent-governance verify
agent-governance verify --json
agent-governance verify --badge

後續步驟¶

內容	位置
完整 API 參考（Python）	agent-governance-python/agent-os/README.md
TypeScript 套件文件	agent-governance-typescript/README.md
.NET 套件文件	agent-governance-dotnet/README.md
OWASP 覆蓋圖	../../docs/compliance/owasp-agentic-top10-architecture.md
貢獻指南	CONTRIBUTING.md

基於 @davidequarracino 的初始快速入門貢獻。