Skip to content

add instructions for site admins to view their own Deep Search usage limits #1373

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Oct 6, 2025
+12 −0
Merged

add instructions for site admins to view their own Deep Search usage limits #1373

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
9584f8f
add instructions for site admins to view their own Deep Search usage …
emidoots Oct 5, 2025
03b0e2a
Replace Deep Search usage image in index.mdx
emidoots Oct 6, 2025
4e403d5
clarify docs
emidoots Oct 6, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/deep-search/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@

<Callout type="note">Deep Search is available for Enterprise and Enterprise Starter customers. It's not supported for BYOK users. Please reach out to your Sourcegraph account team to request access. </Callout>

Site administrators can monitor Deep Search usage and quota limits through the [Enterprise Portal](/enterprise-portal#deep-search-usage-monitoring).
Copy link
Member

Choose a reason for hiding this comment

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

This might be a bit confusing, as we don't automatically sync site admin state with the Enterprise Portal subscription admins

Copy link
Member

Choose a reason for hiding this comment

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

I think you can say "Customers can request access to Enterprise Portal to monitor ... "


Deep Search is an agentic code search tool that understands natural language questions about your codebase. When a question is submitted, Deep Search performs an in-depth search and returns a detailed answer. The conversation can be continued with follow-up questions to dive deeper into relevant code.

Under the hood, Deep Search is an AI agent that uses various tools to generate its answer. The tools are functionalities available in Sourcegraph. They include multiple modes of Sourcegraph's Code Search and Code Navigation features. All processing happens within your Sourcegraph instance. Only external calls are made to the configured LLM.
Expand Down
10 changes: 10 additions & 0 deletions docs/enterprise-portal/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,3 +29,13 @@ Users can be invited individually or in bulk. If there is no [Sourcegraph Accoun
Subscription admins can view [Sourcegraph Analytics](/analytics) for the subscription.

![Sourcegraph Enterprise Portal analytics](https://storage.googleapis.com/sourcegraph-assets/Docs/enterprise-portal-analytics.png)

### Deep Search usage monitoring

Site administrators can view their own [Deep Search](/deep-search) usage for the current quota period directly in the Enterprise Portal. This provides visibility into consumption relative to usage limits.

To access usage information, you must first [access the Enterprise Portal](#accessing-sourcegraph-enterprise-portal) as a subscription admin.

![Enterprise Portal Deep Search usage](https://storage.googleapis.com/sourcegraph-assets/Docs/enterprise-portal-deep-search-quota.jpg)

<Callout type="note">If you are currently being given unlimited Deep Search quota for any reason, the `consumption / limit` numbers will still be shown to make it clear what your usage limits will be once unlimited usage is taken away.</Callout>
Copy link
Contributor

Choose a reason for hiding this comment

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

Will any customer have unlimited? Is it worth calling this out if few to none will have this?

Copy link
Member

Choose a reason for hiding this comment

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

Yeah, this might give the wrong impression ("how do I get on this unlimited train?"). We should mention this in our internal docs though