---
title: "System One 의사결정 SDK 타입 있는 결정."
description: "System One 의사결정 SDK로 evaluate() 한 번에 구조화 결정을 추가하세요. 선택·채점 기준·예/아니오 질문을 정의하고, 타입 있는 답을 애플리케이션에서 사용합니다."
canonical: "https://system-one.dev/ko/sdk"
language: "ko"
---

# System One 의사결정 SDK 타입 있는 결정.

System One 의사결정 SDK로 evaluate() 한 번에 구조화 결정을 추가하세요. 선택·채점 기준·예/아니오 질문을 정의하고, 타입 있는 답을 애플리케이션에서 사용합니다.

오픈소스 · TypeScript · Node.js

## SDK 설치

```sh
npm install @system-one-ai/core@0.8.0 @system-one-ai/adapter-system-one@0.7.0 @system-one-ai/transport-fetch@0.8.0
```
## 모델 서비스 연결

core, 서비스 어댑터, transport를 설치하세요. System One API용으로 systemOneAdapter와 createFetchTransport()를 구성하고, 자격 증명은 서버 환경에 둡니다.

```ts
import { createSystemOne, choice } from '@system-one-ai/core';
import { systemOneAdapter } from '@system-one-ai/adapter-system-one';
import { createFetchTransport } from '@system-one-ai/transport-fetch';

const client = createSystemOne({
  adapter: systemOneAdapter,
  transport: createFetchTransport(),
  baseURL: process.env.SYSTEM_ONE_BASE_URL!,
  apiKey: process.env.SYSTEM_ONE_API_KEY!,
  maxRetries: 0,
});

const result = await client.evaluate({
  state: { message: 'I was charged twice.' },
  questions: {
    team: choice('Who should handle this?', {
      billing: 'Payments and refunds',
      support: 'Technical issues',
    }),
  },
});

result.answers.team.choice; // 'billing' | 'support'
```
## 구조화된 결정을 위한 하나의 인터페이스

### 질문부터 답까지 타입

Choice 결과는 선택지 이름을 TypeScript 리터럴 타입으로 유지합니다. Score와 예/아니오 확률은 숫자로 반환됩니다.

### 프로바이더 연결

System One API를 직접 사용하세요. 선택적 Vercel AI SDK 어댑터로 다른 지원 모델 서비스에 연결할 수 있습니다.

### 요청 동작 제어

타임아웃·재시도를 설정하고 AbortSignal로 취소하며, 타입 있는 오류를 애플리케이션에서 처리하세요.

## System One API에 연결

System One API 키로 호스팅 서비스를 호출하세요. Playground에서 입력을 시험하고 콘솔에서 요청 사용량을 확인합니다.

[SDK를 호스팅 API에 연결](https://docs.system-one.dev/ko/docs/getting-started)

## Start here

- [Developer documentation](https://docs.system-one.dev/ko)
- [Versioning and deprecation](https://docs.system-one.dev/ko/docs/api/versioning)
- [멱등성과 재시도](https://docs.system-one.dev/ko/docs/api/idempotency)
- [API 오류](https://docs.system-one.dev/ko/docs/api/errors)
- [TypeScript SDK](https://system-one.dev/ko/sdk)
- [API reference](https://system-one.dev/ko/api)
- [Models](https://system-one.dev/ko/models)
- [모델 카탈로그](https://docs.system-one.dev/ko/docs/models)
- [Authentication](https://system-one.dev/ko/auth.md)
- [Pricing](https://system-one.dev/ko/pricing)
- [크레딧 과금](https://docs.system-one.dev/ko/docs/billing)
- [OpenAPI specification](https://system-one.dev/openapi.json)
- [Agent integration guide](https://system-one.dev/ko/skill.md)
- [System One for Coding Agents: Cursor, Claude Code, Codex](https://docs.system-one.dev/ko/docs/coding-agents)
- [Installable coding-agent skill](https://system-one.dev/skills/system-one/SKILL.md)
- [About](https://system-one.dev/ko/about)
- [Contact](https://system-one.dev/ko/contact)
- [Playground samples](https://system-one.dev/ko/demo)
- [블로그](https://system-one.dev/ko/blog)
- [SDK source](https://github.com/ziyu/system-one-sdk)
- [@system-one-ai/core (npm)](https://www.npmjs.com/package/@system-one-ai/core)