Langfuse 에이전트 스킬(Agent Skill)

Langfuse 에이전트 스킬(Agent Skill)

Langfuse 에이전트 스킬은 AI 코딩 에이전트가 Langfuse를 효과적으로 사용하도록 돕는 도구입니다. 이 문서는 스킬이 무엇인지, 왜 유용한지, 그리고 설치하는 방법을 설명해요. 개방형 Agent Skills 표준을 따르며 Claude Code, Cursor, Windsurf 등 호환 에이전트에서 동작합니다.

출처: 문서

본문

Langfuse 에이전트 스킬은 AI 코딩 에이전트가 Langfuse를 효과적으로 사용하도록 돕습니다. 개방된 Agent Skills 표준을 따르며 Claude Code, Cursor, Windsurf 및 기타 호환 에이전트에서 동작합니다. 스킬은 GitHub 에서 오픈소스로 제공됩니다.

왜 사용하나요?

코딩 에이전트는 스킬이 설치되면 모범 사례를 따르도록 조건화되기 때문에 결과가 훨씬 더 좋아집니다. 스킬에 접근할 수 있는 코딩 에이전트는 Langfuse의 지식을 바탕으로 "좋은 것"이 무엇인지에 대한 명확한 관점(opinionated view)을 갖게 됩니다.

스킬은 SKILL.md 엔트리포인트를 가진 자체 포함 폴더로, 문서 사용에 대한 일반 규칙과 지침, 그리고 특정 워크플로우에 대한 참조 문서가 담겨 있습니다:

SKILL.md
cli.md
instrumentation.md
prompt-migration.md
...

스킬은 점진적 공개(progressive disclosure) 모델을 사용합니다. 프론트매터는 항상 에이전트 컨텍스트에 로드되어 스킬이 언제 관련 있는지 알게 하지만, 전체 지침과 참조 문서는 요청 시에만 로드됩니다. 이렇게 하면 컨텍스트 사용량을 낮게 유지하면서 에이전트에 특화된 지식을 제공할 수 있습니다.

설치

Langfuse Agent Skill 을 설치하면 코딩 에이전트가 모든 Langfuse 기능에 접근할 수 있습니다.

코딩 에이전트에게 GitHub 저장소 를 가리켜 스킬을 설치하도록 요청하세요.

에이전트 지시문:

"Install the Langfuse Agent Skill from github.com/langfuse/skills."

Langfuse에는 스킬을 자동으로 포함하는 Cursor Plugin 이 있습니다. Cursor에서 플러그인 설치

npm(skills CLI)로 설치:

npx skills add langfuse/skills --skill "langfuse"

특정 에이전트를 직접 대상으로 하려면:

npx skills add langfuse/skills --skill "langfuse" --agent "<agent-id>"

또는 스킬을 수동으로 클론할 수도 있습니다:

  • 저장소를 안정적인 위치에 클론
git clone https://github.com/langfuse/skills.git /path/to/langfuse-skills
  • 에이전트의 skills 디렉토리가 존재하는지 확인
mkdir -p /path/to/<agent-skill-root>/skills
  • 스킬 폴더를 심링크
ln -s /path/to/langfuse-skills/skills/langfuse /path/to/<agent-skill-root>/skills/langfuse

설치가 끝나면 원하는 작업을 에이전트에 지시할 수 있습니다. 몇 가지 예시:

  • 점수가 0.5 미만인 최근 10개 trace 보여줘
  • "edge-cases"라는 데이터셋을 만들고 여기에 이 3개 아이템을 추가해 줘
  • src/agent.ts의 시스템 프롬프트를 Langfuse 프롬프트 관리로 마이그레이션해 줘

리소스(Resources)

더 알아보기 (Learn more)