Cortex Agent 요청 모니터링¶

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

Cortex Agent 로그에 수집되는 정보¶

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

스레드와 연결된 대화 기록
다음을 포함한 범위가 있는 에이전트의 실행 추적:
- LLM 계획
- 도구 실행(Cortex Search, Cortex Analyst, 웹 검색)
- LLM 응답 생성
- SQL 실행
- 차트 생성
각 범위와 연결된 입력 및 출력
각 에이전트 응답에 대한 사용자 피드백

Cortex Agent 로그에 액세스¶

Snowsight 에서 Cortex Agent 대화 로그를 보려면 다음을 수행합니다.

Snowsight 에 로그인합니다.
탐색 메뉴에서 AI & ML » Agents 를 선택합니다.
로그를 보려는 에이전트를 선택합니다.
에이전트 뷰의 Monitoring 창으로 이동합니다.

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

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

사용자가 제공한 피드백 보기¶

에이전트에 대한 사용자 피드백을 프로그래밍 방식으로 보려면 다음 SQL 명령을 실행하세요.

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

결과 테이블에는 에이전트, 피드백을 제공한 사용자, 사용자가 제공한 피드백, 피드백이 긍정적인지 또는 부정적인지에 대한 정보가 있는 열이 포함됩니다.

액세스 제어 및 권한¶

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

AGENT 오브젝트에 대한 OWNERSHIP 또는 MONITOR 권한
CORTEX_USER 데이터베이스 역할

다음 예에서는 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 ROLE agent_monitoring_user_role TO USER some_user;

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

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

GRANT MONITOR ON FUTURE AGENTS IN SCHEMA <database_name>.<schema_name> TO ROLE <role_name>;