Sohri Skill Runtime v0.1.2

릴리스 날짜: 2026-08-19

개요

v0.1.2에서는 Sohri Skill Runtime을 Skill별 실행 서비스에서 범용 실행 프록시로 단순화했습니다. Graph Builder의 공통 실행 요청을 변환하여 Sohri Skill Engine의 공통 실행 API로 전달합니다.

주요 변경 사항

범용 Skill 실행

• 공개 API를 POST /v1/skills/execute로 통합했습니다.
• Graph Builder의 skill_id를 Skill Engine의 skill로 변환합니다.
• kebab-case Skill ID를 snake_case로 변환합니다.
• 예: special-days → special_days
• arguments는 변경 없이 Skill Engine의 input으로 전달합니다.
• context는 Graph Builder 호환을 위해 허용하지만 Skill Engine에는 전달하지 않습니다.
• Skill Engine의 result를 Runtime 공통 응답으로 래핑합니다.

구조 단순화

• Skill별 weather.py, special_days.py 구현을 제거했습니다.
• 하드코딩된 Skill Registry와 Skill별 요청·응답 모델을 제거했습니다.
• Skill별 입력 검증과 응답 정규화 책임을 Skill Engine으로 이전했습니다.
• 실행 POST의 중복 부작용을 방지하기 위해 Runtime 캐시와 자동 재시도를 제거했습니다.

API 및 운영

• 다음 Skill별 API를 제거했습니다.
• GET /v1/skills
• POST /v1/weather
• POST /v1/special-days
• Readiness 응답은 Skill Engine 주소 설정 여부를 제공합니다.
• CLI smoke test를 --skill-id와 JSON --arguments 기반으로 변경했습니다.
• 사용하지 않는 Provider 인증키, Secret, 캐시 및 재시도 설정을 제거했습니다.
• OpenAPI, Helm, Docker Compose, Notebook과 사용자 문서를 범용 프록시 구조에 맞게 갱신했습니다.

API 예시

Graph Builder 요청:

{
  "skill_id": "sample-skill",
  "arguments": {
    "query": "example"
  },
  "context": {}
}

Skill Engine 전달 요청:

{
  "skill": "sample_skill",
  "input": {
    "query": "example"
  }
}

호환성 안내

이 릴리스에는 API 제거가 포함되어 있습니다. 기존 Skill별 엔드포인트를 사용하는 클라이언트는 POST /v1/skills/execute 계약으로 전환해야 합니다.

검증

• 전체 테스트 18개 통과
• Ruff 검사 통과
• Helm chart 및 환경별 values 렌더링 검증
• Docker Compose 설정 검증