시작하기¶

빠른 시작¶

./scripts/install.sh
source .venv/bin/activate
python cli/run.py --reload

기본 주소는 http://localhost:59213입니다.

Swagger UI: http://localhost:59213/skill_runtime/docs
OpenAPI JSON: http://localhost:59213/skill_runtime/openapi.json
Liveness: http://localhost:59213/health/live
Readiness: http://localhost:59213/health/ready
실행 API: http://localhost:59213/v1/skills/execute

환경 설정¶

SKILL_ENVIRONMENT=local
SKILL_HOST=0.0.0.0
SKILL_PORT=59213
SKILL_LOG_LEVEL=info
SKILL_REQUEST_TIMEOUT_SECONDS=8
SKILL_ENGINE_EXECUTE_URL=http://sohri-skill-engine:8000/v1/skills/execute

API 호출¶

curl -X POST http://localhost:59213/v1/skills/execute \
  -H 'Content-Type: application/json' \
  -d '{
    "skill_id": "sample-skill",
    "arguments": {"query": "example"},
    "context": {}
  }'

CLI¶

python -m cli.main serve --reload
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"}'

검증¶

python cli/test.py
ruff check cli skills version.py
helm lint deploy
docker compose config --quiet

Docker¶

docker compose up --build

Helm¶

helm upgrade --install sohri-skill-runtime deploy \
  --namespace mago-prod \
  --create-namespace \
  -f deploy/values-onprem.yaml

운영 배포 방식은 배포 및 운영을 참고하세요.