开始使用 Snowflake Intelligence¶

本主题借助一个创建企业代理的简单示例，提供有关开始使用 Snowflake Intelligence 的信息。此代理可与 Snowflake Intelligence 搭配使用，通过对结构化和非结构化数据进行推理来回答问题。有关更详细的指南，请参阅 Snowflake Intelligence 入门。

先决条件¶

已安装 Git (https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
Snowflake 账户
访问 ACCOUNTADMIN 角色

创建数据库、架构和表，并从 AWS S3 中加载数据¶

要为企业代理创建构建块，您必须创建数据库、架构、表，并从以下位置加载数据：AWS S3。

复制 Snowflake Intelligence 入门 GitHub 存储库 (https://github.com/Snowflake-Labs/sfguide-getting-started-with-snowflake-intelligence/) 到本地计算机：
```
git clone https://github.com/Snowflake-Labs/sfguide-getting-started-with-snowflake-intelligence.git
```
登录 Snowsight。
在导航菜单中，选择 Projects » Workspaces。
选择 + Add new。
选择 SQL File。
输入文件的名称。
打开文件。
将 setup.sql (https://github.com/Snowflake-Labs/sfguide-getting-started-with-snowflake-intelligence/blob/main/setup.sql) 文件的内容复制到工作区。
按顺序运行所有语句。

在工作区中运行以下 SQL 语句：

USE ROLE ACCOUNTADMIN;
CREATE SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT;
GRANT USAGE ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT TO ROLE snowflake_intelligence_admin;
GRANT CREATE SEMANTIC VIEW ON SCHEMA DASH_DB_SI.RETAIL TO ROLE ACCOUNTADMIN;

（可选）运行以下 SQL 语句，启用跨区域推理：
```
ALTER ACCOUNT SET CORTEX_ENABLED_CROSS_REGION = 'ANY_REGION';
```
将 Snowsight 中的用户角色切换为 SNOWFLAKE_INTELLIGENCE_ADMIN。

创建供代理使用的工具¶

创建代理将使用的工具。

创建与 Cortex Analyst 配合使用的语义视图。

在导航菜单中，选择 AI & ML » Cortex Analyst。
依次选择 Create new、Create new Semantic View。
对于存储语义视图的位置，请选择 DASH_DB_SI.RETAIL。
对于名称，请输入 SALES_AND_MARKETING_DATA。
对于描述，请输入 Semantic view for sales and marketing data analysis across campaigns, products, transactions, and social media engagement.。
选择 Next。
选择 Skip。
选择 DASH_DB_SI.RETAIL 架构。
对于表，请选择 MARKETING_CAMPAIGN_METRICS、PRODUCTS、SALES 和 SOCIAL_MEDIA 表。
选择 Next。
对于列，请选择所选表的所有可用列。
选择 Next。
查看并接受所有关系和指标建议。
选择 Save。
等待创建语义视图。

通过创建搜索服务来创建 Cortex 搜索工具。

在导航菜单中，选择 AI & ML » Cortex Search。
选择 Create。
对于 Service database and schema，选择 DASH_DB_SI.RETAIL。
对于 Service name，输入 Support_Cases，然后选择 Next。
在数据源列表中，选择 SUPPORT_CASES 表，然后选择 Next。
在搜索列列表中，选择 TRANSCRIPT，然后选择 Next。
对于属性列，选择 TITLE 和 PRODUCT，然后选择 Next。
对于要包含的列，请选择 Select all，然后选择 Next。
对于仓库，选择 DASH_WH_SI**（如果该仓库不可用，请选择 **COMPUTE_WH)，然后选择 Create。

创建 Cortex Agent¶

要创建将使用这些工具的代理，请执行以下步骤：

在导航菜单中，选择 AI & ML » Agents。
选择 Create agent。
对于架构，请使用 SNOWFLAKE_INTELLIGENCE.AGENTS。
对于代理对象名称，使用 Sales_AI。
对于显示名称，请使用 Sales AI。
选择 Create agent。

将工具添加到代理¶

将 Cortex Analyst 工具添加到代理中。

从代理页面中，选择 Tools 选项卡。
导航到 Cortex Analyst 条目。
依次选择 + Add、Semantic view。
对于数据库和架构，请选择 DASH_DB_SI.RETAIL。
对于语义视图，请选择 SALES_AND_MARKETING_DATA。
对于名称，请使用 SALES_AND_MARKETING_DATA。

对于描述，请使用以下内容：

The Sales and Marketing Data semantic view in DASH_DB_SI.RETAIL schema provides a complete view of retail business performance by connecting marketing campaigns, product information, sales data, and social media engagement. The view enables tracking of marketing campaign effectiveness through clicks and impressions, while linking to actual sales performance across different regions. Social media engagement is monitored through influencer activities and mentions, with all data connected through product categories and IDs. The temporal alignment across tables allows for comprehensive analysis of marketing impact on sales performance and social media engagement over time.

对于仓库，请选择 Custom，然后选择 DASH_WH_SI。
对于查询超时，请使用 60。
选择 Add。

将 Cortex Search 工具添加到代理中。

导航到 Cortex Search Service 条目。
选择 + Add。
对于数据库和架构，请选择 DASH_DB_SI.RETAIL。
对于搜索服务，选择 DASH_DB_SI.RETAIL.Support_Cases。
对于 ID 列，使用 ID。
对于标题列，使用 TITLE。
对于名称，请使用 Support_Cases。
选择 Add。
选择 Orchestration 选项卡。

添加以下编排指令：

Whenever you can answer visually with a chart, always choose to generate a chart even if the user didn't specify to.

选择 Save。

使用 Snowflake Intelligence¶

通过 Snowflake Intelligence 与代理交互。

使用访问代理中描述的方法之一导航到 Snowflake Intelligence。
选择新创建的代理。
输入以下提示词：
- “客户支持工单中最近报告了哪些与夹克相关的问题？”
- “显示 6 月至 8 月期间按产品类别划分的销售趋势。”
- “为什么 7 月份健身服装的销售额增长如此之快？”