콘텐츠로 이동

Sohri Skill Runtime

버전 정보

v0.1.2 · 빌드 2026-08-19 · 소스 /data/mago-services/sohri/sohri-skill-runtime

Sohri Graph Builder와 Sohri Skill Engine 사이의 범용 실행 프록시입니다.

실행 계약

  • Graph Builder: POST /v1/skills/execute
  • Skill Engine: POST /v1/skills/execute
  • skill_id → skill
  • arguments → input
  • kebab-case Skill ID → snake_case Engine ID

Runtime은 Skill별 구현이나 입력·출력 모델을 포함하지 않습니다. Skill 계약과 실제 실행은 Skill Engine이 소유합니다.

빠른 시작

./scripts/install.sh
source .venv/bin/activate
python -m cli.main serve --reload
  • API 문서: http://localhost:59213/skill_runtime/docs
  • 상태 확인: http://localhost:59213/health/live
  • 실행 API: http://localhost:59213/v1/skills/execute

설계 원칙

  • arguments를 해석하거나 변경하지 않습니다.
  • 임의 Skill에 안전하도록 실행 POST를 자동 재시도하거나 캐시하지 않습니다.
  • Engine 오류를 Runtime의 공통 오류 형식으로 변환합니다.
  • Engine 응답의 Skill ID가 요청한 ID와 일치하는지 검증합니다.

개발 명령

python -m cli.main test
python -m cli.main openapi --output docs/openapi.json
python -m cli.main smoke \
  --skill-id sample-skill \
  --arguments '{"query":"example"}'

세부 계약은 API 문서, 운영 방법은 배포 문서를 참고하세요.