ドキュメント変更履歴 2026-08-30

--- ahttps://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-analytical-search+++ bhttps://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-analytical-search@@ -4,4 +4,7 @@  - [](/user-guide/snowflake-cortex/cortex-agents-manage)+- [](/user-guide/snowflake-cortex/cortex-agents-rest-api)+- [](/user-guide/snowflake-cortex/snowflake-cowork/build-agents)+- [](/user-guide/snowflake-cortex/cortex-search/cortex-search-agents) - [](/user-guide/snowflake-cortex/cortex-search/cortex-search-overview) - [](/sql-reference/sql/create-cortex-search)@@ -14,4 +17,6 @@ questions requiring comprehensive analysis across hundreds or thousands of documents, including counts, aggregates, and trends. Analytical search addresses this by combining semantic search, AI functions, and SQL into one loop to answer those questions with analytical rigor over unstructured data.+After you enable it on an agent, analytical search is available wherever that agent runs: the Cortex Agents SQL commands, the REST API, and+[%sf-intelligence%](/user-guide/snowflake-cortex/snowflake-cowork).  ## How analytical search works@@ -57,5 +62,6 @@  **Auto-routing** classifies query intent at runtime: simple, single-passage questions stay on the standard RAG path;-corpus-wide analytical questions trigger the analytical search loop. You don't need to specify which mode to use.+corpus-wide analytical questions trigger the analytical search loop. Auto-routing runs only after you enable analytical+search on the agent.  ## Analytical search vs. traditional RAG@@ -105,34 +111,196 @@ rather than summarizing a small sample. +<a id="label-enable-analytical-search"></a>+ ## Set up analytical search -Analytical search triggers implicitly based on query intent. To set up the prerequisites, complete the following steps:+Analytical search is disabled by default (`analytical_search` is `false`). Agents that have a Cortex Search tool continue+to answer search questions using standard retrieval, but they don't run the analytical search loop. Queries that need+corpus-wide counts, aggregates, or trends then return answers based on a small retrieved sample only.++You enable analytical search once on the agent object. The same setting applies when you run the agent with SQL or the+REST API and when users interact with the agent in %sf-intelligence%.++To use analytical search, complete these steps:++1. Create a Cortex Search service, or reuse an existing one.+2. Add that Cortex Search service as a tool on the agent, and enrich the tool resources with column descriptions so the+   agent can filter and extract effectively. For the YAML and REST `columns_and_descriptions` fields, see+   [Connect Cortex Search to an agent](/user-guide/snowflake-cortex/cortex-search/cortex-search-agents#label-cortex-search-connect-agent).+   For the Snowsight **Columns Description** fields, see+   [Configure and interact with Agents](/user-guide/snowflake-cortex/cortex-agents-manage).+   For what to include in each description, see [Add detailed column descriptions](#label-analytical-search-column-descriptions).+3. Enable `analytical_search` on the agent in %sf-web-interface%, with SQL, or with the REST API.  - If you already have a Cortex Search service, you can reuse it; you don't need to create a new service specifically for analytical search. - If your agent already has a Cortex Search tool configured, you don't need to add another one.--1. Create a Cortex Search service:+- `analytical_search` is a field in the agent specification under `orchestration.capabilities`. It isn't a standalone+  ALTER AGENT property.++### Create a Cortex Search service++```sql+CREATE OR REPLACE CORTEX SEARCH SERVICE <database>.<schema>.<name>+  TEXT INDEXES CHUNK, DOC_ID [, <other_text_search_columns>]+  VECTOR INDEXES CHUNK (model = 'snowflake-arctic-embed-l-v2.0') [, <other_vector_search_columns>]+  ATTRIBUTES <filter_column> [, <other_filter_columns>]+  WAREHOUSE = <warehouse_name>+  TARGET_LAG = '1 day'+  AS+    SELECT <columns>+    FROM <chunks_table>;+```++Then create an agent and add the Cortex Search service as a tool. Include column descriptions in the tool resources.+For more information, see [Configure and interact with Agents](/user-guide/snowflake-cortex/cortex-agents-manage)+and [Connect Cortex Search to an agent](/user-guide/snowflake-cortex/cortex-search/cortex-search-agents#label-cortex-search-connect-agent).++For more information on the commands used, see [](/sql-reference/sql/create-cortex-search) and [](/sql-reference/sql/create-agent).++### Enable analytical search on the agent++Set `analytical_search` to `true` on each agent where you want the analytical search loop. Set it to `false` to disable+analytical search. Use any of the following methods. They all update the same agent object, so the agent can use+analytical search from SQL, the REST API, and %sf-intelligence%.++**Method 1: Snowsight UI:**++1. In the navigation menu, select **AI & ML** %raa% **Agents**.+2. Select the agent, then select **Edit**.+3. Select **Tools**.+4. After you add a Cortex Search service, toggle **Analytical Search** on.+5. Select **Save**.++Additional costs apply when the agent uses AI functions. For more information, see [Cost considerations](#label-analytical-search-cost).++**Method 2: REST API:**++To enable analytical search on an existing agent, call the+[Update Agent](/user-guide/snowflake-cortex/cortex-agents-rest-api#label-snowflake-agents-rest-api-update)+endpoint. If the agent already has budget or other orchestration settings, include those fields in the same+`orchestration` object so they aren't removed.++```bash+curl -X PUT "$SNOWFLAKE_ACCOUNT_BASE_URL/api/v2/databases/<database>/schemas/<schema>/agents/<name>" \+  --header 'Content-Type: application/json' \+  --header 'Accept: application/json' \+  --header "Authorization: Bearer $PAT" \+  --data '{+    "orchestration": {+      "capabilities": {+        "analytical_search": true+      }+    }+  }'+```++For a new agent, include the same `orchestration.capabilities` object in the+[Create Agent](/user-guide/snowflake-cortex/cortex-agents-rest-api)+request body, along with a Cortex Search tool:++```json+{+  "name": "my_agent",+  "orchestration": {+    "capabilities": {+      "analytical_search": true+    }+  },+  "tools": [+    {+      "tool_spec": {+        "type": "cortex_search",+        "name": "my_search_tool",+        "description": "Search documents"+      }+    }+  ],+  "tool_resources": {+    "my_search_tool": {+      "search_service": "my_db.my_schema.my_search_svc"+    }+  }+}+```++**Method 3: SQL:**++For an existing agent, retrieve the complete LIVE specification, add or update `orchestration.capabilities`, then apply+the complete updated specification. `ALTER AGENT ... SET SPECIFICATION` replaces the entire specification; fields that+you omit are removed.++1. Run [](/sql-reference/sql/desc-agent) to retrieve the complete LIVE specification.+2. Add or update the following in the specification:++   ```json+   "orchestration": {+     "capabilities": {+       "analytical_search": true+     }+   }+   ```++3. Apply the complete updated specification:     ```sql-   CREATE OR REPLACE CORTEX SEARCH SERVICE <database>.<schema>.<name>-     TEXT INDEXES CHUNK, DOC_ID [, <other_text_search_columns>]-     VECTOR INDEXES CHUNK (model = 'snowflake-arctic-embed-l-v2.0') [, <other_vector_search_columns>]-     ATTRIBUTES <filter_column> [, <other_filter_columns>]-     WAREHOUSE = <warehouse_name>-     TARGET_LAG = '1 day'-     AS-       SELECT <columns>-       FROM <chunks_table>;+   ALTER AGENT <database>.<schema>.<agent>+     MODIFY LIVE VERSION SET SPECIFICATION = $$+     models:+       orchestration: auto++     orchestration:+       capabilities:+         analytical_search: true+       budget:+  ... (truncated) 

差分が長いため、途中まで表示しています。

--- ahttps://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-manage+++ bhttps://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-manage@@ -147,5 +147,5 @@  - **Cortex Search:** Provide the Cortex Search services, along with the filters, the columns and column descriptions for filterable and searchable columns, and the maximum number of results to return.-- **Analytical search:** Enables the agent to run extensive analytics over large document collections, producing lists, counts, aggregates, and trends. Analytical search extends Cortex Search by orchestrating multi-index queries with configurable limits and using AISQL on the full result set. For more information, see [Analytical search](/user-guide/snowflake-cortex/cortex-agents-analytical-search).+- **Analytical search:** Enables the agent to run extensive analytics over large document collections, producing lists, counts, aggregates, and trends. Analytical search extends Cortex Search by orchestrating multi-index queries with configurable limits and using AISQL on the full result set. Analytical search is disabled by default. Enable it on the agent after you add a Cortex Search tool. For more information, see [Analytical search](/user-guide/snowflake-cortex/cortex-agents-analytical-search#label-enable-analytical-search). - **[Code execution](/user-guide/snowflake-cortex/cortex-agents-code-execution-tool):** Enable the built-in tool so the agent can run Python in a secure, isolated sandbox. No additional resources are required. - **Data to Chart:** Enable the tool so the agent can generate visualizations from data returned by other tools. No additional resources are required.@@ -181,5 +181,5 @@     <tr>       <td>Analytical search (Public Preview)</td>-      <td>The %sf-web-interface% tab that follows, as a toggle on a Cortex Search tool. See [](/user-guide/snowflake-cortex/cortex-agents-analytical-search).</td>+      <td>The tabs that follow, in all three methods. See [](/user-guide/snowflake-cortex/cortex-agents-analytical-search#label-enable-analytical-search).</td>     </tr>     <tr>@@ -256,5 +256,5 @@      6. Select **Add**. -   - **To enable analytical search for a Cortex Search service**: After adding a Cortex Search service, toggle **Analytical search** on to allow the agent to run extensive analytics on your search indexes. Additional costs apply when using AI Functions. For more information, see [Analytical search](/user-guide/snowflake-cortex/cortex-agents-analytical-search).+   - **To enable analytical search for a Cortex Search service**: After adding a Cortex Search service, toggle **Analytical Search** on to allow the agent to run extensive analytics on your search indexes. Analytical search is off by default. Additional costs apply when using AI functions. For more information, see [Analytical search](/user-guide/snowflake-cortex/cortex-agents-analytical-search#label-enable-analytical-search).     - **To add a custom tool to the agent**: By adding custom tools, you can extend the functionality of your agents. With custom tools, the agent can call stored procedures and functions that you have defined to perform actions or do computations. This section assumes that you've already created a custom tool. For information about procedures and functions, see [](/developer-guide/extensibility).@@ -389,4 +389,20 @@      - `filterable` (boolean): Set to `true` for attribute columns that can be used in filter conditions. +- **Enable analytical search**: After the agent has a Cortex Search tool, set `orchestration.capabilities.analytical_search` to `true`. Analytical search is disabled by default. If the agent already has budget or other orchestration settings, include those fields in the same `orchestration` object so they aren't removed.++  ```bash+  curl -X PUT "$SNOWFLAKE_ACCOUNT_BASE_URL/api/v2/databases/<database-name>/schemas/<schema-name>/agents/<agent-name>" \+  --header 'Content-Type: application/json' \+  --header 'Accept: application/json' \+  --header "Authorization: Bearer $PAT" \+  --data '{+   "orchestration": {+    "capabilities": {+     "analytical_search": true+    }+   }+  }'+  ```+ - **Add data_to_chart tool**: The following example shows how to add the data to chart tool to an existing agent object.   1. Add the data_to_chart tool@@ -478,4 +494,6 @@    orchestration:+    capabilities:+      analytical_search: true     tool_not_accessible: accept     budget:@@ -615,4 +633,6 @@    orchestration:+    capabilities:+      analytical_search: true     tool_not_accessible: accept     budget:@@ -653,4 +673,9 @@ $$; ```++To enable analytical search, set `orchestration.capabilities.analytical_search` to `true` as shown in the example.+Analytical search is disabled by default. The new specification completely replaces the existing one, so include the+complete LIVE specification from `DESCRIBE AGENT`. For more information, see+[Analytical search](/user-guide/snowflake-cortex/cortex-agents-analytical-search#label-enable-analytical-search).  <a id="label-snowflake-agents-review"></a>