문제 해결하기¶

일반적인 문제 및 해결 방법¶

일관되지 않은 응답

일관되지 않은 응답은 프롬프트가 구체적이지 않기 때문에 가장 흔히 발생합니다. 응답에 대한 특정 스타일이나 형식을 원하는 경우 프롬프트에 명확하게 지정합니다.

LLMs는 본질적으로 약간의 차이가 있으므로, 에이전트 구성이 변경된 후에도 일관되지 않은 답변이 발생할 수 있습니다. 이 문제를 해결하려면 에이전트 구성, 의미 체계 뷰 구성, 채팅 기록 또는 모델 선택에 대한 최근 변경 사항이 있는지 확인합니다.

의미 체계 모델을 사용하는 경우 의미 체계 뷰로 전환해야 합니다. 의미 체계 뷰를 사용하면 생성 중에 유효성 검사를 수행하여 의미 체계 모델을 사용할 때 명확하지 않은 불일치를 방지하는 데 도움이 됩니다.

스트리밍 응답 문제

한 컴퓨터에는 스트리밍 응답이 표시되지만 다른 컴퓨터에는 표시되지 않는 경우 조직의 IT 구성(예: 네트워크 DPI, 스캔 도구, 엔드포인트 보안 소프트웨어 또는 브라우저 확장 프로그램) 문제일 가능성이 높습니다. 내부 IT 팀에 문의하여 문제를 해결합니다.

오류 370001

이 오류는 Snowflake Intelligence 가 안전하지 않은 SQL 명령을 생성했음을 나타냅니다. Snowflake Intelligence 는 이러한 명령을 실행하지 않고 대신 이 오류를 반환합니다.

분석 도구에 대한 실행_환경이 채워지지 않음

이는 도구가 사용자의 기본 웨어하우스에 대해 SQL 쿼리를 실행하도록 구성되었지만 사용자에게 웨어하우스 세트가 없는 경우에 발생합니다. 이 문제를 해결하려면 사용자의 기본 웨어하우스를 설정하거나 특정 사용자 지정 웨어하우스에 대해 실행되도록 도구를 구성합니다. 기본 웨어하우스에 대한 자세한 내용은 세션에서 웨어하우스 사용 섹션을 참조하세요.

“테이블/검색 서비스/스테이지가 존재하지 않음” 오류

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 서비스 자체의 영향을 받을 수 있습니다. 요청을 완료하는 데 1분 이상 걸리는 경우가 많습니다. 성능을 개선하기 위해 label_snowflake_intelligence_build_cross-region`이 활성화된 경우 :ref:`label_snowflake_intelligence_build_model`에서 “자동” 모델을 사용하고 검증된 쿼리를 더 추가하는 것이 좋습니다. 검증된 쿼리에 대한 자세한 내용은 :doc:/user-guide/snowflake-cortex/cortex-analyst/verified-query-repository` 섹션을 참조하세요.

시간 제한 문제

먼저, Snowflake 상태 페이지 <https://status.snowflake.com/>`_에서 보고된 모든 인시던트에 대해 확인합니다. |sf-intelligence| 가 GPU 컴퓨팅 리소스가 제한된 클라우드 리전에서 실행 중인 경우 요청 시간이 초과될 수도 있습니다 단일 리전 내에서의 제한을 피하기 위해 :doc:/user-guide/snowflake-cortex/cross-region-inference`을 활성화하는 것이 좋습니다.

병렬 요청

에이전트가 Cortex Analyst 및 Cortex Search와 같은 도구 호출을 병렬로 실행하도록 요청할 수 있습니다. 에이전트 오케스트레이션 지침 :doc:`/user-guide/snowflake-cortex/cortex-agents-manage`에 다음을 추가합니다.

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

Copy

오케스트레이션 지침에 대한 자세한 내용은 오케스트레이션 지정 섹션을 참조하세요.

모델 선택

에이전트를 생성할 때 에이전트가 사용해야 하는 모델을 직접 지정할 수 있습니다. Cortex Search 또는 Cortex Analyst 도구의 모델은 직접 지정할 수 없습니다. 대신, 역할 기반 액세스 제어(RBAC)를 사용하여 이러한 도구가 사용할 수 있는 모델을 제한합니다. 자세한 내용은 역할 기반 액세스 제어(RBAC) 섹션을 참조하십시오.

동일한 도구에 대한 여러 호출

생성된 쿼리가 큰 경우 크기 제한이 트리거되어 재시도가 발생하는 경우가 있습니다. Cortex Analyst는 쿼리에 대한 토큰 생성이 2048개로 제한되어, 이로 인해 크기 제한이 트리거될 수 있습니다. 많은 사용자 지정 에이전트 응답 지침으로 크기 제한이 트리거될 수도 있습니다.

웨어하우스 크기

Snowflake Intelligence는 일련의 LLM 기반 의사 결정을 통해 필요에 따라 최적의 답변 및 호출 도구를 생성합니다. 웨어하우스 할당을 늘려도 이러한 결정의 성능에 영향을 줄 수 없습니다.

그러나 Snowflake Intelligence 요청의 일부로 Cortex Analyst 도구를 실행할 때 요청은 웨어하우스를 사용하여 실행되는 SQL 쿼리로 변환됩니다. 웨어하우스가 너무 작거나 과부하되면 성능에 부정적인 영향을 미칩니다.

오케스트레이션 지침 및 도구 설명 개선

도구 및 오케스트레이션 관련 문제를 해결하려면 문제에 대한 설명과 원하는 결과 및 기존 설명 또는 지침을 포함하여 LLM에 요청합니다. LLM은 새 프롬프트 생성을 자동화하는 데 도움이 될 수 있습니다.

검증된 쿼리 사용

일반적이거나 복잡한 쿼리에 대해 예측 가능한 결과를 보장하려면 검증된 쿼리를 의미 체계 뷰에 추가합니다. 이를 통해 에이전트는 해당 요청에 대해 최적화되고 예측 가능한 쿼리 경로를 사용합니다.

대기 시간 병목 현상 식별

느린 에이전트 응답을 진단하려면 Snowsight의 에이전트 모니터링 탭을 사용하여 대기 시간 병목 현상을 식별하면 됩니다. 이러한 추적을 통해 에이전트가 이동한 논리적 경로와 각 단계가 지속된 시간을 확인할 수 있습니다. 에이전트 모니터링에 대한 자세한 내용은 Cortex Agent 요청 모니터링 섹션을 참조하세요.

지원 받기¶

Snowflake Intelligence 에 대한 지원을 받으려면 :doc:`Snowsight의 지원 페이지 </user-guide/ui-support>`를 사용하면 됩니다. `Snowflake 포럼 <https://snowflake.discourse.group/c/ai-agents-snowflake-intelligence/103>`_에 액세스하여 더 많은 지원을 받을 수도 있습니다.