Skip to content

Conversation

@itaismith
Copy link
Contributor

Adding agentic search guide

@itaismith itaismith changed the title Itai/docs agentic search [DOC] Agentic Search Guide Nov 18, 2025
@github-actions
Copy link

Reviewer Checklist

Please leverage this checklist to ensure your code review is thorough before approving

Testing, Bugs, Errors, Logs, Documentation

  • Can you think of any use case in which the code does not behave as intended? Have they been tested?
  • Can you think of any inputs or external events that could break the code? Is user input validated and safe? Have they been tested?
  • If appropriate, are there adequate property based tests?
  • If appropriate, are there adequate unit tests?
  • Should any logging, debugging, tracing information be added or removed?
  • Are error messages user-friendly?
  • Have all documentation changes needed been made?
  • Have all non-obvious changes been commented?

System Compatibility

  • Are there any potential impacts on other parts of the system or backward compatibility?
  • Does this change intersect with any items on our roadmap, and if so, is there a plan for fitting them together?

Quality

  • Is this code of a unexpectedly high quality (Readability, Modularity, Intuitiveness)

@propel-code-bot
Copy link
Contributor

propel-code-bot bot commented Nov 18, 2025

Add “Agentic Search” Guide + supporting Markdoc/React components

Introduces a comprehensive guide explaining agent-driven multi-step retrieval (≈450 LOC of markdown) and wires it into the docs site. To support richer guide content, several new/updated React components (CollapsibleCodeBlock, TypescriptInstallation, enhanced TabbedUseCaseCodeBlock, etc.) and corresponding Markdoc configuration entries are added. Sidebar navigation is updated to surface the new guide and Cloud feature pages; minor styling/grammar tweaks appear across existing components.

Key Changes

• New guide file guides/build/agentic-search.md (≈458 lines) with examples, CLI steps, and dataset explanation
• New component docs/.../collapsible-code-block.tsx to cap code-block height with scroll; integrates via new Markdoc tag
• New component ts-installation.tsx for multi-package-manager install snippets
• Enhanced tabbed-use-case-code-block.tsx (adds scrollable support, refactors CodeBlock injection)
• Extended code-block.tsx (exported props, displayName, header visibility, className passthrough)
• Markdoc config.ts updated to register new tags/components + adds optional scrollable attribute
• Sidebar sidebar-config.ts updated – new guide entry, minor tidy-ups
• Minor layout tweak in steps.tsx component

Affected Areas

• Static documentation content
• Docs site React component library
• Markdoc config / parsing pipeline
• Sidebar navigation data

This summary was automatically generated by @propel-code-bot


## BrowseComp-Plus

In this guide we will build a Search Agent from scratch. Our agent will be
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[Documentation]

Add a comma after "guide": "In this guide, we will build a Search Agent from scratch."

Context for Agents
[**Documentation**]

Add a comma after "guide": "In this guide, we will build a Search Agent from scratch."

File: docs/docs.trychroma.com/markdoc/content/guides/build/agentic-search.md
Line: 108

overall performance.

Every query in the BrowseComp-Plus dataset has
* Gold docs - that are needed to compile the final correct answer for the query.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[Documentation]

Improve grammar: "Gold docs – documents needed to compile the final correct answer for the query." (remove the redundant "that are")

Context for Agents
[**Documentation**]

Improve grammar: "Gold docs – documents needed to compile the final correct answer for the query." (remove the redundant "that are")

File: docs/docs.trychroma.com/markdoc/content/guides/build/agentic-search.md
Line: 119

@itaismith itaismith merged commit 2af0a46 into main Nov 20, 2025
60 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants