SuperAPI AI 工具集

cortex-agents-with-custom-tools-tutorial

智能体与模型

查看项目

更新于 10-16 05:46

技能介绍

用途:这是一套面向 Snowflake Cortex Agents 的高级教学技能,重点讲解自定义工具(custom tools)的构建。教程从基础智能体出发,加入基于存储过程的工具来执行自定义业务逻辑,最终形成一个可跨结构化数据、非结构化文档和自定义过程进行编排的五工具智能体。

主要能力与结构:教程共 8 个部分——环境与前置条件、示例数据、语义视图、Cortex Search、自定义工具存储过程、构建智能体、测试全部工具、以及在 Snowflake Intelligence 中对话使用。智能体工具包括:Analyst(cortex_analyst_text_to_sql,针对语义视图查询结构化数据)、Search(cortex_search,检索文档)、InventoryLookup / PriceCalculator / ProductSummary(generic 类型,指向存储过程)。

使用方式:用 SQL 创建语义视图(TABLES、DIMENSIONS、METRICS 子句,非 YAML);自定义工具必须使用 CREATE PROCEDURE 而非函数,参数加 p_ 前缀、使用 EXECUTE AS CALLER 与 DECLARE/BEGIN/END 块。智能体通过 CREATE AGENT ... FROM SPECIFICATION $$yaml$$ 一次性配置 tools 与 tool_resources。调用时使用 SNOWFLAKE.CORTEX.DATA_AGENT_RUN,并将返回的 JSON 通过 Python json.loads() 解析出 thinking、tool_use、tool_result 和 text 等类型。

限制与注意事项:Analyst 与 generic 工具都必须在 tool_resources 中提供 execution_environment(type: warehouse 与 warehouse 名称),否则会报错 399504;使用裸 warehouse 键会静默失败。语义视图需用 SQL 语法而非 YAML。教程还以表格形式列出常见错误与修复方法。教程未提供具体价格、收费或效果数据。