API 계약

기본 주소는 http://localhost:59213이며 모든 응답은 JSON입니다.

Skill 실행

POST /v1/skills/execute

요청:

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

skill_id는 소문자 kebab-case 형식입니다. Runtime은 이를 snake_case로 변환하고 arguments를 변경 없이 Skill Engine의 input으로 전달합니다.

응답:

{
  "skill_id": "sample-skill",
  "success": true,
  "result": {
    "answer": "example result"
  },
  "metadata": {
    "provider": "sohri-skill-engine",
    "elapsed_ms": 12
  }
}

result는 Skill Engine이 반환한 값을 그대로 포함합니다.

오류

{
  "success": false,
  "error": {
    "code": "INVALID_ARGUMENT",
    "message": "요청 검증 오류",
    "retryable": false
  }
}

주요 Runtime 오류:

• INVALID_ARGUMENT: Runtime 요청 형식 위반
• UPSTREAM_HTTP_ERROR: Skill Engine HTTP 오류
• UPSTREAM_UNAVAILABLE: Skill Engine 연결 실패
• INVALID_UPSTREAM_RESPONSE: Skill Engine 응답 형식 또는 Skill ID 불일치

Skill Engine이 구조화된 오류를 반환하면 해당 code와 message를 전달합니다.