Tools
Tools are how an agent acts on the world — fetching a page, searching, sending mail, querying a database, generating a document. AiHummer ships a rich built-in catalog and a Tool Runtime that enables tools when they are configured, reloads them without a restart, gates the risky ones behind human approval, and can lock egress entirely in air-gapped mode.
This page covers how the runtime behaves and lists the built-ins. For the full reference, see the tools catalog.
How the Tool Runtime behaves
- Enable-on-config. A tool becomes available only when its prerequisite configuration is present — usually an environment variable pointing at the service it needs. No config, no tool.
- Hot reload. Tool enablement applies hot, without restarting the gateway, so you can turn capabilities on and off at runtime.
- Approval gate. Risky tools can be placed behind a human-in-the-loop
approval gate via
AIHUMMER_APPROVAL_TOOLS. A rejected call is not executed. - Air-gapped mode. Setting
AIHUMMER_AIRGAPPED=1blocks model-controlled public egress, for sovereign or isolated deployments.
[!WARNING]
code_execis off by default on shared hosts. Enable it only where the sandbox and host are acceptable for running model-authored code, and consider putting it behind the approval gate.
Built-in tools
| Tool | What it does | Enable with |
|---|---|---|
web_fetch |
Fetch a URL (SSRF-guarded) | on by default |
http_request |
Make an HTTP request (SSRF-guarded) | on by default |
web_search |
Web search via the built-in SearXNG | on by default; turn it off with the installer flag --no-search |
browser |
Drive a real browser over CDP | on by default; turn it off with the installer flag --no-browser |
computer |
Computer-use over CDP | on by default; turn it off with the installer flag --no-browser |
memory_store |
Store a fact in long-term memory; with capture mode auto (the default) it is searchable immediately, with review/off it becomes a candidate awaiting approval |
on by default |
memory_search |
Search long-term memory | on by default |
filesystem_read |
Read a file or list a directory on the server’s disk | on by default; AIHUMMER_FS_ROOT narrows the sandbox, empty = the whole server |
db_query |
Read-only database query | AIHUMMER_DB_QUERY_DSN |
mail |
Send/receive mail (SMTP/IMAP) | mail credentials (vault) |
code_exec |
Run code in a sandbox (off by default on shared hosts) | AIHUMMER_CODE_EXEC |
doc_generate |
Generate CSV / TSV / XLSX or an HTML document. | on by default |
tts |
Text-to-speech | TTS sidecar |
image_generate / edit_image |
Generate and edit images | configured image backend |
github_get_file |
Fetch a file from GitHub | on by default |
generate_pairing_code |
Issue a device pairing code | on by default |
search_knowledge / deep_research |
Knowledge retrieval and multi-step research | knowledge base |
| Bitrix24 CRM / task / calendar | Bitrix24 CRM, task and calendar actions | Bitrix24 plugin |
| 1C (БИТ.ФИНАНС OData) | 1C БИТ.ФИНАНС access over OData | 1C OData config |
[!NOTE]
web_fetchandhttp_requestare SSRF-guarded — they refuse requests to internal addresses and other unsafe targets, so a model cannot use them to reach your private network.
Persistent browser profile
By default computer opens a clean browser for every request. Since version
1.3 the tool can retain an explicitly assigned personal profile (cookies and
site sessions) across requests — for example so that an employee works in their
own accounts without signing in every time. A profile is never chosen by a name
or path from model arguments — only by an explicit operator binding:
AIHUMMER_BROWSER_PROFILE_SOCKET— the absolute path to the privatemanaged-profiles.socksocket of the installed browser service; empty (default) — persistent profiles are off.AIHUMMER_BROWSER_PROFILE_BINDINGS— a JSON array of bindings:profile_id,tenant_id,user_id,agent_idsandconversation_ids(up to 64 profiles, one owner each).
A profile opens only when the current user is its owner and the agent and
conversation are listed in the binding; the conversation must be private, with
no other human members. Ownership and authority are checked on every action,
not just on the first open. While persistent profiles are enabled, computer
actions run only with a matching binding. An explicit browser network policy
is required — a set AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK (true or
false) or an AIHUMMER_BROWSER_ALLOWED_HOSTNAMES list; cookies of an
external browser are not imported. Both settings count as dangerous: on the
managed cloud and the demo instance they are locked.
Shared skills
A skill is a reusable instruction (a prompt fragment) that can be attached to agents. The library lives on the admin UI’s “Shared skills” page: to create one, a name and the text are enough — the identifier (slug) is derived automatically. Skills shipped by the vendor out of the box carry an “Out of the box” badge; they can be disabled but stay listed. Attached skills are rendered into the stable prefix of the agent’s system prompt.
Enabling tools
Most tools turn on when you provide their configuration. Common switches:
AIHUMMER_FS_ROOT=/srv/agent-files # NARROWS the filesystem_read sandbox (empty = the whole server)
AIHUMMER_DB_QUERY_DSN=postgres://... # db_query (read-only)
AIHUMMER_CODE_EXEC=1 # code_exec (sandboxed)
AIHUMMER_APPROVAL_TOOLS=mail,code_exec # require approval for these tools
AIHUMMER_AIRGAPPED=1 # block model-controlled public egress
[!TIP] Use
AIHUMMER_APPROVAL_TOOLSto require approval for anything with a side effect — sending mail, running code — while leaving read-only tools ungated.
Where to next
- See the full per-tool reference in the tools catalog.
- Understand the loop that calls these tools in Orchestration & sub-agents.
- Ground tool answers in your documents with Knowledge / RAG.
HTML documents
Use doc_generate with format: "html" to create an HTML attachment up to 4 MiB in UTF-8. CSS and JavaScript are preserved. A compatible updated app opens the saved file in an isolated preview after checking its source and integrity. App credentials are not passed to the preview; changing the file, source or signed-in session invalidates it.