Grant a tool to a skill or agent
A tool is only callable if it’s in the skill or agent’s allowed tools. Add the tool by name (web_search, web_fetch, current_time) in the skill’s
SKILL.md or on the agent — that’s the only permission a built-in tool needs.
Web search
web_search is powered by Tavily. It returns ranked results
(title, URL, snippet) — 5 by default, up to 20. It’s the one built-in tool that
needs a key: the Hub calls Tavily directly with your key, so you must add one before
web_search will run.
Get a Tavily API key
1
Create a Tavily account
Go to tavily.com and sign up. The free tier is enough to get
started.
2
Copy your API key
From the Tavily dashboard, copy your API key — it starts with
tvly-.Add the key in the Hub
1
Open Viorant Tools
In the Hub, open the Connectors surface and select Viorant Tools — the
built-in tools entry, always pinned to the top of the list.
2
Paste your Tavily key
In the Tool keys panel, paste your key into Tavily API key and click Save
key. The Hub verifies the key against Tavily before saving.
3
Enable web search
Turn on
web_search for the skills or agents that should use it. The toggle stays
disabled until a valid key is saved.Your Tavily key is stored in your OS credential store and is never sent to Viorant’s
servers — and it’s never shown again after saving. To rotate it, save a new key; to
turn off web search, remove the key with Remove key. This is true for the Hub’s local
runs. A deployed agent works differently — see below.
On a deployed agent
A.vio agent deployed with the CLI has no Hub credential store to read
from. Its Tavily key lives in the Space’s .vio/.env.connectors and is sent to the
deployment as a sealed secret at vio deploy time — never inside the bundle, but no
longer kept only on your machine either, unlike the Hub’s local runs above. See
Connectors and tools for the full setup, including how
to add or rotate the key once the agent is already deployed.
Web fetch
web_fetch takes a URL, downloads the page, and returns its main content as
markdown (readability extraction, up to ~100 KB by default). Use it to read a specific
page — often a result from web_search.
It needs no key and no account. The only requirement is that web_fetch is in the
skill or agent’s allowed tools.
Current time
current_time returns the current date and time (ISO 8601 + Unix milliseconds), with an
optional IANA timezone. No setup.