Knowledge Base Admin Tools

​

Overview

​

Tool Name

knowledge_base_admin_tools

​

Purpose

​

Functions Available

1. list_knowledge_bases: List registered knowledge bases that can be assigned to agents.
2. create_knowledge_base: Create or register a reusable knowledge base backed by one or more document indexes.
3. delete_knowledge_base: Delete a registered knowledge base and remove assignments that reference it.

​

Input Parameters for Each Function

​

list_knowledge_bases

​

create_knowledge_base

​

delete_knowledge_base

​

Typical Flow

1. Create or update the source document indexes with Document Index Tools. For Git-backed indexes synced from a managed source, stage markdown edits with propose_kb_edit(...) instead of direct ADD_DOCUMENTS writes.
2. Register a reusable bundle with create_knowledge_base(...).
3. Assign that knowledge_base_id to an agent with set_bot_knowledge_bases(...).
4. Let the assigned agent use search_knowledge_bases(...) during runtime, then read_knowledge_base_doc(...) when it needs the full text of a matched document.

​

Example

create_knowledge_base(
    knowledge_base_id="customer-success",
    title="Customer Success Playbooks",
    index_names=["renewal_runbooks", "escalation_policies"],
    summary="Renewal, onboarding, and escalation guidance.",
    search_hint="Use for customer-success process questions.",
    recommended_queries=["renewal path", "handoff checklist"],
)

set_bot_knowledge_bases(
    bot_id="Eve",
    knowledge_bases=["customer-success"],
)

​

Output

• list_knowledge_bases returns success, count, and knowledge_bases.
• create_knowledge_base returns success, knowledge_base_id, created_by, attributed_to_another, and the saved knowledge_base. These values are read from the persisted record: replacing an existing id keeps its original created_by, while a record without a named creator returns "unattributed" and a null attribution.
• delete_knowledge_base returns success, knowledge_base_id, and removed_assignments.