ai-智能体与工作空间/智能体启动与自然语言执行
本文记录项目中智能体启动与通过自然语言执行功能的已确认信息。当前可用的源代码依据有限，因此以下内容仅陈述已由仓库资料明确支持的事实，不对未读取的实现细节、调用签名、配置项或运行时行为作推断。
Purpose and Scope
本页聚焦于 AI 智能体的启动职责，以及智能体通过自然语言触发功能执行的能力边界。已确认的项目说明指出，whimbox/agent.py 负责大模型 Agent，并支持通过自然语言执行功能。
由于本次可用的源材料仅明确提及 README.md 中的职责说明，尚未取得 whimbox/agent.py 的实现内容，因此本页不虚构以下信息：具体启动入口、构造函数参数、模型客户端配置、工作空间对象、自然语言解析流程、工具注册机制、异常处理、并发模型、持久化方式、API 路由和测试覆盖情况。上述内容需要以实现文件及其调用方为依据后再补充。
Overview
项目将大模型 Agent 的核心职责集中在 whimbox/agent.py。从现有说明可以确认两点：
- 该模块承担大模型 Agent 相关功能；
- Agent 支持使用自然语言执行功能。
因此，本能力的概念边界是“启动一个可使用大模型能力的智能体，并让其接受自然语言形式的执行意图”。但现有材料不足以确认“工作空间”是否由该模块直接创建、维护或仅作为上层概念传入，也不足以确认自然语言最终映射到哪些具体操作。
Architecture
基于已读取资料，能够可靠确认的最小关系是：项目中的 AI 智能体能力由 whimbox/agent.py 承担，并提供自然语言执行能力。更细粒度的组件关系、启动顺序和外部依赖在源材料中未展开。
Source: README.md
该图只表达 README 已明确支持的职责关系；其中没有加入尚未从实现中确认的模型服务、工具、工作空间存储或执行器节点。
已确认的职责
大模型 Agent 模块
whimbox/agent.py 被项目说明标识为大模型 Agent 所在模块。由此可以确认它是本能力的核心实现边界，而不是根据命名推测出的辅助模块。
自然语言执行
项目说明明确表示 Agent 支持通过自然语言执行功能。现有资料没有说明自然语言输入的载体、解析方式、可执行操作集合、返回结果格式或权限校验流程，因此这些细节不能在本页中确定性描述。
启动与执行流程
当前源材料只支持描述一个抽象的两阶段关系：Agent 模块负责大模型 Agent，随后该 Agent 可接受自然语言并执行功能。启动函数、初始化依赖以及执行阶段的具体调用链尚未从源代码中确认。
Source: README.md
图中的“具体入口未确认”和“具体格式未确认”是刻意保留的证据边界，而不是对实现的假设。
工作空间边界
本目录标题包含“工作空间”，但现有源材料仅明确了 whimbox/agent.py 与大模型 Agent、自然语言执行之间的关系，没有足够证据证明工作空间由该模块管理，也没有发现可用于确认工作空间实体、目录布局、上下文隔离或生命周期的实现信息。
因此，以下问题目前均属于待核实项：
- 工作空间是否是 Agent 的启动参数；
- 每个 Agent 是否绑定独立工作空间；
- 自然语言执行是否可以读写工作空间；
- 工作空间状态是否会跨次执行保存；
- 多个 Agent 或多个请求之间是否共享工作空间。
API 与配置
API
whimbox/agent.py 的公开类、函数、方法签名及返回类型未在已读取资料中展开。根据“NEVER GUESS API SIGNATURES”的要求，本页不列出未经源代码验证的签名，也不声称存在特定 HTTP endpoint、CLI 命令或 Python 调用方式。
配置
现有资料没有提供模型名称、服务地址、密钥、超时、工作空间路径或其他配置项及默认值。因此暂无可可靠填写的配置表。配置细节需要读取 whimbox/agent.py、项目配置文件以及 Agent 的注册或调用位置后补充。
失败模式、并发与运行维护
实现文件尚未读取，因而无法确认以下行为：
- 模型服务不可用时是否重试；
- 自然语言无法映射到功能时如何返回；
- 执行功能失败时是否回滚；
- 多个自然语言请求是否串行化；
- 工作空间状态是否存在并发冲突；
- Agent 是否缓存模型客户端或上下文；
- 启动失败是否会阻止整个应用启动。
这些不是已确认的缺陷，而是当前源材料覆盖范围之外的实现问题。补充实现和测试证据后，才能形成可靠的运维说明。
扩展点与测试
现有 README.md 信息没有列出 Agent 的接口、插件机制、工具注册协议或测试用例，因此无法确认推荐的扩展方式，也不能声称某些行为已有测试保障。实现细节不足时，最安全的扩展路径是先以 whimbox/agent.py 中实际暴露的抽象为准，而不是依据模块名称自行建立新接口。
资料限制与后续补充
本页基于已读取的 README.md 中关于 whimbox/agent.py 的说明编写。若要将本页扩展为完整的工程参考，需要至少核对：Agent 实现、启动调用方、工作空间相关类型或服务、模型配置、自然语言执行器以及对应测试。未取得这些源文件前，任何更具体的 API、流程、配置默认值或错误语义都应视为未确认。
Related Links
- README.md
whimbox/agent.py：README 指出的 Agent 实现位置；其具体内容未包含在当前可用源材料中。