문서 목차
System One 시작하기, 프리미티브, SDK, API 레퍼런스, 모델 문서를 둘러보세요.
System One은 구조화된 모델 판단을 애플리케이션 워크플로 안으로 가져옵니다. 평가할 컨텍스트와 명시적인 질문을 보내고, 반환된 선택·점수·확률을 사용해 코드의 라우팅, 순위 매기기, 조건 확인에 사용하세요.
답변 준비
Q: System One 문서 목차는 어디에 있나요?
A: 시작하기, 프리미티브, TypeScript SDK, Clairic 추출, System One API 레퍼런스, 과금, 개인정보 페이지를 모아 둡니다.
두 제품, 하나의 의사결정 인터페이스
- **System One SDK**는 질문을 정의하고, 서비스를 연결하고, 타입이 있는 결과를 다루는 오픈소스 TypeScript 툴킷입니다. 이 호스팅 API 없이 독립적으로 사용할 수 있습니다. 직접 연결하면 선택한 서비스의 자격 증명, 모델, 과금이 사용됩니다.
- **System One API**는 API 키, 모델 탐색, Playground, 요청 기록, 선불 크레딧을 제공하는 호스팅 HTTP 서비스입니다.
- 두 가지를 함께 사용하려면 플랫폼 엔드포인트와 키로 SDK를 System One API에 연결하세요.
SDK의 어댑터 목록은 호스팅 API의 모델 목록이 아닙니다. 현재 제공되는 모델, 정확한 ID, 기능, 한도, 크레딧 가격은 모델 디렉터리에서 확인하세요. 선택 목록은 늘고 바뀔 수 있으므로 모델 선택이 비교 방법을 설명합니다.
세 가지 의사결정 프리미티브
| 프리미티브 | 용도 | 결과 해석 |
|---|---|---|
| Choice | 정해진 집합에서 도구, 카테고리, 처리 경로 선택 | 선택된 옵션, 확률 분포, confidence |
| Score | 순서가 있는 단계로 관련성, 긴급도, 품질 평가 | 확률 가중 점수, 분포, confidence |
| Noul | 의도나 조건 충족 여부 확인 | P(true), 0부터 1 사이의 수 |
한 요청 안에서 세 유형을 섞을 수 있습니다. 각 질문은 같은 state를 기준으로 독립적으로 평가됩니다. 뒤의 질문이 앞의 답을 필요로 한다면 그 답을 다음 요청에 포함하세요. SDK는 Noul을 booleanQuestion()과 probability 결과로 표현하고, 네이티브 HTTP API는 type: "noul"과 noul을 사용합니다. 빌더, 예시, 결과 의미는 의사결정 프리미티브를 보세요.
통합 전에 먼저 실행해 보기
Playground에 로그인해 모델을 고르고 예시를 불러온 뒤, 질문과 예상 크레딧을 확인하고 실행하세요. 브라우저 흐름에는 설치나 API 키가 필요하지 않습니다. 평가는 계정 잔액을 사용합니다. 콘솔에서 답과 요청 활동을 확인하세요.
이미지 의사결정에는 이미지를 지원하는 Clef, Clef Flash, Clef Omni 항목을 고르고 로컬 PNG/JPEG/WebP 파일을 추가한 뒤, 순서와 갱신된 예상치를 확인하고 불필요한 파일을 제거하세요. 모델의 이미지 및 전체 요청 한도가 적용됩니다. Jev는 텍스트 전용입니다. 이미지가 포함된 의사결정 요청은 HTTP/curl 안내를 사용합니다. 텍스트나 이미지에서 Clairic 추출을 하려면 SDK extract()를 사용하세요. 모델 기능, Fetch 이미지 예제, 데이터 처리를 참고하세요.
워크플로와 그 실행에 대한 책임은 코드에 남습니다. 높은 확률은 정확성 보증이 아니라 도구 실행 권한이 아닙니다. 대표 사례를 테스트하고, 애매하거나 중요한 결정은 검토로 남기고, 공유 권한이 있는 정보만 제출하세요.
통합 가이드
| 가이드 | 수행할 일 |
|---|---|
| SDK 문서 | 툴킷을 설치하고 어댑터를 고르고 타입이 있는 결과를 다룹니다. |
| Clairic 추출 | 공개 모델 이름 clairic으로 extract({ state, fields })를 호출합니다. |
| 호스팅 SDK 퀵스타트 | 엔드포인트와 키를 설정하고 세 가지 질문 유형을 모두 보냅니다. |
| API 레퍼런스 | 요청을 인증하고 모델을 찾고 평가·계정 엔드포인트를 사용합니다. |
| 모델 선택 | 현재 모델, 지원 입력, 한도, 가격을 비교합니다. |
| 에이전트 통합 | 적합한 작업을 고르고 실행·권한·복구 경로를 통제합니다. |
| 코딩 에이전트용 System One | 에이전트 스킬을 설치하고 분류·도구 라우팅·완료 검사 프롬프트를 붙여넣습니다. |
| API 버전 | HTTP, SDK, 모델 버전을 따로 관리합니다. |
| 멱등성과 재시도 | 완료된 평가를 반복하지 않고 응답을 복구합니다. |
| 크레딧과 과금 | 호스팅 API 비용을 추정하고 크레딧 구매를 확인합니다. |
| 데이터와 개인정보 | 제출한 내용, 요청 기록, 보존 기간을 이해합니다. |
다음 문서도 함께 보세요: API 레퍼런스, SDK 문서, 의사결정 프리미티브, 에이전트 통합.