Skip to Content

构建代码助手

通过显式工具白名单和 Skills 构建安全的代码助手。

快速开始

from isa_agent_sdk import query, ISAAgentOptions
 
options = ISAAgentOptions(
    model="gpt-4o-mini",
    allowed_tools=["read_file", "write_file", "bash"],
    skills=["code-review", "debug"],
    max_iterations=30,
)
 
async for message in query("检查这个项目中的测试失败并提出修复方案", options=options):
    if message.is_text:
        print(message.content, end="")
    elif message.is_tool_use:
        print(f"\n[执行工具：{message.tool_name}]")

安全边界

  • 使用 allowed_tools 限制可调用的工具。
  • 生产环境为工作目录设置 cwd，避免 Agent 访问无关文件。
  • 对写入、删除和命令执行启用人在回路审批。
  • 使用生产可靠性中的超时、重试和熔断策略。

当前 SDK 同时提供函数式入口 query / ask、交互式 ISAAgentClient，以及面向对象的 Agent(...).run() / Agent(...).stream() 封装。

Home