댓글

댓글 (Comments)

Comments를 사용하면 팀이 Langfuse 내의 trace, observation, session, prompt에 직접 맥락 주석과 토론을 추가할 수 있어요. 이 기능은 협업을 돕기 위해 팀원들이 특정 trace의 문제·이상 징후를 표시하거나, 특정 모델 출력에 대한 인사이트를 공유하거나, 엣지 케이스와 디버깅 노트를 문서화하거나, 프롬프트 개선을 조율하거나, 개발·리뷰 사이클에서 피드백을 남길 수 있게 해줘요.

출처: 문서

본문

Comments를 사용하면 팀이 Langfuse 내의 trace, observation, session, prompt에 직접 맥락 주석과 토론을 추가할 수 있어요. 팀원들이 다음을 할 수 있게 해서 협업을 돕는 기능이에요:

  • 특정 trace에서 문제나 이상 징후 표시
  • 특정 모델 출력에 대한 인사이트 공유
  • 엣지 케이스와 디버깅 노트 문서화
  • 프롬프트 개선 조율
  • 개발·리뷰 사이클 중 피드백 남기기

Comments with @mentions and reactions

지원되는 객체 유형 (Supported Object Types)

댓글은 다음 Langfuse 객체에 추가할 수 있어요:

  • Traces — 완전한 실행 흐름에 댓글
  • Observations — 특정 LLM 호출, 도구 호출, 기타 단계에 메모 추가
  • Sessions — 사용자 상호작용 패턴 토론
  • Prompts — 프롬프트 버전·개선 협업

댓글 추가 (Adding Comments)

각 지원 객체 페이지는 인터페이스에 댓글 버튼을 표시해요. 버튼은 다음을 보여줘요:

  • 현재 댓글 수 (가독성을 위해 "99+"로 상한)
  • 읽기 권한이 없으면 비활성화 상태
  • 댓글이 가능하거나 만들 수 있을 때 활성 상태

댓글 버튼을 클릭하면 사이드 드로어가 열리고 다음을 포함해요:

  1. 댓글 스레드 — 모든 기존 댓글이 시간순으로 표시
  2. 작성기(Composer) — 새 댓글 작성용 텍스트 영역 (쓰기 권한이 있을 때)
  3. Markdown — 기본 마크다운 포맷 지원
  4. @멘션(@Mentions) — @멘션으로 댓글에 팀원 태그
  5. 반응(Reactions) — 댓글에 이모지 반응 추가

댓글 작성자는 자신의 댓글만 삭제할 수 있어요. 프로젝트 관리자도 UI를 통해 다른 사용자의 댓글을 삭제할 수 없어요.

GET /api/public/comments
GET /api/public/comments/{commentId}
POST /api/public/comments

Comments API는 댓글을 만들고 검색하는 프로그래밍 방식 접근을 제공해요. 모든 엔드포인트는 표준 Langfuse API 패턴을 따릅니다.

@멘션 (@Mentions)

중요한 발견이나 토론에 대해 팀원을 알리기 위해 @멘션으로 댓글에 팀원을 태그할 수 있어요. 특정 trace, observation, 문제에 누군가의 주의가 필요할 때 특히 유용해요.

@멘션 사용 방법 (How to Use @Mentions)

  1. 댓글 작성기에서 @ 입력을 시작하세요.
  2. 모든 프로젝트 멤버를 보여주는 자동완성 메뉴가 나타나요.
  3. 목록에서 팀원을 선택하거나 계속 입력해 필터링하세요.
  4. 멘션은 클릭 가능한 배지로 댓글에 삽입돼요.

이메일 알림 (Email Notifications)

댓글에서 누군가를 멘션하면:

  • 댓글 내용과 맥락과 함께 이메일 알림을 받아요.
  • 이메일에는 객체(trace, observation, session, prompt)로 가는 직접 링크가 포함돼요.
  • 사용자는 프로젝트별로 알림 기본 설정을 관리할 수 있어요.

알림 기본 설정 관리 (Managing Notification Preferences)

팀원은 멘션에 대한 이메일 알림을 언제 받을지 제어할 수 있어요:

  • 프로젝트 설정으로 이동해 알림 기본 설정을 구성하세요.
  • 프로젝트별로 멘션 알림을 켜거나 끌 수 있어요.
  • 기본 설정은 그 프로젝트의 모든 향후 멘션에 적용돼요.

댓글에서는 프로젝트 멤버만 멘션할 수 있어요. 자동완성 메뉴는 현재 프로젝트에 접근 권한이 있는 사용자만 보여주도록 자동 필터링해요.

반응 (Reactions)

전체 응답을 쓰지 않고 빠른 확인을 위해 댓글에 이모지 반응을 추가하세요. 반응은 동의, 감사, 또는 댓글을 봤다는 인정을 보여주는 가벼운 방법이에요.

반응 추가 방법 (How to Add Reactions)

  • 아무 댓글이나 호버하면 반응 버튼이 나타나요.
  • 클릭해 반응 피커에서 이모지를 선택하세요.
  • 반응은 이름과 함께 댓글 옆에 나타나요.
  • 기존 반응을 다시 클릭하면 제거돼요.

반응은 댓글 스레드를 집중적으로 유지하면서도 팀원이 빠른 피드백을 주고 토론에 참여를 보여줄 수 있게 해줘요.

특정 텍스트에 댓글 달기 (Commenting on Specific Text)

Google Docs처럼 trace·observation의 입력·출력·메타데이터 필드의 특정 텍스트에 고정된 댓글을 추가할 수도 있어요.

  1. trace 또는 observation의 "JSON Beta" 뷰를 사용하세요.
  2. 댓글을 달 텍스트를 선택하세요.
  3. 나타나는 댓글 버튼을 클릭하세요.
  4. 댓글은 그 정확한 선택에 고정되어 호버 시 표시돼요.

이렇게 하면 LLM 응답의 특정 부분을 논의하거나 팀원과 정확한 문제를 표시하기가 더 쉬워져요.

참고: 댓글이 만들어진 후 trace·observation 데이터가 업데이트되면, 댓글은 참조가 변경됐을 수 있다는 시각적 표시와 함께 "분리(detached)"됩니다.

더 알아보기 (Learn more)