用途:OpenHands Software Agent SDK 是一个 Python 框架,用于构建能够编写软件的 AI 智能体。其参考技能指向官方文档站,便于按主题索引查阅 SDK 用法。
主要能力:SDK 提供核心类,包括负责推理-行动循环的 Agent、压缩对话历史的 Condenser、编排会话的 Conversation、类型化事件框架 Event、与模型提供商无关的 LLM 接口、动作安全分析与校验的 SecurityAnalyzer、可复用提示系统 Skill、动作-观察工具框架 Tool / ToolDefinition,以及执行环境抽象 Workspace。
使用方式:安装命令为 pip install openhands-sdk openhands-tools。典型流程是配置 LLM(model、api_key、base_url,支持从环境变量读取),创建 Agent 并挂载工具(如 TerminalTool、FileEditorTool、TaskTrackerTool),再创建 Conversation 并指定工作目录,通过 send_message 发送任务后调用 run() 执行。
文档与示例:全部 SDK 文档位于 https://docs.openhands.dev/sdk,可获取 https://docs.openhands.dev/llms.txt 查看完整主题索引。官方仓库 examples/ 目录提供多个示例,涵盖 Hello World、自定义工具、激活 Skill、确认模式、LLM Registry、交互式终端、MCP 集成、暂停、持久化、异步、密钥、指标、上下文压缩、浏览器使用与安全分析器等。
适用场景:适合需要构建编码类智能体、将智能体接入远程或沙箱执行环境、集成 MCP 工具、管理会话记忆与安全确认的开发场景。
限制:资料未说明收费、价格与平台支持范围,相关事实暂未提供;部分能力在文档中标注为实验性(如 Critic),使用时需注意。