故障排除¶

常见问题和解决方案¶

回答不一致

回答不一致最常见的原因是提示词缺乏针对性。要为回答指定特定样式或格式，请在提示词中明确指定。

虽然 LLMs 本质上存在一些差异，在更改代理配置后也可能会出现不一致的答案。要解决此问题，请检查代理配置、语义视图配置、聊天历史记录或模型选择的最新更改。

如果您使用的是语义模型，则应转换为语义视图。语义视图允许在创建过程中进行验证，以帮助避免使用语义模型时不太明显的不一致。

流式传输响应问题

如果您在一台机器上看到流式传输响应，但在另一台机器上看不到，则可能是由于您的组织 IT 配置（例如网络 DPI、扫描工具、端点安全软件或浏览器扩展）导致的。请与您的内部 IT 人员合作解决这些问题。

错误 370001

此错误表明 Snowflake Intelligence 生成了一个不安全的 SQL 命令。Snowflake Intelligence 不会执行这些命令，而是会返回此错误。

未填充分析工具的 Execution_environment

当配置工具以运行针对用户的默认仓库的 SQL 查询，并且用户没有设置仓库时，会发生这种情况。要解决此问题，请为用户设置默认仓库，或将工具配置为针对特定的自定义仓库执行。有关默认仓库的更多信息，请参阅 会话中的仓库使用情况。

“Table / search service / stage does not exist”错误

如果遇到 table / search service / stage does not exist 错误，则可能表明存在权限问题。验证以下权限设置是否正确：

• 对于每个语义模型：

  • 用户的默认角色会获授语义模型暂存区或视图以及表的数据库和架构的 USAGE。

  • 如果使用语义模型，用户的默认角色会获授存储语义模型文件的暂存区的 READ。

  • 如果使用语义视图，则用户的默认角色会获授语义视图的 REFERENCES。

  • 用户的默认角色会获授在语义模型或视图中定义的每个表的 SELECT。

• 对于每项 Cortex Search Service：

  • 用户的默认角色会获授 Cortex Search Service 的数据库和架构的 USAGE。

  • 用户会获授 Cortex Search Service 的 USAGE。

上下文和内存限制

Cortex Agent 使用有限的上下文窗口，因此很长的对话将丢失更早的上下文。对于持续的上下文，请使用代理配置中的自定义指令。

性能优化¶

响应时间问题

响应延迟可能会有所不同，因为 Snowflake Intelligence 使用 LLMs 和查询来执行一系列复杂的推理、检索和分析任务。性能可能会受到 Snowflake 仓库负载和 LLM 服务本身的影响。请求通常需要超过一分钟才能完成。为了获得更好的性能，请确保 跨区域推理 已启用，在 模型选择 中使用“自动”模型，并考虑添加其他已验证的查询。有关已验证查询的更多信息，请参阅 Cortex Analyst 验证查询存储库。

超时问题

首先，检查所有报告事件的 Snowflake 状态页面 (https://status.snowflake.com/)。如果 Snowflake Intelligence 在云区域中运行，且 GPU 计算资源有限，则您的请求也有可能超时。我们建议启用 跨区域推理 以避免单个区域内的限制。

并行请求

您可以请求代理并行运行工具调用，例如 Cortex Analyst 和 Cortex Search。将以下内容添加到代理编排说明 Configure and interact with Agents 中：

CopyExpand

OVERALL: parallelize as many tool calls as possible for latency purposes.

Show lessSee more

Scroll to top

有关编排指令的信息，请参阅 Specify orchestration。

模型选择

创建代理时，可以直接指定代理应使用的模型。您不能直接为 Cortex Search 或 Cortex Analyst 工具指定模型。作为替代，您可以使用基于角色的访问控制 (RBAC) 来限制这些工具可以使用的模型。有关更多信息，请参阅 基于角色的访问控制 (RBAC)。

多次调用同一工具

当生成的查询较大时，它们有时会触发大小限制，从而导致重试。Cortex Analyst 对查询的令牌生成数限制为 2048 个，这可能会触发大小限制。许多自定义代理响应指令也可能触发大小限制。

仓库规模

Snowflake Intelligence 制定了一系列基于 LLM 的决策，根据需要创建最佳应答并调用工具。您不能通过更大的仓库分配来影响这些决策的性能。

但是，当将 Cortex Analyst 工具作为 Snowflake Intelligence 请求的一部分运行时，该请求将转换为使用仓库运行的 SQL 查询。如果您的仓库太小或过载，则会对性能产生负面影响。

改进编排说明和工具描述

要解决工具和编排方面的问题，请向 LLM 提供提示，其中包含对问题及期望结果的说明，以及现有的描述或说明。LLM 有助于自动创建新提示词。

经过验证的查询

为确保常见或复杂查询的结果可预测，可以将经过验证的查询添加到语义视图中。这可确保代理为这些请求使用优化且可预测的查询路径。

确定延迟瓶颈

要诊断缓慢的代理响应，您可以使用 Snowsight 中的代理监控选项卡来识别延迟瓶颈。这些跟踪结果显示了代理使用的逻辑路径以及每个步骤持续的时间。有关代理监控的更多信息，请参阅 监控 Cortex Agent 请求。

获得支持¶

要获得对 Snowflake Intelligence 的支持，您可以使用 Snowsight 中的支持页面。您还可以访问 Snowflake 论坛 (https://snowflake.discourse.group/c/ai-agents-snowflake-intelligence/103) 以获得更多帮助。