AiHummer
中文▾
登录帐户
v1.6.x▾
{ }Swagger

工具目录

v1.6.x · 已更新 2026-11-15

在一个回合中,代理可以叫 工具AiHummer 搭载了内置的工具运行时:一些工具默认开启,其他工具仅在提供所需配置时激活。工具在相关情况下受 SSRF 防护并运行在沙箱中,风险工具可以设置在人类审批门后。

默认启用

这些工具开箱即用(有些依赖于已配置的模型或知识库)。

工具 它的作用 如何启用
web_fetch 获取 URL 的内容。受 SSRF 保护。 默认开启
http_request 发出外部 HTTP 请求。受 SSRF 保护。 默认开启
web_search 通过内置 SearXNG 搜索网页。 默认开启(随安装程序捆绑);用 --no-search 关闭
browser / computer 通过 Chrome 开发者工具协议驱动真实浏览器。 默认开启(随安装程序捆绑);用 --no-browser 关闭
memory_store 将事实存入长期记忆(爱因斯坦)。采集模式为 auto(默认)时事实立即可搜索;为 review/off 时成为等待批准的候选。结果带有 searchable_now 字段。 默认开启
memory_search 搜索长期记忆(爱因斯坦)。 默认开启
doc_generate 生成 CSV / TSV / XLSX 或 HTML 文档。 默认开启
image_generate / edit_image 生成或编辑图像。 需要已配置的图像执行后端;编辑还需要该后端支持图像编辑。
github_get_file 从 GitHub 仓库获取单个文件。 默认开启
generate_pairing_code 发出设备配对码。 默认开启
search_knowledge 搜索知识库(RAG)并用引用来支持答案。 配置了知识库
deep_research 进行多步骤研究并生成带引用的报告。 默认开启
docs_search 搜索一个 此文档的离线副本 (docs.aihummer.ru 的快照随版本发布, share/docs(俄/英)——代理可以在没有互联网的情况下回答产品问题。 在存在文档快照的情况下(标准安装)
docs_read 阅读通过查找到的完整文档页面 docs_search. 在存在文档快照的情况下(标准安装)
filesystem_read 读取服务器磁盘上的文件,或列出目录内容。 默认仅限该代理自己的工作目录;访问宿主机需要所有者明确选择该代理的隔离模式。托管云和演示环境中不可用。

[!NOTE] AIHUMMER_FS_ROOT 进一步缩小允许的根目录;空值不会授予整个服务器的访问权限。安装配置、该安装的数据库凭据和加密密钥,以及进程环境均不可读取。审批不会扩大允许访问的文件范围。

在配置中启用

这些工具在你指向它们所需的资源之前会保持关闭状态。所有启用的旋钮 (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) 是 设置目录 键:在网络管理界面中设置它们(管理 → 设置,它有搜索)或与 aihummer settings set <KEY> <VALUE>把它们放进去 gateway.env 有 无效 — 对这些键忽略了环境。

工具 它的作用 如何启用
db_query 运行只读 SQL 查询。 AIHUMMER_DB_QUERY_DSN
mail 发送和阅读电子邮件。 SMTP / IMAP 凭证
tts 合成语音(文本转语音)。 AIHUMMER_TTS_URL (TTS 副文件)
code_exec 在沙箱中执行代码。 AIHUMMER_CODE_EXEC

[!DANGER] code_exec 默认关闭。仅在自己控制且信任的环境中启用:它执行模型编写的代码,即使在沙箱中也仍是高权限能力。

集成工具

当匹配连接被配置时,代理还会获得域工具:

工具 它的作用 如何启用
Bitrix24 CRM / 任务 / 日历 工具 读取并处理 Bitrix24 CRM 记录、任务和日历。 Bitrix24 连接已配置
1C(比特.财务 OData) 通过БИТ.ФИНАНС OData接口查询1C会计数据。 已配置 1C OData 连接

审批关卡

任何工具都可以放在后面 人工参与审批关口. 列出工具名称在 AIHUMMER_APPROVAL_TOOLS 设置(网络管理界面:管理 → 设置);在此类工具运行之前,操作员必须批准调用。被拒绝的调用是 不 执行。

aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec

隔离模式

设置 AIHUMMER_AIRGAPPED 设置为 1 阻止模型控制的公共出口。在此模式下,代理无法通过工具访问开放互联网,这适用于主权或孤立部署。

aihummer settings set AIHUMMER_AIRGAPPED 1

[!NOTE] 除了内置目录,AiHummer 还可以从任何 OpenAPI 3.x 合成工具 规范并暴露任何 MCP 服务器的工具,无需集成代码。见 文档的市场和插件部分。

接下来去哪儿

HTML 文档

代理使用 doc_generate 和 format: "html" 创建最多 4 MiB 的 UTF-8 HTML 附件,保留 CSS 和 JavaScript。兼容且已更新的应用在核验来源与完整性后,在隔离预览中打开保存的文件。应用凭据不会传入预览;文件、来源或登录会话发生变化后,预览失效。