> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dataerai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ask AI in Advanced Search

> Describe what you're looking for in plain English — DataErai plans an executable graph traversal and populates the Advanced Search form for you to inspect and refine.

The **Ask AI bar** at the top of Advanced Search lets you start from plain English instead of a blank form. Type a sentence — *"show me records related to asset X"*, *"find datasets shared with my team"*, *"neighbors of this collection by share edges"* — and DataErai's planner fills in an executable graph traversal: scope, aliases, path steps, return options, and limits. You can inspect and tweak the form before running it.

<Note>
  Ask AI in Advanced Search is **different from AI search in the global Search box**. The global bar (see [Search & discover](/discover/search)) translates your question into a flat metadata filter — equal, contains, exists. Ask AI in Advanced Search pre-populates a graph traversal — paths, hops, edge types, returns. Same NL, different output shape. Use this one for relationship-shaped questions, the global one for attribute-shaped ones.
</Note>

## Use it

<Steps>
  <Step title="Open Advanced Search">
    Click **Advanced Search** in the sidebar. The Ask AI bar sits at the top of the page, above the form.

    <Frame caption="The Ask AI bar at the top of Advanced Search. Type a natural-language request and press Enter.">
      <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/ask-ai-advanced-bar.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=0b0432a6fce244ff91008206121952bd" alt="DataErai Advanced Search page showing the Ask AI input bar above the structured form" width="1440" height="900" data-path="images/ask-ai-advanced-bar.png" />
    </Frame>
  </Step>

  <Step title="Ask in plain English">
    Type what you want. The planner understands the graph-query vocabulary behind Advanced Search and currently emits an executable neighborhood-style traversal. It can approximate relationship-shaped requests with aliases, path steps, edge types, and limits. Press Enter to submit.

    Examples that work well:

    * *"two-hop neighbors of this project by share edges"*
    * *"datasets connected to this collection, max 50 results"*
    * *"assets related to sample SP-12"*
  </Step>

  <Step title="Watch the form populate">
    When the planner returns, the Advanced Search form fills in below the bar — scope, aliases, path steps, and return options all reflect the Spec the planner produced. You can immediately click **Search** or edit any field first.

    <Frame caption="After submitting an NL query, the form populates with the planner's Spec — scope, path step, edge types, and limits are all set automatically.">
      <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/ask-ai-advanced-form-populated-after-ask-ai.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=18fc0649ec95fce09a0217109840c057" alt="DataErai Advanced Search form populated with a planner-generated graph traversal Spec" width="1440" height="900" data-path="images/ask-ai-advanced-form-populated-after-ask-ai.png" />
    </Frame>
  </Step>

  <Step title="Refine your phrasing">
    Not quite right? Click **Refine** next to the bar to re-run the planner with your edited NL while keeping the form's current state as context. The Spec updates in place; fields you'd already touched stay touched.

    <Frame caption="Before Refine — the form holds the planner's first interpretation.">
      <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/ask-ai-advanced-refine-before.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=3bd4eb0d8ca8f6be3456cd5e760fec65" alt="Advanced Search form populated with the initial planner Spec, with the Refine button visible" width="1440" height="900" data-path="images/ask-ai-advanced-refine-before.png" />
    </Frame>

    <Frame caption="After Refine — the planner re-runs with the edited NL, the form updates in place.">
      <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/ask-ai-advanced-refine-after.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=3808ad7acdc964e729014ce6ff9d2051" alt="Advanced Search form updated after clicking Refine, showing a re-planned Spec" width="1440" height="900" data-path="images/ask-ai-advanced-refine-after.png" />
    </Frame>
  </Step>

  <Step title="See why the planner chose that Spec">
    Click **Show reasoning** to expand the explanation panel. The planner reports the confidence level and the raw model output it used before producing the form — useful when the result surprises you or you want to understand which words steered the traversal.

    <Frame caption="Show reasoning expands a panel with confidence and the raw planner output.">
      <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/ask-ai-advanced-show-reasoning-open.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=fc3b8c6dccdf7bf89a067f5e386301f9" alt="The Show reasoning expander open, showing planner confidence and rationale text" width="1440" height="900" data-path="images/ask-ai-advanced-show-reasoning-open.png" />
    </Frame>
  </Step>
</Steps>

## What the planner handles well

<CardGroup cols={2}>
  <Card title="Relationship questions" icon="git-merge">
    *"neighbors of …"*, *"shared with …"*, *"connected to …"* — relationship prompts that can be represented as an executable neighborhood traversal.
  </Card>

  <Card title="Bounded traversals" icon="calendar">
    *"two hops from …"*, *"max 50 results"*, *"include graph evidence"* — traversal limits and return options are good fits.
  </Card>

  <Card title="Bounded scope" icon="boxes">
    *"within this project"*, *"top 50 results"* — scope items and limits are honored without you naming them in the form.
  </Card>

  <Card title="Imperfect input" icon="check">
    Typos, missing capitalization, half-finished thoughts — the planner is tolerant and will still produce a plausible Spec rather than refusing.
  </Card>
</CardGroup>

<Frame caption="Even garbled input still produces a usable Spec — the planner falls back to a safe traversal the form can run.">
  <img src="https://mintcdn.com/dataerai/JYQfiA1164D5XDuO/images/ask-ai-advanced-garbage-nl-still-hydrated.png?fit=max&auto=format&n=JYQfiA1164D5XDuO&q=85&s=cd48e29b4ddd87ee4322afe7ce87e42a" alt="The Advanced Search form populated even after a deliberately garbled NL input" width="1440" height="900" data-path="images/ask-ai-advanced-garbage-nl-still-hydrated.png" />
</Frame>

## What works less well

<Warning>
  The planner is best at **executable neighborhood traversal** questions. For the cases below, it returns an approximation rather than a specialized graph family — rephrase instead of editing for too long:

  * **Pure attribute filters** — *"PDFs over 10 MB"* — better expressed via the global [Search & discover](/discover/search).
  * **Specialized graph algorithms** — shortest path, lineage, aggregation, centrality, and community detection are recognized by the planner vocabulary, but the executable endpoint currently emits a neighborhood-style Spec so the search can run.
  * **Open-ended exploration** — *"show me anything interesting"* — the planner needs a concrete relationship or attribute to map to.
  * **Concepts the form can't express** — e.g. natural-language *content* search across asset bodies — the form supports structured graph traversal and metadata filters, not freeform full-text rank.
</Warning>

## Availability

The Ask AI bar appears in Advanced Search when your organization has opted in to AI features. If you don't see the bar, ask an organization admin to enable it — see [AI policy & access](/ai/policy-and-access).

## Next steps

<CardGroup cols={2}>
  <Card title="Build queries by hand" icon="filter" href="/discover/search">
    Want full control? Use the Advanced Search form's clauses, AND/OR/NOT, and metadata operators directly.
  </Card>

  <Card title="AI search in the global bar" icon="search" href="/ai/llm-search">
    The other AI lane — attribute filters from natural language, in the top-of-page Search box.
  </Card>
</CardGroup>
