---
title: "SDK decisão System One para decisões tipadas."
description: "Com o SDK decisão System One, adicione decisões estruturadas com um evaluate(). Defina escolhas, rubricas de scoring e perguntas sim/não, e use respostas tipadas na sua aplicação."
canonical: "https://system-one.dev/pt-BR/sdk"
language: "pt-BR"
---

# SDK decisão System One para decisões tipadas.

Com o SDK decisão System One, adicione decisões estruturadas com um evaluate(). Defina escolhas, rubricas de scoring e perguntas sim/não, e use respostas tipadas na sua aplicação.

Código aberto · TypeScript · Node.js

## Instalar o 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
```
## Conectar um serviço de modelos

Instale core, o adaptador de serviço e um transport. Configure systemOneAdapter e createFetchTransport() para System One API. Mantenha as credenciais no ambiente do servidor.

```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'
```
## Uma interface para decisões estruturadas

### Tipos da pergunta à resposta

Resultados Choice mantêm os nomes das opções como literais TypeScript. Scores e probabilidades sim/não vêm como números.

### Conectar seu provedor

Use System One API diretamente. Um adaptador opcional Vercel AI SDK conecta outros serviços de modelo suportados.

### Controlar o comportamento das requisições

Configure timeouts e retries, cancele com AbortSignal e trate erros tipados na aplicação.

## Conectar à System One API

Use sua chave de API System One para chamar o serviço hospedado. Teste entradas no Playground e revise o uso no console.

[Conectar o SDK à API hospedada](https://docs.system-one.dev/pt-BR/docs/getting-started)

## Start here

- [Developer documentation](https://docs.system-one.dev/pt-BR)
- [Versioning and deprecation](https://docs.system-one.dev/pt-BR/docs/api/versioning)
- [Idempotência e novas tentativas](https://docs.system-one.dev/pt-BR/docs/api/idempotency)
- [Erros da API](https://docs.system-one.dev/pt-BR/docs/api/errors)
- [TypeScript SDK](https://system-one.dev/pt-BR/sdk)
- [API reference](https://system-one.dev/pt-BR/api)
- [Models](https://system-one.dev/pt-BR/models)
- [Catálogo de modelos](https://docs.system-one.dev/pt-BR/docs/models)
- [Authentication](https://system-one.dev/pt-BR/auth.md)
- [Pricing](https://system-one.dev/pt-BR/pricing)
- [Cobrança de créditos](https://docs.system-one.dev/pt-BR/docs/billing)
- [OpenAPI specification](https://system-one.dev/openapi.json)
- [Agent integration guide](https://system-one.dev/pt-BR/skill.md)
- [System One for Coding Agents: Cursor, Claude Code, Codex](https://docs.system-one.dev/pt-BR/docs/coding-agents)
- [Installable coding-agent skill](https://system-one.dev/skills/system-one/SKILL.md)
- [About](https://system-one.dev/pt-BR/about)
- [Contact](https://system-one.dev/pt-BR/contact)
- [Playground samples](https://system-one.dev/pt-BR/demo)
- [Blog](https://system-one.dev/pt-BR/blog)
- [SDK source](https://github.com/ziyu/system-one-sdk)
- [@system-one-ai/core (npm)](https://www.npmjs.com/package/@system-one-ai/core)