공개 베타TypeScript 에이전트 SDK + 코딩 CLI

SDK로 에이전트를 만들고 CLI로 코딩하세요.

Robota는 TypeScript AI 에이전트 SDK와 코딩 CLI를 제공합니다. 두 제품 모두 같은 공개 구성 요소를 사용합니다. SDK로 앱에 에이전트를 넣거나 터미널에서 CLI를 실행하세요. 모델 엔드포인트, 도구, 권한, 세션은 작업에 맞게 설정할 수 있습니다.

공개 패키지 · Node.js 예제 · 모델 엔드포인트 필요

에이전트가 자신을 구성하는 시스템을 안정적으로 개선하는 것이 목표입니다.

01 / 공통 기반

구성 요소를 살펴보고 첫 질문을 보내세요.

agent-framework로 세션, 도구, 권한 검사를 함께 구성할 수 있습니다. 코딩 CLI도 이 프레임워크로 만든 공식 인터페이스입니다. 직접 만든 Node.js 앱에서도 같은 프레임워크를 사용할 수 있습니다.

@robota-sdk/agent-framework에이전트 프레임워크sessions · tools · permissions
@robota-sdk/agent-cli코딩 CLIrobota
앱에 넣는 SDK와 터미널에서 실행하는 CLI는 같은 공개 TypeScript 구성 요소를 사용합니다.
SDK 패키지 설치
npm install @robota-sdk/agent-framework @robota-sdk/agent-tools @robota-sdk/agent-provider openai
TypeScript로 질문 하나 보내기
import { createQuery } from '@robota-sdk/agent-framework';
import { createNodeFrameworkHost } from '@robota-sdk/agent-framework/node';
import { OpenAIProvider } from '@robota-sdk/agent-provider/openai';
import { createDefaultTools } from '@robota-sdk/agent-tools/defaults';

const model = 'your-loaded-model-id';
const query = createQuery({
  host: createNodeFrameworkHost({ createDefaultTools }),
  cwd: process.cwd(),
  provider: new OpenAIProvider({
    apiKey: 'local',
    baseURL: 'http://127.0.0.1:1234/v1',
  }),
  model,
});

try {
  console.log(await query('Reply with one sentence.'));
} finally {
  await query.shutdown();
}

이 SDK 예제는 3.1.0을 기준으로 합니다. 출시된 뒤 해당 버전을 설치하세요. 프레임워크 3.0.7에는 이 예제에 쓰인 Node 호스트 진입점이 없습니다. 모델을 불러온 OpenAI 호환 서버와 해당 모델의 ID도 필요합니다. 로컬 포트 번호는 예시입니다. 'local' API 키는 인증이 없는 서버에서 쓰는 임시 값입니다. 서버에서 인증을 요구하면 해당 인증 정보로 바꾸세요. 예제에 실제 모델 응답을 싣지는 않았습니다.

프레임워크 소스 보기

02 / 코딩 CLI

CLI 설정 시작하기
npx @robota-sdk/agent-cli

Node.js 22.12 이상과 API 키 또는 실행 중인 로컬 모델 서버가 필요합니다. 비용과 이용 정책은 선택한 프로바이더 엔드포인트에 따라 다릅니다.

프로바이더와 모델을 설정한 뒤 질문을 입력하세요:

Reply with one sentence.

선택한 모델이 텍스트로 답합니다. 답변 내용과 품질은 모델에 따라 다릅니다. 프로젝트 파일에 관해 질문하기 전에 작업 공간을 신뢰할지 결정하세요.

CLI 설정 가이드

02 / 첫 작업 선택

시작 방법을 고르세요.

01

앱에 질문 기능 넣기

프레임워크와 프로바이더 어댑터를 설치한 뒤 Node.js 스크립트에서 createQuery를 호출하세요. 직접 만든 UI에서 긴 대화를 다루려면 InteractiveSession을 사용하면 됩니다.

시작하기 전에

이 예제는 SDK 3.1.0을 기준으로 합니다. 출시된 뒤 설치하세요. Node.js 22.12 이상과 설정을 마친 프로바이더 엔드포인트, 모델 ID도 필요합니다. 이 페이지의 예제는 실행 중인 로컬 OpenAI 호환 서버를 사용합니다.

SDK 가이드(영문)
02

코딩 CLI로 프로젝트에 관해 질문하기

CLI를 실행하고 프로바이더와 모델을 설정하세요. 외부 서비스의 API 키나 실행 중인 로컬 엔드포인트를 사용하면 됩니다. CLI가 프로젝트 정보를 읽기 전에 작업 공간을 신뢰할지 결정합니다.

시작하기 전에

Node.js 22.12 이상과 API 키 또는 실행 중인 로컬 모델 서버가 필요합니다. 비용과 이용 정책은 선택한 프로바이더 엔드포인트에 따라 다릅니다.

CLI 설정 가이드

03 / SDK와 CLI의 기능

지금 쓸 수 있는 기능

아래 기능은 모두 공개 SDK 패키지나 이 패키지로 만든 코딩 CLI에서 사용할 수 있습니다. 각 카드에 관련 패키지, 클래스, 플래그, 명령 이름과 자세한 사용 가이드를 정리했습니다.

모델과 프로바이더

작업에 맞는 모델을 선택할 수 있습니다. 모델 요청이 실패하면 다른 모델로 현재 턴을 이어갑니다.

다양한 프로바이더 연결

Anthropic, OpenAI, Google Gemini, DeepSeek, Qwen, Gemma용 프로바이더 패키지를 제공합니다. baseURL을 지정하면 게이트웨이, Azure, vLLM, 로컬 서버 등 OpenAI 호환 엔드포인트에도 연결할 수 있습니다.

  • Anthropic
  • OpenAI
  • Gemini
  • DeepSeek
  • Qwen
  • Gemma
  • baseURL
가이드(영문)

폴백, effort, 어드바이저

기본 모델에 과부하가 걸리거나 오류가 나면 FallbackProvider가 진행 중인 턴을 다른 모델로 넘깁니다. CLI에서는 실행마다 모델 effort를 설정하고, 에이전트가 조언을 구할 어드바이저 모델을 지정할 수 있습니다.

  • FallbackProvider
  • --fallback-model
  • --advisor
  • --effort
가이드(영문)

로컬 모델

내 컴퓨터나 내부망에서 Ollama, LM Studio 등 OpenAI 호환 서버를 실행하고, 프로바이더 프로필에 해당 서버의 주소를 지정하세요. 모델은 직접 실행해야 합니다. 모델 요청 외에 어떤 데이터가 외부로 전송되는지는 활성화한 도구에 따라 달라집니다.

  • Ollama
  • LM Studio
  • vLLM
가이드(영문)

이미지와 영상 생성

Gemini 프로바이더로 이미지를, 별도의 ByteDance(ModelArk) 프로바이더로 영상을 생성할 수 있습니다. 영상 프로바이더를 에이전트의 대화 모델로 사용할 수는 없습니다.

  • agent-provider/gemini
  • agent-provider/bytedance
가이드(영문)

도구와 안전장치

도구의 입력 타입을 정의하고, 실행 전에 모든 도구 호출을 검사합니다.

실행 전 인자 검증

createZodFunctionTool은 함수를 실행하기 전에 모델이 전달한 인자를 zod 스키마로 검사합니다. 기본 코딩 도구로 파일 작업, 검색, 셸 실행과 웹 콘텐츠 가져오기를 처리할 수 있습니다.

  • createZodFunctionTool
  • Read
  • Write
  • Edit
  • Glob
  • Grep
  • Bash
  • WebFetch
가이드(영문)

권한 모드와 규칙

도구를 호출할 때마다 deny, ask, allow 규칙을 먼저 확인한 뒤 다섯 가지 권한 모드 중 하나를 적용합니다. 일부 파괴적인 작업은 어떤 모드에서도 자동으로 승인하지 않습니다.

  • plan
  • default
  • acceptEdits
  • auto
  • bypassPermissions
가이드(영문)

라이프사이클 훅

도구, 프롬프트, 세션 이벤트가 발생할 때 명령을 실행합니다. PreToolUse로 호출을 막을 수 있습니다. 다른 훅으로 로그를 남기고 실행 내역을 점검하거나, 다음 프롬프트에 문맥을 추가할 수 있습니다.

  • PreToolUse
  • PostToolUse
  • SessionStart
  • UserPromptSubmit
가이드(영문)

셸 명령을 격리하는 OS 샌드박스

Linux와 WSL2에서는 bubblewrap, macOS에서는 Seatbelt 안에서 셸 명령을 실행할 수 있습니다. 명령이 파일을 읽고 쓰거나 네트워크에 접속할 수 있는 범위를 제한합니다.

  • bubblewrap
  • Seatbelt
  • /sandbox
가이드(영문)

작업 공간 신뢰

AGENTS.md, CLAUDE.md 같은 프로젝트 지침은 신뢰하는 작업 공간에서만 읽습니다. 신뢰하지 않는 저장소에서는 사용자 응답 없이 실행하는 작업을 거부하거나 Restricted 모드로 시작합니다.

  • AGENTS.md
  • CLAUDE.md
  • --safe-mode
가이드(영문)

세션과 실행

터미널을 닫아도 작업을 이어가거나 여러 에이전트에 나눠 맡길 수 있습니다.

저장하고 이어가는 세션

대화를 계속 이어가거나 저장한 세션을 다시 열고, 세션 이름을 바꾸거나 복제할 수 있습니다. 문맥 사용량을 추적하고 자동으로 압축합니다. SDK에서 세션을 저장하려면 호스트가 세션 저장소를 직접 제공해야 합니다.

  • InteractiveSession
  • /resume
  • /fork
  • /compact
가이드(영문)

백그라운드 세션과 데몬

세션을 백그라운드로 실행하면 터미널을 닫은 뒤에도 작업을 이어갈 수 있습니다. 작업 공간 데몬 하나가 여러 터미널과 데스크톱 앱에 같은 런타임을 제공합니다.

  • daemon start
  • --attach
  • session start --background
가이드(영문)

서브에이전트와 백그라운드 작업

각자 문맥과 도구를 가진 서브에이전트에 작업을 맡길 수 있습니다. 같은 프로세스나 자식 프로세스에서 실행하고, 대기 중이거나 실행 중인 작업을 한곳에서 관리합니다.

  • /agent
  • /background
  • agent-executor
  • agent-subagent-runner
가이드(영문)

반복, 예약, 계획

정해진 간격으로 프롬프트를 반복하거나, 나중에 또는 명령 출력이 조건과 일치할 때 에이전트를 다시 실행합니다. 계획을 승인하기 전까지 세션을 읽기 전용으로 유지할 수도 있습니다.

  • /loop
  • /schedule
  • /monitor
  • /plan
가이드(영문)

체크포인트, 메모리, 비용

편집 내용을 체크포인트 시점으로 되돌리거나 체크포인트에서 새 분기를 만들 수 있습니다. 메모리를 켜면 승인한 사실을 다음 세션에서도 유지합니다. 문맥 사용량을 확인하고 월 비용 한도를 설정할 수도 있습니다.

  • /rewind
  • /memory
  • /context
  • /cost
가이드(영문)

DAG 워크플로

/workflows에 작업을 설명하면 현재 모델로 워크플로를 설계합니다. 작업 공간에 JSON으로 저장하고 검증한 뒤 실행하며, 세션에서 분리해 실행할 수도 있습니다.

  • /workflows create
  • /workflows run
  • .workflows/
가이드(영문)

멀티에이전트 라운드테이블

독립된 에이전트와 사람이 같은 대화록을 공유합니다. 발언 순서를 정하고 여러 그룹을 병렬로 실행할 수 있습니다. Robota 세션을 대화 참가자로 연결하거나, 다음 발언자를 선택하도록 연결할 수도 있습니다.

  • agent-roundtable
  • agent-roundtable-robota
가이드(영문)

연결과 확장

런타임을 포크하지 않고 서버, 스킬, 플러그인을 연결합니다.

양방향 MCP

명시적으로 승인한 뒤 stdio나 원격 MCP 서버에 연결할 수 있으며, OAuth 로그인도 지원합니다. 세션을 stdio나 인증된 HTTP를 통해 MCP 서버로 제공할 수도 있습니다.

  • agent-mcp
  • OAuth
  • /mcp approve
  • mcp serve
  • agent-transport/mcp
가이드(영문)

스킬, 명령, 에이전트

Markdown으로 스킬과 명령을 작성하면 슬래시 명령으로 사용할 수 있습니다. 서브에이전트는 에이전트 정의 파일로 설정합니다. CLI가 프로젝트와 홈 디렉터리에서 이 파일들을 찾아 읽습니다.

  • .agents/skills
  • .claude/skills
  • .claude/commands
  • /skills
가이드(영문)

플러그인과 마켓플레이스

스킬, 훅, 테마, MCP 서버를 묶은 플러그인을 설치할 수 있습니다. SDK 라이프사이클 플러그인은 대화 기록, 로깅, 사용량, 한도, 오류, 분석, 웹훅을 다룹니다.

  • /plugin marketplace add
  • /plugin install
  • agent-plugin
  • webhooks
가이드(영문)

외부 이벤트

검증된 외부 서비스가 실행 중인 터미널 세션에 텍스트 이벤트를 보내도록 허용할 수 있습니다. 세션 안에서 허용 목록을 확인하거나 권한을 취소할 수 있습니다.

  • --external-event-grant
  • /events
가이드(영문)

인터페이스

같은 세션을 터미널, 스크립트, 브라우저나 프로토콜을 통해 사용합니다.

터미널 UI

명령 메뉴, 프롬프트 기록 검색, 단축키 변경, @path를 통한 파일 첨부, 화면 낭독기용 일반 텍스트 모드를 지원하는 대화형 터미널 앱입니다.

  • React + Ink
  • @path
  • Ctrl+R
  • --screen-reader
  • keybindings.json
가이드(영문)

프린트 모드와 목표 지정

스크립트나 파이프로 프롬프트 하나를 보내고 텍스트, JSON, 스트리밍 JSON 형식으로 응답을 받을 수 있습니다. 스키마에 맞는 출력을 요청하거나 목표를 지정해 여러 턴에 걸쳐 작업할 수도 있습니다.

  • -p
  • --output-format json
  • --json-schema
  • --goal
가이드(영문)

브라우저 GUI와 데스크톱 앱

현재 작업 공간의 GUI를 루프백 주소에서 실행해 브라우저로 엽니다. 저장소의 데스크톱 앱에서도 작업 공간 데몬을 통해 같은 GUI를 사용할 수 있습니다.

  • --serve --open
  • agent-app
가이드(영문)

HTTP와 전송 계층

다른 서비스에서 턴을 요청하고 결과를 server-sent events로 받을 수 있습니다. bearer 토큰이나 OAuth 리소스 서버로 접근을 보호합니다. WebSocket, HTTP, MCP, WebRTC 전송 계층은 같은 와이어 프로토콜을 사용합니다.

  • --serve --http-port
  • SSE
  • OAuth
  • ws · http · mcp · webrtc
가이드(영문)

기기와 원격 제어

실행 중인 다른 세션에 메시지를 보내거나 대화를 다른 세션이나 기기로 넘길 수 있습니다. 내 기기들을 연결하고, 브라우저를 연결해 P2P WebRTC로 세션을 함께 제어할 수도 있습니다.

  • /peers
  • /handoff
  • /devices
  • /remote-control
가이드(영문)

CI와 GitHub Actions

워크플로 단계에서 프린트 모드를 실행해 PR을 검토하거나 작업 요청에 응답할 수 있습니다. evals-as-code 평가 점수를 기준으로 파이프라인의 통과 여부를 정할 수도 있습니다.

  • GitHub Actions
  • -p
  • eval
가이드(영문)

직접 만들기

필요한 계층을 직접 사용하거나 여러 계층을 조합해 자신만의 제품을 만들 수 있습니다.

대화 엔진

ConversationAgent로 턴을 실행하고 응답을 스트리밍할 수 있습니다. 대화 기록, 도구 호출, 구조화된 출력, 플러그인도 지원합니다. 최소 구성은 core와 프로바이더 하나입니다.

  • ConversationAgent
  • run
  • runStream
  • structured output
가이드(영문)

프레임워크 구성

createQuery로 기본 도구와 권한 설정을 적용해 질문 하나를 처리할 수 있습니다. InteractiveSession으로 전체 대화를 관리하고, createAgentRuntime으로 호스트 런타임을 구성할 수 있습니다.

  • createQuery
  • InteractiveSession
  • createAgentRuntime
가이드(영문)

서버, 봇, 서버리스

SSE나 WebSocket 서버에 프레임워크를 넣어 세션별 전체 이벤트 스트림을 제공할 수 있습니다. 봇 채널별로 저장한 세션을 다시 열거나, 아무것도 저장하지 않는 무상태 런타임으로 실행할 수도 있습니다.

  • createAgentRuntime
  • sessionStore
  • resumeSessionId
  • createStatelessRuntime
가이드(영문)

하나의 에이전트, 여러 채널

TransportRegistry로 하나의 에이전트 정의를 여러 전송 계층에서 실행할 수 있습니다. 각 전송 계층의 활성화 여부는 설정 파일에 저장하며, 별도의 게이트웨이 프로세스는 필요하지 않습니다.

  • TransportRegistry
  • agent-transport-*
가이드(영문)

제품 구성

assembleProduct로 선언형 프로필에 따라 제품을 만들 수 있습니다. 코딩 CLI에서 사용하는 기능 팩, 슬래시 명령 모듈, 프리셋, 출력 스타일을 그대로 조합할 수 있습니다.

  • assembleProduct
  • ICapabilityPack
  • createCodingPack
  • presets
가이드(영문)

나만의 CLI 제품 배포

공개된 CLI 패키지를 사용하면서 진입점, 제품 식별 정보, 리소스, 패키징은 직접 관리할 수 있습니다. 제품별 CLI 호스트, Electron 앱용 desktop-host 도우미, 네이티브 실행 파일 빌드를 제공합니다.

  • agent-cli/host
  • createProductCliHost
  • agent-cli/desktop-host
  • buildProductNativeBinary
패키지 README(영문)

진단, 사용량, 평가

설정, 프로바이더, 작업 공간 신뢰 여부, 플러그인을 한 보고서에서 점검할 수 있습니다. 로컬에서 토큰 사용량과 비용을 요약하며, 이때 대화 내용을 전송하지 않습니다. 대화 내용을 제외한 지표를 내보내거나 코드로 평가를 실행할 수도 있습니다.

  • doctor
  • usage
  • usage export
  • session analyze
  • eval
가이드(영문)

04 / 코딩 CLI

터미널에서 에이전트를 실행하세요.

코딩 CLI는 공통 프레임워크로 만든 공식 인터페이스입니다. 터미널 UI, 스크립트, 백그라운드 세션, 브라우저 GUI와 다른 서비스에서도 같은 런타임을 사용합니다.

01

대화하며 작업하기

세션을 시작하고 권한 모드를 선택하세요. 화면 낭독기 모드로 전환할 수도 있습니다.

셸에서

  • robota
  • robota --permission-mode acceptEdits
  • robota --screen-reader
02

스크립트에서 프롬프트 실행하기

프린트 모드로 실행하면 스크립트에서 성공 여부를 확인할 수 있는 종료 코드가 반환됩니다. 목표를 지정하면 여러 턴에 걸쳐 작업을 이어갑니다.

셸에서

  • robota -p "List the TypeScript files in src/"
  • robota -p "Summarize this repository" --output-format json
  • cat task.md | robota -p
  • robota --goal "make the failing tests pass"
03

세션 유지하기

이전 작업을 다시 열고 세션을 백그라운드로 실행하거나, 여러 세션에서 하나의 데몬을 함께 사용할 수 있습니다.

셸에서

  • robota -c
  • robota -r <id-or-name>
  • robota session start --background --name nightly
  • robota daemon start
  • robota --attach
04

다른 화면과 서비스 연결하기

브라우저 GUI를 열거나 CLI를 MCP 서버로 실행할 수 있습니다. HTTP 클라이언트를 연결할 때는 bearer 토큰으로 접근을 제한할 수 있습니다.

셸에서

  • robota --serve --open
  • PRODUCT_HTTP_TOKEN="$(openssl rand -hex 32)" robota --serve --http-port 8787
  • robota mcp serve
05

다른 세션과 기기 연결하기

세션 안에서 다른 세션에 메시지를 보내거나 대화를 넘기고, 기기와 브라우저를 연결할 수 있습니다.

세션 안에서

  • /peers
  • /peers send <session-id> <message>
  • /handoff <session-id>
  • /devices init
  • /remote-control enable
06

설정과 사용량 점검하기

설정을 진단하고 로컬 사용량을 요약하세요. 업데이트를 확인하거나 평가를 실행할 수도 있습니다.

셸에서

  • robota doctor
  • robota usage --period 30d
  • robota --check-update
  • robota eval <definition.mjs>
CLI 레퍼런스(영문)

05 / 권한과 안전

에이전트가 할 수 있는 일을 정하세요.

deny, ask, allow 규칙을 먼저 확인한 뒤 권한 모드를 적용합니다. 실행할 때 모드를 정하거나 세션 안에서 바꿀 수 있습니다.

권한 모드별 허용 범위
모드읽기파일 편집셸 명령
plan허용거부거부(기본 읽기 전용 명령 제외)
default허용확인 요청확인 요청
acceptEdits허용허용확인 요청
auto허용허용모델 분류기가 판단
bypassPermissions허용허용허용
설정 파일의 규칙
{
  "permissions": {
    "allow": ["Bash(pnpm *)", "Bash(git status)"],
    "ask": ["Bash(git push *)"],
    "deny": ["Bash(rm -rf *)", "Write(.env)"]
  }
}

규칙이 모드보다 우선합니다

ask 규칙은 bypassPermissions 모드에서도 승인을 요청합니다. 루트, 홈, 작업 디렉터리를 삭제하거나 .git과 도구 설정 파일에 쓰는 작업은 어떤 모드에서도 자동으로 승인하지 않습니다.

승인 응답이 없으면 거부합니다

default 모드에서는 승인이 필요한 요청에 아무도 답하지 않으면 거부합니다. 호스트가 권한 처리기를 제공하면 해당 처리기가 응답합니다.

샌드박스 안의 셸

권한 규칙과 OS 샌드박스를 함께 사용하면 승인한 셸 명령도 파일과 네트워크에 접근하도록 허용한 범위 안에서만 실행됩니다.

권한과 훅 가이드(영문)

06 / 구조

라이브러리를 조합해 제품을 만드세요.

packages/의 라이브러리는 특정 제품에 종속되지 않아 재사용할 수 있습니다. CLI와 앱은 이 라이브러리를 목적에 맞게 조합해 만듭니다. 각 계층은 아래 계층에만 의존합니다.

    • agent-cli
    제품 인터페이스: 터미널 코딩 도우미
    • agent-product
    제품 구성: 프로필, 기능 팩, 명령, 프리셋
    • agent-ui-terminal
    • agent-transport
    터미널 UI와 같은 와이어 프로토콜을 사용하는 전송 계층
    • agent-framework
    구성: InteractiveSession, createQuery, createAgentRuntime
    • agent-session
    • agent-executor
    • agent-tools
    • agent-mcp
    • agent-plugin
    런타임: 세션, 백그라운드 작업, 도구, MCP 클라이언트, 플러그인
    • agent-provider
    벤더마다 하나의 프로바이더 패키지
    • agent-interface
    계층 간에 공유하는 타입 전용 인터페이스
    • agent-core
    기반: 대화 엔진과 인터페이스
아키텍처 가이드(영문)

공개 패키지

모든 패키지는 npm의 @robota-sdk/에 공개되어 있으며 각각의 버전을 사용합니다. 작업에 필요한 최소한의 패키지부터 시작하세요.

에이전트 인터페이스

필요한 구성 요소를 하나의 번들에 담아 배포하는 코딩 CLI입니다.

패키지 목록(영문)

07 / 설치

실행 방법을 고르세요.

npm CLI와 Node 예제에는 Node.js 22.12 이상이 필요합니다. 단독 실행 파일은 다른 프로그램을 설치하지 않아도 실행할 수 있습니다.

설치 없이 실행

npx로 최신 CLI를 받아 바로 시작합니다.

설치 없이 실행
npx @robota-sdk/agent-cli

전역 설치

npm으로 CLI를 전역 설치하면 터미널에서 PATH를 통해 명령을 찾아 실행할 수 있습니다.

전역 설치
npm install -g @robota-sdk/agent-cli
robota

단독 실행 파일

설치 스크립트가 최신 릴리스에서 OS와 CPU에 맞는 실행 파일을 받아 SHA-256 체크섬을 검증합니다. 서명되지 않은 파일이라 macOS와 Windows에서 경고가 나올 수 있습니다.

macOS / Linux
curl -fsSL https://raw.githubusercontent.com/woojubb/robota/main/scripts/install.sh | bash
Windows PowerShell
irm https://raw.githubusercontent.com/woojubb/robota/main/scripts/install.ps1 | iex
전체 릴리스 보기

최소 구성으로 SDK 사용하기

엔진 패키지 하나와 프로바이더 패키지 하나를 설치하면 됩니다. 에이전트에서 도구를 호출하려면 agent-tools를 추가하세요.

최소 구성으로 SDK 사용하기
npm install @robota-sdk/agent-core @robota-sdk/agent-provider @anthropic-ai/sdk

08 / 소스와 라이선스

소스와 사용 조건을 확인하세요.

공개 소스에서 SDK와 CLI의 구성 방식을 확인할 수 있습니다. 작업에 맞는 패키지와 소스부터 살펴보세요.

쇼케이스 보기

오픈소스와 상용 라이선스

코드는 AGPL-3.0으로 공개되어 있습니다. 다른 사용 조건이 필요하면 상용 라이선스를 선택할 수도 있습니다. 배포나 서비스에 적용되는 라이선스 조건을 확인하세요.

모델 비용은 별도

SDK와 CLI는 모델 추론 서비스를 제공하지 않습니다. 외부 프로바이더는 사용량에 따라 요금을 부과할 수 있고, 로컬에서 모델을 실행할 때도 연산 자원과 운영 비용이 듭니다.

공식 쇼케이스

코딩 CLI는 공개 구성 요소로 만든 공식 개발자 도구입니다. 소스와 쇼케이스에서 구현 사례를 확인할 수 있습니다.

09 / 장기 목표

에이전트가 서로를 개발하고 개선하는 것이 목표입니다.

프로젝트가 장기적으로 추구하는 목표이며, 현재 제공을 보장하는 기능은 아닙니다. 지금은 SDK와 코딩 CLI에서 사용할 프로바이더와 도구, 호스트의 동작 방식을 직접 정할 수 있습니다. 앞으로 시스템을 개선하고 실제 결과를 확인하며 안정적인 자율 개발이 가능한지 입증해야 합니다.

10 / 시작 전 확인

자주 묻는 질문

SDK를 쓰려면 CLI가 필요한가요?

아니요. 직접 만든 Node.js 호스트에서 agent-framework를 가져와 프로바이더를 연결하면 됩니다. CLI는 같은 공개 구성 요소로 만든 완성형 인터페이스 중 하나입니다.

모델을 설정하지 않아도 질문할 수 있나요?

프로바이더 엔드포인트와 사용할 모델이 필요합니다. 이 페이지의 로컬 OpenAI 호환 예제를 실행하려면 모델을 불러온 서버가 실행 중이어야 합니다. 외부 프로바이더를 사용하려면 해당 인증 정보를 준비하고 이용 조건을 따라야 합니다.

SDK가 대화를 자동으로 저장하나요?

아니요. createQuery를 호출하는 것만으로는 대화를 계속 저장하는 세션이 만들어지지 않습니다. 대화를 저장하고 다시 이어가려면 호스트에서 세션 저장소를 제공해야 합니다.

도구를 켜기 전에 무엇을 확인해야 하나요?

작업 공간 신뢰 설정과 권한 모드를 확인하세요. default 모드에서 사용자 응답 없이 실행하는 경우, 승인이 필요한 도구 요청은 거부됩니다. 호스트에서 승인 처리기를 제공하면 해당 처리기가 승인 요청에 응답합니다.

베타 API는 안정적인가요?

아직은 아닙니다. 패키지는 3.0.0 베타 릴리스이며 정식 릴리스 전에 API가 바뀔 수 있습니다. 업그레이드 안내는 변경 기록에서 확인할 수 있습니다.

실제 작업 하나로 시작하세요.

앱에 질문 기능을 넣거나 코딩 CLI를 설정하세요. 어느 쪽이든 사용할 프로바이더와 접근 권한은 직접 정할 수 있습니다.