recommend_docs_path
Given an intent and optional product hint, searches all four DERO products concurrently, boosts hinted product scores, and returns ranked recommendations with rationale and ready-to-cite related docs.
Instructions
Composite: take a natural-language intent, fan out parallel scoped searches across the bundled docs for all four DERO products (derod, tela, hologram, deropay), boost any product_hint matches by 1.5×, and return a ranked recommendation list with per-result rationale plus ready-to-cite related_docs.
When to call: at the START of any "where do I read about X?" or "which docs cover Y?" investigation, BEFORE calling dero_docs_search directly. PREFER this over guessing the right product: this composite already runs all four products in parallel, dedupes overlap, surfaces the top heading per result as rationale, and gives you the top-2 citations pre-built. Pass product_hint when the user has already said e.g. "TELA" or "DeroPay" so that product's matches float to the top.
Input Requirements:
intentis REQUIRED. Free-text description of what the user is trying to do (min 8 chars). Drop verbs and use product nouns like "deploy a TELA app" or "verify a DeroPay webhook signature" for best results.product_hintis OPTIONAL. One ofderod | tela | hologram | deropay. Multiplies hint-product scores by 1.5×.limit_per_productis OPTIONAL (default 2, max 5). Cap per-product hits before merging.
Output: { intent, product_hint, limit_per_product, recommended: [{ product, slug, title, canonical_url, score, boosted_score, rationale }], by_product: { derod | tela | hologram | deropay: { count, top_slug, top_score } }, related_docs: DeroCitation[] }. related_docs is the top-2 picks pre-built as citations the agent can drop straight into a response. On zero matches across every product the composite returns a structured _meta.error with code NO_DOCS_MATCH and a hint to rephrase or drop the product_hint.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| intent | Yes | Natural-language description of what the user wants to do (e.g. "deploy a TELA app", "trace a transaction by hash", "verify a webhook signature"). | |
| product_hint | No | Optional bias toward one product (derod | tela | hologram | deropay) when known. | |
| limit_per_product | No | Cap per-product search results before merging. Default 2. |