통사론
newrelic.agent.record_llm_feedback_event(trace_id, rating, category=None, message=None, metadata=None)
AI 플러그인 버전(LLM)에 대한 사용자 정의 피드백 이벤트를 기록합니다.
요구 사항
Python 에이전트 버전 9.8.0 이상.
설명
이 API 뉴렐릭 UI 에서 조회 및 쿼리할 수 있는 피드백 이벤트 LlmFeedbackMessage
를 기록합니다. 피드백 이벤트는 AI가 생성한 메시지와 최종 사용자가 이에 대해 제출한 피드백 사이의 트레이스 ID를 연관시킵니다. 메시지를 피드백과 연관시키려면 AI 메시지를 생성하는 호출 직후에 current_trace_id
에 대한 호출을 통해 활성 프로세서의 트레이스 ID를 얻을 수 있습니다. 나중에 사용자가 피드백을 제공할 때 트레이스 ID를 피드백 호출에 전달합니다.
많은 경우 AI 메시지의 엔드포인트는 피드백 엔드포인트와 다른 위치에 기록됩니다. 이러한 현상은 다른 데스크탑에서 발생할 수 있습니다. 다음 사항이 중요합니다.
- AI 메시지를 생성하는 헤드포인트 내부에 트레이스 ID가 캡쳐되어 있는지 확인하세요.
- 피드백을 기록하는 PointPoint 내부에 해당 트레이스 ID를 전달합니다.
매개변수
매개변수 | 설명 |
---|---|
끈 | 필수의. 피드백 관련 채팅 완료가 발생한 트레이스의 ID입니다. 이 ID는 |
문자열 또는 정수 | 필수의. 최종 사용자가 제공한 평가(예: '좋음/나쁨', '1-10') |
끈 | 선택 과목. 최종 사용자가 제공한 피드백 카테고리(예: "유익함", "부정확함") |
끈 | 선택 과목. 최종 사용자의 자유 형식 텍스트 피드백입니다. |
딕셔너리 | 선택 과목. 피드백 이벤트와 함께 제출할 기타 원하는 데이터를 저장하는 핵심 가치 쌍 세트입니다. |
반환 값
없음.
예
트레이스 ID 획득 및 피드백 기록
피드백 이벤트 기록의 예:
import newrelic.agent
def get_message(request): trace_id = newrelic.agent.current_trace_id()
def post_feedback(request): newrelic.agent.record_llm_feedback_event(trace_id=request.trace_id, rating=request.rating, metadata= {"my_key": "my_val"})```