Langfuse가 분석 정보를 읽고 여러 평가를 한꺼번에 실행하는 외부 연동 수단을 추가했다. 개발자는 조회와 평가 실행을 도구 기반 작업 흐름에 연결할 수 있고, AI 게이트웨이, AI 요청을 중계하는 서비스 사용자는 개선된 설정 안내와 키 관리 화면을 이용할 수 있다.

1. Topics 정보를 읽는 공개 API 추가

10월 24일 공개된 Langfuse 4.70.0에는 Topics 정보를 읽는 공개 API가 추가됐다. 이번 변경의 초점은 읽기 전용 접근이다. 연동 프로그램에서 정보를 가져오는 접점이 생겼다는 점이 개발자에게 중요하다.

Topics를 처음 설정하는 화면도 보완했다. AI 연결이 빠져 있을 때 이를 설명하고, 관리자 권한이 없는 사용자를 돕는 안내를 제공한다. 설정을 진행하는 사람이 연결 상태와 권한 문제를 파악하도록 돕는 변화다.

첫 실행 때는 분석 중, 대기, 실패 상태에 맞는 화면을 보여 준다. 설정 단계의 안내에 이어 실행 상태도 화면에 반영하므로, 처음 사용하는 사람에게 작업이 어느 상태에 있는지 전달하는 데 초점을 맞췄다.

2. 여러 평가를 실행하는 도구와 결과 식별자 제공

배치 평가에는 외부 클라이언트가 기능을 도구로 호출하는 MCP, AI 도구 연결 통신 규약을 따르는 실행 수단이 추가됐다. 도구 이름은 runBatchEvaluation이다. 개발자는 이 도구를 이용해 여러 평가를 실행하는 작업을 클라이언트의 도구 호출 흐름에 넣을 수 있다.

배치 실행 결과에는 batch_action_id도 추가됐다. 실행을 요청하는 도구와 결과에 붙는 식별자, 결과를 구분하는 이름이 함께 들어간 것이다. 이번 변경을 살펴볼 때는 평가를 시작하는 쪽뿐 아니라, 결과를 받는 연동 프로그램이 새 필드를 어떻게 다룰지도 확인할 지점이다.

조회와 실행이 서로 다른 접점으로 추가됐다는 점도 눈에 띈다. 앞의 공개 API가 Topics 정보를 읽는 역할이라면, 평가 도구는 배치 작업을 시작하는 역할이다. 필요한 작업이 정보 조회인지 평가 실행인지에 따라 연동할 기능을 고를 수 있다.

3. 게이트웨이 설정 안내와 키 페이지 정비

AI 게이트웨이에서는 Claude Desktop 설정 안내를 수정하고 Claude 관련 탭을 합쳤다. 초기 설정 절차를 따라가는 사용자가 접하는 안내 구성을 손본 변경이다. 설정 안내 탭과 데이터 불러오기를 분리하는 내부 정리도 함께 이뤄졌다.

게이트웨이 키 페이지에는 키에 대한 설명을 화면 안에 표시한다. 같은 페이지에서 사람을 초대하는 기능도 추가했다. 키 설명을 확인하는 자리에서 팀원 초대를 이어갈 수 있어, 키를 다루는 화면과 협업 시작 동선이 가까워졌다.

설정 예시에는 문법에 따라 색을 달리하는 표시도 적용됐다. 대상은 셸 명령, 사용자가 운영체제에 입력하는 명령과 TOML·JSON 형식의 예시다. 설정 절차를 바꾸는 기능과는 별개로, 사용자가 예시의 구문을 눈으로 구별하며 읽도록 돕는 화면 개선이다.

4. 연동 확대의 이익과 도입 시 확인할 범위

이번 버전의 이익은 조회와 평가 실행을 외부 작업 흐름에 연결할 선택지가 늘었다는 데 있다. 게이트웨이에서는 설정 안내, 키 설명, 팀원 초대가 개선돼 처음 사용을 준비하는 과정에 변화가 생겼다. 자동화 접점 확대와 초기 사용 편의 개선이 함께 담긴 릴리스다.

새 연동을 만드는 쪽은 변경 대응도 준비해야 하며, Topics API는 안정 단계에 이르지 않은 기능으로 표시돼 있다. 릴리스 노트, 배포 변경 사항을 적은 문서는 조회 경로와 요청·응답 규격, 평가 도구의 호출 매개변수, 호출 때 전달하는 값을 제시하지 않으므로 실제 구현에 앞서 세부 사양을 확인할 필요가 있다.

Langfuse 4.70.0의 핵심은 조회와 평가 실행의 연동 접점을 넓히면서, 게이트웨이를 처음 설정하는 사용자의 안내 동선도 함께 다듬은 데 있다.