Cortex Agent 요청 모니터링

Cortex Agent는 감사 및 디버깅 목적으로 모든 대화의 자세한 추적 정보를 기록합니다. 모니터링을 사용하면 Snowflake Intelligence 또는 에이전트 API를 통해 배포된 에이전트의 대화 기록에 액세스할 수 있습니다. 대화 기록 외에도 에이전트의 계획 프로세스, 도구 선택, 실행 결과, 최종 응답 생성에 대한 자세한 추적 정보를 검토할 수 있습니다.

Cortex Agent 로그에 수집되는 정보

Cortex Agent 로그에는 다음 정보가 포함됩니다.

  • 스레드와 연결된 대화 기록

  • 다음을 포함한 범위가 있는 에이전트의 실행 추적:

    • LLM 계획

    • 도구 실행(Cortex Search, Cortex Analyst, 웹 검색)

    • LLM 응답 생성

    • SQL 실행

    • 차트 생성

  • 각 범위와 연결된 입력 및 출력

  • 각 에이전트 응답에 대한 사용자 피드백

Cortex Agent 로그에 액세스

|sf-web-interface|에서 Cortex Agent 대화 로그를 보려면 다음을 수행합니다.

  1. Snowsight 에 로그인합니다.

  2. 탐색 메뉴에서 AI & ML » Agents 를 선택합니다.

  3. 로그를 보려는 에이전트를 선택합니다.

  4. 에이전트 뷰의 Monitoring 창으로 이동합니다.

에이전트와 관련된 모니터링 로그는 :doc:`이벤트 테이블</developer-guide/logging-tracing/event-table-setting-up>`SNOWFLAKE.LOCAL.AI_OBSERVABILITY_EVENTS에 저장됩니다. 이 테이블의 항목은 수정할 수 없습니다.

AI_OBSERVABILITY_ADMIN 애플리케이션 역할이 있는 관리자는 SNOWFLAKE.LOCAL.AI_OBSERVABILITY_EVENTS 테이블에서 항목을 삭제할 수 있습니다.

액세스 제어 및 권한

Cortex Agent 로그를 보려면 사용자에게 다음 권한이 있어야 합니다.

  • AGENT 오브젝트에 대한 OWNERSHIP 또는 MONITOR 권한

  • CORTEX_USER 데이터베이스 역할

  • AI_OBSERVABILITY_EVENTS_LOOKUP 애플리케이션 역할

다음 예에서는 ACCOUNTADMIN 역할을 사용하여 Cortex Agent 로그를 보기 위한 필수 권한이 있는 새 역할 ``agent_monitoring_user_role``을 만듭니다. 그런 다음, 이 새 역할을 ``some_user``에 할당합니다.

USE ROLE ACCOUNTADMIN;
CREATE ROLE agent_monitoring_user_role;
GRANT MONITOR ON AGENT my_agent TO ROLE agent_monitoring_user_role;
GRANT DATABASE ROLE SNOWFLAKE.CORTEX_USER TO ROLE agent_monitoring_user_role;
GRANT APPLICATION ROLE SNOWFLAKE.AI_OBSERVABILITY_EVENTS_LOOKUP TO ROLE agent_monitoring_user_role;
GRANT ROLE agent_monitoring_user_role TO USER some_user;
Copy