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 테이블에서 항목을 삭제할 수 있습니다.

View feedback provided by users

To view user feedback about agents programmatically, run the following SQL command:

SELECT * FROM TABLE(SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_EVENTS('<database_name>', '<schema_name>', '<agent_name>', 'CORTEX AGENT')) WHERE RECORD:name='CORTEX_AGENT_FEEDBACK';
Copy

The resulting table contains columns that include information about the agent, the user who provided feedback, feedback provided by the user, and whether the feedback was positive or negative.

액세스 제어 및 권한

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 APPLICATION ROLE SNOWFLAKE.AI_OBSERVABILITY_ADMIN_RL TO ROLE agent_monitoring_user_role;
GRANT ROLE agent_monitoring_user_role TO USER some_user;
Copy

향후 에이전트에 모니터링 액세스 권한 부여

스키마에서 생성된 향후 에이전트에 대해 역할 모니터링 액세스 권한을 부여하려면 다음 SQL 명령을 사용하세요.

GRANT MONITOR ON FUTURE AGENTS IN SCHEMA <database_name>.<schema_name> TO ROLE <role_name>;
Copy
언어: 한국어