Available Tools

Once connected, your agent has access to these 8 tools:

recall

Search the knowledge graph by meaning using natural language.

Use it when: you want to find knowledge related to a topic without knowing the exact address.

Input:

• query — your search question (e.g. "honey formula", "marital status")
• topK (optional) — number of results to return (default: 10)

Returns: list of matching nodes with address, content, and relevance score

Example:

"Search HiveBoss for anything about the pricing formula"

recall_sources

Search only within source nodes — verbatim imported files (GitHub, ZIP, file upload).

Use it when: you want to search the original imported documents rather than the extracted knowledge items. Useful when you need the full context of a file rather than specific facts extracted from it.

Input:

• query — your search question (e.g. "product plan", "strategy document")
• topK (optional) — number of results to return (default: 10)

Returns: list of matching source nodes with address, content, and relevance score

Example:

"Search HiveBoss source files for anything about the mobile app plan"

retrieve

Get a specific knowledge node by its exact address.

Use it when: you know exactly which node you want.

Input:

• address — the node address (e.g. marital_status_single)

Returns: the full node with all fields, or null if not found

Example:

"Retrieve the node at address marital_status_single from HiveBoss"

read_source

Get only the raw text content of a node.

Use it when: you just need the content text, not the full node metadata.

Input:

• address — the node address

Returns: plain text content of the node, or null if not found

Example:

"Read the source content of the node at inv.profession.abc123"

trace_provenance

See the full version history of a knowledge node — every change ever made to it.

Use it when: you want to know how a piece of knowledge has changed over time or who changed it.

Input:

• address — the node address

Returns: list of versions ordered newest first, each with content and timestamp

Example:

"Show me the full history of changes to the node marital_status_single"

remember (readwrite key required)

Save a new piece of knowledge or update an existing one.

Use it when: you want the agent to write something into the knowledge graph.

Input:

• address — the node address (e.g. team/standup-notes/2026-07-02)
• content — the text content to save
• metadata (optional) — any extra data to store with the node

Behaviour:

• If a node with that address already exists → it updates it and saves the old version to history
• If no node exists at that address → it creates a new one
• The result always includes the real node address for each created/updated node — use this address for follow-up retrieve, read_source, or related_nodes calls

Example:

"Save these standup notes to HiveBoss at address team/standup/2026-07-02"

related_nodes

Walk the knowledge graph — see which nodes are connected to a given node via typed edges (e.g. derived-from, source-of, about).

Use it when: you want to explore what a node is connected to without fetching full content. Follow up with retrieve or read_source on any address you want to read in full.

Input:

• address — the node address

Returns: list of neighbor node stubs — address, title, neuronType, relation type, and direction (in/out). A node may legitimately have zero links — this is not an error.

Example:

"Show me all nodes connected to the HiveBoss pricing node"

provide_feedback (readwrite key required)

Flag a knowledge node with quality feedback.

Use it when: you want to mark a node as useful, incorrect, or a gap in knowledge.

Input:

• address — the node address
• feedback — one of: useful, gap, wrong

Returns: the updated node with feedback counters

Example:

"Mark the node marital_status_single as useful in HiveBoss"