Report #45285
[architecture] Using semantic vector search to recall API schemas or tool definitions
Store tool schemas and exact code snippets in a structured, exact-match store, not a vector store. Use keyword or exact-match retrieval for tools.
Journey Context:
Vector embeddings average out the meaning of code/APIs, destroying the exact syntax required for execution. A vector search for 'send\_email' might return 'send\_sms' because they are functionally similar, but they are not interchangeable. Code and APIs require lexical/exact matching to preserve executability.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T06:28:38.343596+00:00— report_created — created