Vibe Seed Int Studio Setup

Workflow

1. 프로젝트를 확인하거나 생성

• 목록 조회: GET /api/manage/project
• 생성: POST /api/manage/project
• 수정: PATCH /api/manage/project/<projectId>
• 삭제: DELETE /api/manage/project/<projectId> and require explicit user confirmation first

생성/수정 시 필요한 입력:

API key handling

API 키(openai, anthropic 등)는 이 스킬에서 입력받거나 저장하지 않는다. 프로젝트 생성 후 Studio UI에서 직접 등록하도록 안내한다.

UI 주소는 아래 명령으로 확인한다.

python3 scripts/studio_auth.py print-ui-url --config "_agent_tools/vibe-seed-int/studio-config.json"

2. 사용 가능한 모델과 활성화된 모델을 조회

• 사용 가능 모델: GET /api/manage/settings/available-models
• 프로젝트 활성화 모델: GET /api/manage/configurations/projects/<projectId>/models

활성화 모델 응답의 _id가 이후 프롬프트/에이전트에서 쓰는 configurationId다.

3. 모델을 활성화하거나 비활성화

• 활성화: POST /api/manage/configurations/projects/<projectId>/models
• 비활성화: DELETE /api/manage/configurations/projects/<projectId>/models/<configurationId>

이미 활성화된 모델을 다시 활성화하면 기존 configuration이 갱신될 수 있다. 응답의 _id를 다시 확인한다.

4. 모델 헬스체크를 수행

POST /api/manage/configurations/projects/<projectId>/models/health-check로 상태를 확인하고 결과를 표로 정리한다.

• healthy: 정상
• unhealthy: API 키 또는 모델 설정 문제
• unknown: API 키 미등록 또는 URL 없음

unhealthy/unknown이면 원인과 필요한 사용자 조치를 함께 안내한다.

Completion criteria

아래가 모두 충족되어야 setup 완료로 본다.

• 프로젝트가 존재한다.
• 필요한 모델이 project에 활성화되어 있다.
• 헬스체크 결과가 기대 상태다.
• 사용자에게 Studio UI에서 API 키를 넣어야 하는 모델이 있으면 그 URL과 위치를 전달했다.

Error handling

Reference loading

• 인증이 필요할 때만 references/auth.md를 읽는다.
• UI 로그인/code 교환이 필요할 때 references/auth.md의 manual login section을 읽는다.