{"uid":"cap_8L0V6t-WIeO85JYgEwoSd","slug":"vektorwerk-tool-router-e08eaecf","name":"Vektorwerk Tool Router","description":"Embeds one request and a provided tool list locally, then returns deterministic similarity ranks and the selected tool.","url":"https://vektor.halowerk.com/route","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"model":{"enum":["nomic","bge_m3"],"type":"string","default":"nomic"},"tools":{"type":"array","items":{"type":"object","required":["name","description"],"properties":{"name":{"type":"string","example":"shipment_exception_summary","maxLength":80,"minLength":1},"description":{"type":"string","example":"Summarizes delayed shipments and groups them by carrier.","maxLength":12000,"minLength":1}},"additionalProperties":false},"maxItems":48,"minItems":1},"top_k":{"type":"integer","default":3,"maximum":10,"minimum":1},"request":{"type":"string","example":"Find delayed shipments and summarize the exceptions.","maxLength":12000,"minLength":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lb9ZJbcSyNFc1r9bC5WY2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Embeds a natural language request and a provided list of tools locally, then returns deterministic cosine similarity ranks and selects the best-matching tool.","exampleAgentPrompt":"I have these 5 tools — 'shipment_exception_summary', 'carrier_delay_report', 'inventory_reorder', 'customer_refund_lookup', and 'route_optimizer' — can you use Vektorwerk with the nomic model to find the top 2 that best match 'Find delayed shipments and summarize the exceptions'?","exampleUseCases":[{"title":"Agent tool dispatcher for logistics","prompt":"I have 10 logistics tools defined with names and descriptions. Use Vektorwerk (nomic model, top 3) to figure out which ones best match the user request 'show me a summary of all carrier delays this week'."},{"title":"Customer support intent routing","prompt":"I've got a list of 8 support tools — like 'refund_processor', 'ticket_escalation', 'order_status_lookup' — and a user just said 'I want to return my order'. Run this through Vektorwerk with bge_m3 and give me the top 1 match."},{"title":"Code assistant tool selection","prompt":"My coding agent has tools for 'lint_code', 'run_tests', 'deploy_service', and 'generate_docs'. Use Vektorwerk with nomic to rank which tools are most relevant when the user says 'check if my code follows style guidelines', returning the top 2."}],"resultDescription":"Returns a ranked list of up to top_k tools from the submitted list, each with a cosine similarity score, ordered descending. Includes the name of the single best-matching (selected) tool. All computation is local — no external API calls are made for embedding.","failureModes":["Empty or missing 'request' field returns a validation error","Fewer than 1 or more than 48 tools in the list triggers a schema error","Invalid model enum value (not 'nomic' or 'bge_m3') returns a bad request","top_k greater than 10 or less than 1 is rejected","Tool name or description exceeding character limits causes a 422 error","Ollama runtime unavailability on the server side may cause a 503 or timeout"],"whenToPreferThis":"Choose this endpoint when you need fast, deterministic, locally-computed tool routing without relying on an LLM to decide which function to call. It is ideal for agent orchestration layers that maintain a fixed toolset and need to rank tools by semantic relevance to a user request. Prefer it over LLM-based routing when you want reproducible, low-latency selection with no stochastic variance, and when your toolset has up to 48 entries. If you need full-text embedding of arbitrary candidate strings (not tool objects), use the sibling semantic search endpoint instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:36:53.761Z","isFirstParty":false}