From 9584f8fdbe25a27551e523ef5cf3b48bf0ae22d8 Mon Sep 17 00:00:00 2001 From: Emi Date: Sun, 5 Oct 2025 11:14:49 -0700 Subject: [PATCH 1/3] add instructions for site admins to view their own Deep Search usage limits Signed-off-by: Emi --- docs/deep-search/index.mdx | 2 ++ docs/enterprise-portal/index.mdx | 10 ++++++++++ 2 files changed, 12 insertions(+) diff --git a/docs/deep-search/index.mdx b/docs/deep-search/index.mdx index 9c5777d0e..96a0d6299 100644 --- a/docs/deep-search/index.mdx +++ b/docs/deep-search/index.mdx @@ -4,6 +4,8 @@ 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. +Site administrators can monitor Deep Search usage and quota limits through the [Enterprise Portal](/enterprise-portal#deep-search-usage-monitoring). + 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. diff --git a/docs/enterprise-portal/index.mdx b/docs/enterprise-portal/index.mdx index 344ed9917..25bf580a6 100644 --- a/docs/enterprise-portal/index.mdx +++ b/docs/enterprise-portal/index.mdx @@ -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) + +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. From 03b0e2aaf1be9b91f7028da7806de6e6203516a8 Mon Sep 17 00:00:00 2001 From: Emi Date: Mon, 6 Oct 2025 14:00:06 -0700 Subject: [PATCH 2/3] Replace Deep Search usage image in index.mdx Updated Deep Search usage image in the Enterprise Portal documentation. --- docs/enterprise-portal/index.mdx | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/enterprise-portal/index.mdx b/docs/enterprise-portal/index.mdx index 25bf580a6..bf5168003 100644 --- a/docs/enterprise-portal/index.mdx +++ b/docs/enterprise-portal/index.mdx @@ -36,6 +36,4 @@ Site administrators can view their own [Deep Search](/deep-search) usage for the 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) - -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. +![Enterprise Portal Deep Search usage](https://storage.googleapis.com/sourcegraph-assets/Docs/enterprise-portal-deep-search-quota-2.jpg) From 4e403d5147db83cbdba0091a39a1f68c8b8bb39a Mon Sep 17 00:00:00 2001 From: Emi Date: Mon, 6 Oct 2025 14:02:02 -0700 Subject: [PATCH 3/3] clarify docs --- docs/deep-search/index.mdx | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/deep-search/index.mdx b/docs/deep-search/index.mdx index 96a0d6299..0b144e2c9 100644 --- a/docs/deep-search/index.mdx +++ b/docs/deep-search/index.mdx @@ -4,8 +4,6 @@ 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. -Site administrators can monitor Deep Search usage and quota limits through the [Enterprise Portal](/enterprise-portal#deep-search-usage-monitoring). - 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. @@ -69,3 +67,7 @@ Deep Search is only available to customers using Sourcegraph’s built-in model ## API access For programmatic access to Deep Search functionality, see the [Deep Search API documentation](/deep-search/api). + +## Monitoring consumption + +Customers can request access to [Enterprise Portal](/enterprise-portal#deep-search-usage-monitoring) to monitor Deep Search usage and quota limits..