Search Brain Results
Benchmarked against: Anthropic — Search results Tools:
search_brain,search_by_category,get_entryArchitecture: Cloud UB hybrid search (FTS5 keyword + Vectorize semantic)
search_brain is the primary knowledge retrieval tool. It combines keyword matching with semantic similarity to find relevant UB entries, returning ranked results with metadata.
How search works
Hybrid search combines two approaches:
| Method | Strength | Weakness |
|---|---|---|
| FTS5 (keyword) | Exact term matches, fast | Misses synonyms and related concepts |
| Vectorize (semantic) | Understands meaning, finds related content | May miss exact terms |
| Hybrid (combined) | Best of both — precision + recall | Slightly more processing |
Using search_brain
search_brain("Cloud UB architecture")
Response format
[
{
"entry_id": "ub-396f44b70763",
"title": "Cloud UB Architecture Specification",
"content": "Cloud UB is the fleet's shared knowledge...",
"category": "knowledge",
"tags": ["spec", "cloud-ub", "architecture"],
"source_ship": "SS1",
"created_at": "2026-03-01T10:00:00Z",
"score": 0.95
}
]
| Field | Description |
|---|---|
entry_id | Unique identifier for get_entry() |
title | Entry title (searchable) |
content | Content preview (may be truncated) |
category | knowledge, project_doc, session_record, etc. |
tags | Categorization tags |
source_ship | Which ship ingested this |
score | Combined relevance score (0-1) |
Search strategies
By query type
| Need | Query approach |
|---|---|
| Find a specific entry | Use exact title or entry_id |
| Explore a topic | Broad topic keywords |
| Find decisions | "decision [topic]" |
| Find corrections | "correction [topic]" |
| Find session handoffs | "session-handoff [agent]" |
By category
# Browse entries by category
search_by_category(category="knowledge")
search_by_category(category="project_doc", subcategory="architecture")
Available categories: knowledge, project_doc, session_record, source_code, config_script, trading, media.
Search language
All UB entries are in English (Captain decision, 2026-02-28). Search queries should also be in English for best results.
| Query language | Result quality |
|---|---|
| English query → English entries | Best match |
| Chinese query → English entries | Semantic may work, keyword won't |
The search-first flow
Before any external search, always check UB:
1. search_brain("topic") → Check existing knowledge
2. If found → Use it → Free, instant
3. If empty → intel_search/search_web → Delegate to low-cost engine
4. Results → ingest_fragment() → Becomes UB asset for next time
Related pages
| Page | Relationship |
|---|---|
| Cloud UB MCP | Server architecture |
| UB Source Tracking | Metadata and tags |
| Embeddings | Vector search details |
| UB Governance | Ingestion rules |