From f67c524ad21f021af9eec974a2ed3eac3edbf31f Mon Sep 17 00:00:00 2001 From: Jan Hartman Date: Fri, 20 Jun 2025 10:50:39 +0200 Subject: [PATCH 1/7] Improve enabling section --- docs/code-search/types/deep-search.mdx | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/code-search/types/deep-search.mdx b/docs/code-search/types/deep-search.mdx index 30cf569c7..305c936a3 100644 --- a/docs/code-search/types/deep-search.mdx +++ b/docs/code-search/types/deep-search.mdx @@ -28,10 +28,17 @@ Deep Search displays a list of sources used to generate the answer. The sources Deep Search can only be used on Sourcegraph instances with Code Search and Cody licenses. -Deep Search is disabled by default. To enable it, ask your site administrator to set `experimentalFeatures.deepSearch.enabled = "true"` in your site configuration. +Deep Search is disabled by default. To enable it, ask your site administrator to enable the following setting in your site configuration: +```json +"experimentalFeatures": { + "deepSearch.enabled": true, +}, +``` For optimal performance, Deep Search is specialized to only use one model. Currently, Deep Search only supports Claude Sonnet 4. +If you are not using [Cody Gateway](/cody/core-concepts/cody-gateway), you will also need to configure the model through either Amazon Bedrock or GCP Vertex. + ### Configuring Deep Search on Amazon Bedrock or GCP Vertex Include configuration for Claude Sonnet 4 in [modelOverrides](/cody/enterprise/model-configuration#model-overrides) in your site configuration. For more information on configuring models, refer to [Model Configuration](/cody/enterprise/model-configuration). From cc68851688da52f620ae60e360fadd16ab154eb7 Mon Sep 17 00:00:00 2001 From: Jan Hartman Date: Fri, 20 Jun 2025 11:58:24 +0200 Subject: [PATCH 2/7] Conversation sharing + expanding text --- docs/code-search/types/deep-search.mdx | 33 +++++++++++++++++++------- 1 file changed, 25 insertions(+), 8 deletions(-) diff --git a/docs/code-search/types/deep-search.mdx b/docs/code-search/types/deep-search.mdx index 305c936a3..f8bee2a4c 100644 --- a/docs/code-search/types/deep-search.mdx +++ b/docs/code-search/types/deep-search.mdx @@ -2,31 +2,38 @@

Learn more about Sourcegraph's agentic Code Search tool Deep Search.

- New in version 6.4. Deep Search is currently in research preview for Enterprise customers with access to Cody and Code Search. Because Deep Search is in research preview, it might change significantly in the future as we make improvements and adjust to user feedback. Please reach out to your Sourcegraph account team to request access. + New in version 6.4. Deep Search is currently in research preview for Enterprise customers. Because Deep Search is in research preview, it might change significantly in the future as we make improvements and adjust to user feedback. Please reach out to your Sourcegraph account team to request access. Deep Search is an agentic code search tool. It receives a natural language question about a codebase, performs an in-depth search, and returns a detailed answer. The user can also ask follow-up questions to improve the answer further. -Under the hood, Deep Search is an AI agent that uses various tools to generate its answer. These tools include multiple modes of Sourcegraph's Code Search and Code Navigation tools. Using tools in an agentic loop enables Deep Search to iteratively refine its understanding of the question and codebase, searching until it is confident in its answer. +Under the hood, Deep Search is an AI agent that uses various tools to generate its answer. These tools include multiple modes of Sourcegraph's Code Search and Code Navigation tools. +Using tools in an agentic loop enables Deep Search to iteratively refine its understanding of the question and codebase, searching until it is confident in its answer. +The tools are functionalities available in Sou. No data leaves the Sourcegraph instance except calls to the LLM provider. -Deep Search displays a list of sources used to generate the answer. The sources are the various types of searches it performs and the files it reads. The answer is formatted in markdown. If prompted to do so, Deep Search can also generate diagrams as part of its answer. +Deep Search displays a list of sources used to generate the answer. The sources are the various types of searches it performs and the files it reads. The list of sources is extremely useful for understanding where the answer came from and for further explorations of the codebase. +The answer is formatted in Markdown and can include links to relevant files, directories or repositories. If prompted to do so, Deep Search can also generate diagrams as part of its answer. ## Best practices -- Give the agent a starting point for the search: Mention relevant repositories, files, directories, or symbol names. The more specific you are, the faster the search will be. +- Give the agent a starting point for the search: use @-mentions to mention relevant repositories, files, directories, or symbol names. The more specific you are, the faster the search will be. - Provide reasonably scoped questions. The agent will perform much better if it does not have to read the entire codebase at once. - Check the list of sources. This is extremely useful for debugging and understanding where the answer came from. If something is missing, ask a follow-up question and mention the missing source. ### Examples of prompts - Find examples of logger usage and show examples of the different types of logging we use. -- I want to know when the indexing queue functionality was last changed in `sourcegraph/zoekt`. Show me the last few commit diffs touching this code and explain the changes. -- Look at the GraphQL APIs available in `sourcegraph/sourcegraph`. Are any of them unused? The client code is in `sourcegraph/cody`. +- I want to know when the indexing queue functionality was last changed in `@zoekt`. Show me the last few commit diffs touching this code and explain the changes. +- Look at the GraphQL APIs available in `@sourcegraph/sourcegraph`. Are any of them unused? The client code is in the `@cody` repository. - Which tools do we use in our build processes defined in `BUILD.bazel` files? - Generate a request flow diagram for `src/backend`. Mark the auth and rate limit points. -## Enabling Deep Search +## Conversation sharing +You can share Deep Search conversations with other users in your Sourcegraph instance. To share a conversation, click the "Share" button in the top left, then copy the link. +Once you share a conversation, any user on your instance is able to view it with the link. You can also reset the share link and generate a new one, which invalidates the previous link. + +Note that currently, we do not enforce [permissions](/admin/permissions) for viewing shared Deep Search conversations. This means that any user in your Sourcegraph instance can view any shared conversation, regardless of which repositories they have access to. We plan to add support for permission checking in the future. -Deep Search can only be used on Sourcegraph instances with Code Search and Cody licenses. +## Enabling Deep Search Deep Search is disabled by default. To enable it, ask your site administrator to enable the following setting in your site configuration: ```json @@ -39,6 +46,16 @@ For optimal performance, Deep Search is specialized to only use one model. Curre If you are not using [Cody Gateway](/cody/core-concepts/cody-gateway), you will also need to configure the model through either Amazon Bedrock or GCP Vertex. +### Enabling conversation sharing +Conversation sharing is disabled by default. To enable conversation sharing, ask your site administrator to enable the following setting in your site configuration: + +```json +"experimentalFeatures": { + "deepSearch.enabled": true, + "deepSearch.sharing.enabled": true, +}, +``` + ### Configuring Deep Search on Amazon Bedrock or GCP Vertex Include configuration for Claude Sonnet 4 in [modelOverrides](/cody/enterprise/model-configuration#model-overrides) in your site configuration. For more information on configuring models, refer to [Model Configuration](/cody/enterprise/model-configuration). From a4a2ca17e723f4d90575569167a19f91899f5a3c Mon Sep 17 00:00:00 2001 From: Jan Hartman Date: Fri, 20 Jun 2025 13:02:43 +0200 Subject: [PATCH 3/7] Improve intro --- docs/code-search/types/deep-search.mdx | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/code-search/types/deep-search.mdx b/docs/code-search/types/deep-search.mdx index f8bee2a4c..86a9c867c 100644 --- a/docs/code-search/types/deep-search.mdx +++ b/docs/code-search/types/deep-search.mdx @@ -4,14 +4,15 @@ New in version 6.4. Deep Search is currently in research preview for Enterprise customers. Because Deep Search is in research preview, it might change significantly in the future as we make improvements and adjust to user feedback. Please reach out to your Sourcegraph account team to request access. -Deep Search is an agentic code search tool. It receives a natural language question about a codebase, performs an in-depth search, and returns a detailed answer. The user can also ask follow-up questions to improve the answer further. +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. These tools include multiple modes of Sourcegraph's Code Search and Code Navigation tools. -Using tools in an agentic loop enables Deep Search to iteratively refine its understanding of the question and codebase, searching until it is confident in its answer. -The tools are functionalities available in Sou. No data leaves the Sourcegraph instance except calls to the LLM provider. +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 LLM calls are made to external providers based on your configuration. -Deep Search displays a list of sources used to generate the answer. The sources are the various types of searches it performs and the files it reads. The list of sources is extremely useful for understanding where the answer came from and for further explorations of the codebase. -The answer is formatted in Markdown and can include links to relevant files, directories or repositories. If prompted to do so, Deep Search can also generate diagrams as part of its answer. +The core of Deep Search is an agentic loop. The AI agent can intelligently use tools to explore the codebase. In each loop iteration, the agent gradually refines its understanding of the question and codebase, searching until it is confident in its answer. + +Every Deep Search response includes a detailed list of sources that contributed to the answer. These sources show exactly which searches were performed and which files were read. The list of sources is extremely useful for understanding where the answer came from and for further explorations of the codebase. + +The answer is formatted in Markdown and can include links to relevant files, directories, or repositories. If prompted to do so, Deep Search can also generate diagrams as part of its answer. ## Best practices From 7fef52553e6f6a5758454c09e506656c9ed00ee4 Mon Sep 17 00:00:00 2001 From: Jan Hartman Date: Mon, 23 Jun 2025 14:00:39 +0200 Subject: [PATCH 4/7] Increase version, add paragraph about exhaustive results, remove 'disabled by default' --- docs/code-search/types/deep-search.mdx | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/code-search/types/deep-search.mdx b/docs/code-search/types/deep-search.mdx index 86a9c867c..7c0240fb3 100644 --- a/docs/code-search/types/deep-search.mdx +++ b/docs/code-search/types/deep-search.mdx @@ -2,7 +2,7 @@

Learn more about Sourcegraph's agentic Code Search tool Deep Search.

- New in version 6.4. Deep Search is currently in research preview for Enterprise customers. Because Deep Search is in research preview, it might change significantly in the future as we make improvements and adjust to user feedback. Please reach out to your Sourcegraph account team to request access. + New in version 6.5. Deep Search is currently in research preview for Enterprise customers. Because Deep Search is in research preview, it might change significantly in the future as we make improvements and adjust to user feedback. Please reach out to your Sourcegraph account team to request access. 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. @@ -20,6 +20,8 @@ The answer is formatted in Markdown and can include links to relevant files, dir - Provide reasonably scoped questions. The agent will perform much better if it does not have to read the entire codebase at once. - Check the list of sources. This is extremely useful for debugging and understanding where the answer came from. If something is missing, ask a follow-up question and mention the missing source. +For use cases where you're looking for exhaustive answers (e.g. "Find all files with the `.XYZ` file extension in `foo` repo that contain the word `bar`), Code Search still excels, while Deep Search will only utilize a sample of the results. Deep Search will perform a Code Search query as a source, which you can then use to continue with an exhaustive search within the Code Search product. + ### Examples of prompts - Find examples of logger usage and show examples of the different types of logging we use. @@ -36,7 +38,7 @@ Note that currently, we do not enforce [permissions](/admin/permissions) for vie ## Enabling Deep Search -Deep Search is disabled by default. To enable it, ask your site administrator to enable the following setting in your site configuration: +If Deep Search is disabled, ask your site administrator to enable the following setting in your site configuration: ```json "experimentalFeatures": { "deepSearch.enabled": true, @@ -47,7 +49,7 @@ For optimal performance, Deep Search is specialized to only use one model. Curre If you are not using [Cody Gateway](/cody/core-concepts/cody-gateway), you will also need to configure the model through either Amazon Bedrock or GCP Vertex. -### Enabling conversation sharing +### Enabling conversation sharing Conversation sharing is disabled by default. To enable conversation sharing, ask your site administrator to enable the following setting in your site configuration: ```json From 65fd3fb2ee6d1f20ab5b83e3bcc97c14b1674824 Mon Sep 17 00:00:00 2001 From: Jan Hartman Date: Tue, 24 Jun 2025 16:43:15 +0200 Subject: [PATCH 5/7] Addressing comments --- docs/code-search/types/deep-search.mdx | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/code-search/types/deep-search.mdx b/docs/code-search/types/deep-search.mdx index 7c0240fb3..1bbad7e1f 100644 --- a/docs/code-search/types/deep-search.mdx +++ b/docs/code-search/types/deep-search.mdx @@ -2,11 +2,11 @@

Learn more about Sourcegraph's agentic Code Search tool Deep Search.

- New in version 6.5. Deep Search is currently in research preview for Enterprise customers. Because Deep Search is in research preview, it might change significantly in the future as we make improvements and adjust to user feedback. Please reach out to your Sourcegraph account team to request access. + New in version 6.5. Deep Search is currently in research preview for Enterprise and Enterprise Starter customers. Because Deep Search is in research preview, it might change significantly in the future as we make improvements and adjust to user feedback. Please reach out to your Sourcegraph account team to request access. 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 LLM calls are made to external providers based on your configuration. +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 and the only external calls are to the configured LLM. The core of Deep Search is an agentic loop. The AI agent can intelligently use tools to explore the codebase. In each loop iteration, the agent gradually refines its understanding of the question and codebase, searching until it is confident in its answer. @@ -31,10 +31,11 @@ For use cases where you're looking for exhaustive answers (e.g. "Find all files - Generate a request flow diagram for `src/backend`. Mark the auth and rate limit points. ## Conversation sharing -You can share Deep Search conversations with other users in your Sourcegraph instance. To share a conversation, click the "Share" button in the top left, then copy the link. -Once you share a conversation, any user on your instance is able to view it with the link. You can also reset the share link and generate a new one, which invalidates the previous link. +Conversation sharing is disabled by default - see below for instructions on enabling it. -Note that currently, we do not enforce [permissions](/admin/permissions) for viewing shared Deep Search conversations. This means that any user in your Sourcegraph instance can view any shared conversation, regardless of which repositories they have access to. We plan to add support for permission checking in the future. +You can share Deep Search conversations with other users in your Sourcegraph instance. To share a conversation, click the "Share" button in the top left, then copy the link. Once you share a conversation, any user on your instance is able to view it with the link. You can also reset the share link and generate a new one, which invalidates the previous link. + +Currently, we do not enforce [repository permissions](/admin/permissions) for viewing shared Deep Search conversations. This means that a user can view a conversation shared to them, regardless of which repositories they have access to. We plan to revisit this in the future. ## Enabling Deep Search From 7a5978e7179c3ee5af2cb44af72141c4b0c15117 Mon Sep 17 00:00:00 2001 From: Maedah Batool Date: Tue, 24 Jun 2025 10:54:28 -0700 Subject: [PATCH 6/7] Add some tweaks --- docs/code-search/types/deep-search.mdx | 41 +++++++++++++------------- 1 file changed, 21 insertions(+), 20 deletions(-) diff --git a/docs/code-search/types/deep-search.mdx b/docs/code-search/types/deep-search.mdx index 1bbad7e1f..970396ebd 100644 --- a/docs/code-search/types/deep-search.mdx +++ b/docs/code-search/types/deep-search.mdx @@ -1,16 +1,16 @@ # Deep Search -

Learn more about Sourcegraph's agentic Code Search tool Deep Search.

+

Learn more about Sourcegraph's agentic Code Search tool Deep Search.

- New in version 6.5. Deep Search is currently in research preview for Enterprise and Enterprise Starter customers. Because Deep Search is in research preview, it might change significantly in the future as we make improvements and adjust to user feedback. Please reach out to your Sourcegraph account team to request access. + New in version 6.5. Deep Search is currently in research preview for Enterprise and Enterprise Starter customers. Because Deep Search is in research preview, it might change significantly as we improve and adjust to user feedback. Please reach out to your Sourcegraph account team to request access. 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 and the only external calls are to the configured LLM. +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. The core of Deep Search is an agentic loop. The AI agent can intelligently use tools to explore the codebase. In each loop iteration, the agent gradually refines its understanding of the question and codebase, searching until it is confident in its answer. -Every Deep Search response includes a detailed list of sources that contributed to the answer. These sources show exactly which searches were performed and which files were read. The list of sources is extremely useful for understanding where the answer came from and for further explorations of the codebase. +Every Deep Search response includes a detailed list of sources contributing to the answer. These sources show exactly which searches were performed and which files were read. The list of sources is extremely useful for understanding where the answer came from and for further explorations of the codebase. The answer is formatted in Markdown and can include links to relevant files, directories, or repositories. If prompted to do so, Deep Search can also generate diagrams as part of its answer. @@ -18,9 +18,9 @@ The answer is formatted in Markdown and can include links to relevant files, dir - Give the agent a starting point for the search: use @-mentions to mention relevant repositories, files, directories, or symbol names. The more specific you are, the faster the search will be. - Provide reasonably scoped questions. The agent will perform much better if it does not have to read the entire codebase at once. -- Check the list of sources. This is extremely useful for debugging and understanding where the answer came from. If something is missing, ask a follow-up question and mention the missing source. +- Check the list of sources. This is extremely useful for debugging and understanding where the answer came from. Ask a follow-up question and mention the missing source if something is missing. -For use cases where you're looking for exhaustive answers (e.g. "Find all files with the `.XYZ` file extension in `foo` repo that contain the word `bar`), Code Search still excels, while Deep Search will only utilize a sample of the results. Deep Search will perform a Code Search query as a source, which you can then use to continue with an exhaustive search within the Code Search product. +For use cases where you're looking for exhaustive answers (for example, "Find all files with the `.XYZ` file extension in `foo' repo that contain the word `bar`), Code Search still excels, while Deep Search will only utilize a sample of the results. Deep Search will perform a Code Search query as a source, which you can use to continue an exhaustive search within the Code Search product. ### Examples of prompts @@ -31,43 +31,44 @@ For use cases where you're looking for exhaustive answers (e.g. "Find all files - Generate a request flow diagram for `src/backend`. Mark the auth and rate limit points. ## Conversation sharing -Conversation sharing is disabled by default - see below for instructions on enabling it. -You can share Deep Search conversations with other users in your Sourcegraph instance. To share a conversation, click the "Share" button in the top left, then copy the link. Once you share a conversation, any user on your instance is able to view it with the link. You can also reset the share link and generate a new one, which invalidates the previous link. +Conversation sharing is disabled by default - see below for instructions on enabling it. -Currently, we do not enforce [repository permissions](/admin/permissions) for viewing shared Deep Search conversations. This means that a user can view a conversation shared to them, regardless of which repositories they have access to. We plan to revisit this in the future. +You can share Deep Search conversations with other users in your Sourcegraph instance. To share a conversation, click the "Share" button in the top left, then copy the link. Once you share a conversation, any user on your instance can view it with the link. You can also reset the share link and generate a new one, invalidating the previous link. + +We do not enforce [repository permissions](/admin/permissions) for viewing shared Deep Search conversations. This means that a user can view a conversation shared with them, regardless of which repositories they can access. We plan to revisit this in the future. ## Enabling Deep Search If Deep Search is disabled, ask your site administrator to enable the following setting in your site configuration: -```json +"`json "experimentalFeatures": { "deepSearch.enabled": true, }, ``` -For optimal performance, Deep Search is specialized to only use one model. Currently, Deep Search only supports Claude Sonnet 4. +For optimal performance, Deep Search is specialized only to use one model. Currently, Deep Search only supports Claude Sonnet 4. -If you are not using [Cody Gateway](/cody/core-concepts/cody-gateway), you will also need to configure the model through either Amazon Bedrock or GCP Vertex. +If you are not using [Cody Gateway](/cody/core-concepts/cody-gateway), you must also configure the model through Amazon Bedrock or GCP Vertex. ### Enabling conversation sharing Conversation sharing is disabled by default. To enable conversation sharing, ask your site administrator to enable the following setting in your site configuration: -```json +"`json "experimentalFeatures": { "deepSearch.enabled": true, - "deepSearch.sharing.enabled": true, + "deepSearch.sharing.enabled ": true, }, ``` ### Configuring Deep Search on Amazon Bedrock or GCP Vertex -Include configuration for Claude Sonnet 4 in [modelOverrides](/cody/enterprise/model-configuration#model-overrides) in your site configuration. For more information on configuring models, refer to [Model Configuration](/cody/enterprise/model-configuration). +In your site configuration, include the configuration for Claude Sonnet 4 in [modelOverrides](/cody/enterprise/model-configuration#model-overrides). For more information on configuring models, refer to [Model Configuration](/cody/enterprise/model-configuration). -Examples for Sonnet 4 configuration inside `modelOverrides`: +Examples of Sonnet 4 configuration inside `modelOverrides`: Amazon Bedrock: -```json +"`json { "modelRef": "aws-bedrock::v1::claude-sonnet-4", "modelName": "us.anthropic.claude-sonnet-4-20250514-v1:0", @@ -86,7 +87,7 @@ Amazon Bedrock: ``` GCP Vertex: -```json +"`json { "modelRef": "google-anthropic::v2::claude-sonnet-4", "modelName": "claude-sonnet-4@20250514", @@ -107,7 +108,7 @@ GCP Vertex: Then, configure Deep Search to use this model in `experimentalFeatures`: Amazon Bedrock: -```json +"`json "experimentalFeatures": { "deepSearch.enabled": true, "deepSearch.model": "aws-bedrock::v1::claude-sonnet-4" @@ -115,7 +116,7 @@ Amazon Bedrock: ``` GCP Vertex: -```json +"`json "experimentalFeatures": { "deepSearch.enabled": true, "deepSearch.model": "google-anthropic::v2::claude-sonnet-4" From 72beeb6dcd67886220c1cb0158d1e8dbde163f35 Mon Sep 17 00:00:00 2001 From: Maedah Batool Date: Tue, 24 Jun 2025 10:56:11 -0700 Subject: [PATCH 7/7] Fix code syntax and formats --- docs/code-search/types/deep-search.mdx | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/docs/code-search/types/deep-search.mdx b/docs/code-search/types/deep-search.mdx index 970396ebd..27284461a 100644 --- a/docs/code-search/types/deep-search.mdx +++ b/docs/code-search/types/deep-search.mdx @@ -20,7 +20,7 @@ The answer is formatted in Markdown and can include links to relevant files, dir - Provide reasonably scoped questions. The agent will perform much better if it does not have to read the entire codebase at once. - Check the list of sources. This is extremely useful for debugging and understanding where the answer came from. Ask a follow-up question and mention the missing source if something is missing. -For use cases where you're looking for exhaustive answers (for example, "Find all files with the `.XYZ` file extension in `foo' repo that contain the word `bar`), Code Search still excels, while Deep Search will only utilize a sample of the results. Deep Search will perform a Code Search query as a source, which you can use to continue an exhaustive search within the Code Search product. +For use cases where you're looking for exhaustive answers (for example, "Find all files with the `.XYZ` file extension in `foo' repo that contain the word`bar`), Code Search still excels, while Deep Search will only utilize a sample of the results. Deep Search will perform a Code Search query as a source, which you can use to continue an exhaustive search within the Code Search product. ### Examples of prompts @@ -41,7 +41,7 @@ We do not enforce [repository permissions](/admin/permissions) for viewing share ## Enabling Deep Search If Deep Search is disabled, ask your site administrator to enable the following setting in your site configuration: -"`json +```json "experimentalFeatures": { "deepSearch.enabled": true, }, @@ -52,9 +52,10 @@ For optimal performance, Deep Search is specialized only to use one model. Curre If you are not using [Cody Gateway](/cody/core-concepts/cody-gateway), you must also configure the model through Amazon Bedrock or GCP Vertex. ### Enabling conversation sharing + Conversation sharing is disabled by default. To enable conversation sharing, ask your site administrator to enable the following setting in your site configuration: -"`json +```json "experimentalFeatures": { "deepSearch.enabled": true, "deepSearch.sharing.enabled ": true, @@ -68,7 +69,8 @@ In your site configuration, include the configuration for Claude Sonnet 4 in [mo Examples of Sonnet 4 configuration inside `modelOverrides`: Amazon Bedrock: -"`json + +```json { "modelRef": "aws-bedrock::v1::claude-sonnet-4", "modelName": "us.anthropic.claude-sonnet-4-20250514-v1:0", @@ -87,7 +89,8 @@ Amazon Bedrock: ``` GCP Vertex: -"`json + +```json { "modelRef": "google-anthropic::v2::claude-sonnet-4", "modelName": "claude-sonnet-4@20250514", @@ -108,7 +111,8 @@ GCP Vertex: Then, configure Deep Search to use this model in `experimentalFeatures`: Amazon Bedrock: -"`json + +```json "experimentalFeatures": { "deepSearch.enabled": true, "deepSearch.model": "aws-bedrock::v1::claude-sonnet-4" @@ -116,7 +120,8 @@ Amazon Bedrock: ``` GCP Vertex: -"`json + +```json "experimentalFeatures": { "deepSearch.enabled": true, "deepSearch.model": "google-anthropic::v2::claude-sonnet-4"