INSTALL

Installation

How To

.exe, .pkg, .deb 등 제공되는 설치 프로그램을 실행합니다.

자세한 설치 과정은 설치 프로그램과 함께 제공되는 설치 지침을 따릅니다.

INSTALL

Recommended environment

권장 환경

Kaibotos를 설치하는 시스템은 제공되는 서비스 버전이 지원하는 운영체제, CPU 아키텍처와 RAM 요구사항을 충족해야 합니다.

항목	요구사항
OS	서비스 버전에서 지원하는 운영체제
CPU	서비스 버전에서 지원하는 CPU 아키텍처
RAM	서비스 버전에서 요구하는 메모리 용량

Windows에서도 사용할 수 있습니다. 다만 일반적인 AI Agent가 선호하는 실행 환경을 고려하면 Linux 또는 macOS가 더 적합합니다.

Host Agent가 설치되는 Host에는 사용할 AI Provider의 Session 생애주기가 동작할 수 있는 Shell 환경이 제공되어야 합니다.

GETTING STARTED

Overview

Kaibotos란

Kaibotos는 AI Agent의 장기 기억을 개별 Session과 AI Provider로부터 분리해 중앙에 보존하고, 서로 다른 Agent와 Session이 필요한 맥락만 공유하면서 하나의 Task를 지속적으로 협업할 수 있게 하는 Agent Memory & Collaboration Backend입니다.

Kaibotos는 AI Provider나 AI 모델 자체, Repository, IDE 또는 CI 자체를 제공하는 제품이 아닙니다.

기본 작업 구조

Organization
  └─ Product
      └─ Task
          └─ Session

사용자가 작업하는 단위

사용자의 기본 작업 단위는 Session이 아니라 Task입니다.

GETTING STARTED

Getting Started

첫 Task 시작하기

Kaibotos를 사용하기 위해 AI와 작업하는 방식을 새로 배울 필요는 없습니다. Web Console에서 Task를 만들고 감독 Agent와 평소처럼 대화하며 작업합니다.

1. Product 선택

Task가 속할 Product를 선택합니다. Product는 소프트웨어 제품에 한정되지 않습니다. 여러 Task가 같은 목표, 지식과 규범을 장기간 공유해야 하는 서비스, 연구 주제, 조사 영역이나 조직 운영 영역도 Product로 사용할 수 있습니다.

2. 감독 Provider 선택

감독 역할을 수행할 AI Provider를 선택합니다. 실제 선택 가능한 Provider와 Harness 조합은 현재 배포 버전의 지원 Matrix를 따릅니다.

3. 목표 입력

달성하려는 목표를 자연어로 입력합니다. 입력한 원문은 Task의 최초 목표로 보존됩니다.

4. Task 시작

Kaibotos는 목표와 관련된 상위 Context를 바탕으로 Task Context를 구성하고 감독 Session을 생성합니다. 준비가 끝나면 Task 화면의 감독 Terminal에 연결됩니다.

5. 감독과 작업

사용자는 감독과 상호작용합니다. 조사, 구현과 감리 등 하위 Session은 감독의 지휘 아래 동작합니다. 하위 Session에 별도로 지시해야 할 때도 감독에게 자연어로 요청합니다.

Session이 교체될 때

감독 Session이 종료되거나 교체되어도 같은 Task 화면에서 계속 작업합니다. 새 감독 Session은 Kaibotos에 보존된 Task 상태와 기억을 받아 기존 Task를 이어갑니다.

GETTING STARTED

Register

인스턴스 등록

정식 도입한 Kaibotos 인스턴스를 등록하는 절차입니다. 정식으로 발급된 라이선스를 등록해야 설치된 인스턴스를 이용할 수 있으며, 등록되지 않은 상태에서는 모든 기능의 이용이 차단됩니다.

등록은 다음 절차로 진행됩니다.

설치된 인스턴스에서 라이선스 요청 정보를 추출해 Kaibotos에 라이선스 발급을 요청합니다.
제출된 라이선스 요청 정보가 승인되면 라이선스가 발급됩니다.
발급된 라이선스를 인스턴스에 등록합니다.

정식 라이선스는 공급 계약 내용과 라이선스 요청 정보가 일치하는 경우에만 승인됩니다.

GETTING STARTED

FAQ

Kaibotos를 사용하려면 기존 AI 도구를 바꿔야 하나요?

아닙니다. 기존 AI 도구를 계속 사용하거나 다른 지원 대상 도구로 바꿀 수 있습니다. 익숙하고 선호하는 AI 도구를 선택하면 됩니다. Kaibotos는 사용자가 해당 도구를 평소 사용하던 방식으로 작업할 수 있도록 연결합니다.

Kaibotos가 AI 모델인가요?

아닙니다. Kaibotos는 AI Provider나 AI 모델 자체가 아니라 Agent의 기억, Context, Session과 협업 상태를 관리하는 Backend입니다.

대화 기록을 전부 다음 Session에 넣나요?

아닙니다. 전체 기록을 그대로 전달하지 않고 현재 역할과 임무에 필요한 Context를 구성해 제공합니다.

Context는 전체 History와 같은가요?

아닙니다. History는 실제 작업의 원본 기록과 실행 이력이고, Context는 특정 범위에서 현재 유효하며 작업에 필요한 맥락입니다.

Session을 그대로 복구하나요?

기존 Session 자체를 되살리는 방식이 아닙니다. 새 Session에 필요한 Context를 구성해 기존 Task를 이어가게 합니다.

Provider 내부의 숨은 추론 상태도 복원하나요?

아닙니다. Kaibotos가 보존한 목표, 제약, 결정, 근거, 진행 상태, 메시지와 중요 기억을 재구성합니다. AI Provider 내부의 숨은 추론 상태나 보존되기 전의 순간적인 생성 상태를 복제하지 않습니다.

여러 AI Provider를 한 Task에서 함께 사용할 수 있나요?

Kaibotos는 Role과 Provider를 분리한 Provider 중립 구조를 사용합니다. 실제 사용할 수 있는 Provider·Harness 조합과 보장 범위는 지원 Matrix를 따릅니다.

Product는 상용 소프트웨어 제품만 뜻하나요?

아닙니다. 여러 Task가 같은 목표, 지식과 규범을 장기간 공유해야 하는 서비스, 연구 주제, 조사 영역이나 조직 운영 영역도 Product로 정의할 수 있습니다.

Kaibotos는 Session 로그 저장소인가요?

아닙니다. 원본 기록을 보존하는 것에 그치지 않고, 현재 유효한 Context를 범위별로 관리하고 필요한 Session에 다시 제공합니다.

Self-Hosted이면 모든 AI가 로컬에서 실행되나요?

아닙니다. Kaibotos 인스턴스와 보존 데이터를 사용자 환경에서 운영한다는 뜻입니다. AI Provider의 실행 위치와 연결 방식은 선택한 Provider에 따라 달라집니다.

CONCEPTS

Provider

AI Provider

AI Provider는 Agent가 사용하는 AI 모델 또는 서비스 제공 주체입니다. Kaibotos의 제품 구조는 특정 Provider에 종속되지 않습니다.

Provider와 Role

Role은 Agent가 맡는 기능적 책임이고 Provider는 그 역할을 실행하는 수단입니다. 같은 Role을 서로 다른 Provider가 맡을 수 있고, 하나의 Task에 서로 다른 Provider의 Agent Session이 참여할 수 있습니다.

Role       = 무엇을 책임하는가
Provider   = 어떤 AI가 그 역할을 실행하는가
Session    = 해당 역할과 임무를 수행하는 일시적인 실행 단위

지원 범위

Provider 이름만으로 지원 여부를 판단하지 않습니다. 실제 지원 범위는 검증이 완료된 Provider·Harness 조합의 지원 Matrix를 따릅니다.

CONCEPTS

Contexts

Context란

Context는 특정 범위에서 현재 유효하며 작업에 필요한 맥락입니다. 해당 범위의 전체 대화 기록이나 전체 History와 같지 않습니다.

Organization Context

여러 Product에 공통으로 적용되는 최상위 장기 맥락입니다. 조직 공통 규범, 품질 기준, 여러 Product에 걸쳐 재사용할 지식, 선례와 교훈을 포함할 수 있습니다.

Product Context

특정 Product에 장기간 유효하며 여러 Task가 공유하는 맥락입니다. Product의 목표와 정의, 장기 결정, 제약, 규칙, 축적된 지식과 경험을 보존합니다.

Task Context

현재 Task에 참여하는 여러 Session이 공유하는 공용 작업 맥락입니다. 목표, 요구사항, 제약, 현재 유효한 결정, 중요한 근거, 진행 상태와 미해결 쟁점 등 현재 Task 수행에 필요한 내용을 제공합니다.

Task Context는 Task의 전체 Transcript나 전체 History가 아닙니다.

Session Context

개별 Session이 현재 역할과 임무를 수행하기 위해 사용하는 가장 좁고 가벼운 맥락입니다. 상위 Context 전체가 아니라 현재 역할과 임무에 필요한 범위만 제공합니다.

Context가 전달되는 방식

새 Session은 Task Context 전체를 그대로 받지 않습니다. 현재 Role과 구체 임무에 필요한 Context만 제공받습니다. 같은 Task에서도 감독, 조사, 구현과 감리 Session은 서로 다른 Session Context를 사용할 수 있습니다.

현재 유효한 정보

Kaibotos는 하위 범위의 모든 기록을 상위 Context에 그대로 누적하지 않습니다. 각 범위에서 현재 유효한 내용만 정제해 유지합니다.

CONCEPTS

Memory

Memory란

Memory는 이후 다시 사용할 가치가 있어 Kaibotos가 장기적으로 관리하는 정보의 총칭입니다.

Memory에는 다음과 같은 정보가 포함될 수 있습니다.

목표와 요구사항
결정과 근거
제약과 규칙
진행 상태와 미해결 쟁점
지식과 설명
선례와 교훈
검증 결과와 중요한 작업 기록

History와 Memory

History는 실제 작업의 원본 기록과 실행 이력입니다. Memory는 그중 이후 다시 사용할 가치가 있는 정보를 장기적으로 관리하는 개념입니다.

Memory와 Context

Memory가 보존된 정보의 총칭이라면 Context는 특정 Organization, Product, Task 또는 Session에서 현재 작업에 필요한 맥락입니다. Kaibotos는 보존된 기억을 현재 목표와 역할에 맞는 Context로 구성해 Agent에 제공합니다.

경험의 재사용

과거의 결정, 선례, 교훈과 규범을 일회성 Session과 함께 소멸시키지 않고 Product와 Organization의 장기 자산으로 축적해 이후 Task에서 다시 사용합니다.

CONCEPTS

Sessions

Session이란

Session은 한 Agent가 특정 역할과 임무를 수행하는 일시적인 실행 맥락입니다. Session은 Kaibotos의 장기 기억 소유자가 아니며 필요에 따라 생성, 교체하거나 종료할 수 있습니다.

Task와 Session

Task는 사용자가 달성하려는 지속적인 작업 목표이고 Session은 Task 안에서 역할을 수행하는 실행 단위입니다.

Task
  ├─ 감독 Session
  ├─ 조사 Session
  ├─ 구현 Session
  └─ 감리 Session

하나의 Task는 여러 Session이 참여해 수행할 수 있습니다. Session이 교체되어도 Task는 지속됩니다.

기본 Session Role

감독: Task 전체를 총괄하고 다른 역할 Session의 임무와 생애를 지휘합니다.
조사: 사실, 근거, 현재 상태와 관련 Evidence를 조사합니다.
구현: 확정된 목표와 제약 안에서 실제 변경과 검증을 수행합니다.
감리: 계획, 변경, Evidence와 검증 결과를 독립적으로 검토합니다.

Role은 Provider와 분리됩니다. 같은 Role을 다른 Provider가 맡을 수 있습니다.

Session Context

각 Session에는 역할과 현재 임무에 필요한 Context만 제공합니다. 전체 Product History나 Task의 모든 기록을 Session마다 반복해서 전달하지 않습니다.

Resume

Resume은 기존 Session 자체를 되살리는 것이 아닙니다. 새 Session에 필요한 Context를 구성해 기존 Task를 이어가게 하는 것입니다.

SECURITY

Authenticate

사용자 인증

Kaibotos Web Console과 보호된 기능은 인증된 사용자만 접근할 수 있습니다. 기본 인증 흐름은 OIDC/OAuth2 Authorization Code와 PKCE를 사용합니다.

설치와 비상 복구를 위한 Bootstrap local OWNER는 일반적인 상시 로그인 계정과 구분합니다.

SECURITY

Authority

권한의 주체

Kaibotos에서 권한은 사람 또는 서비스 Principal에 부여됩니다. AI Session의 작업 Role과 사용자·서비스의 Authorization Role은 서로 다른 개념입니다.

AI Session은 사용자 권한을 대신 획득하지 않으며, 사람의 승인이 필요한 행위를 스스로 승인할 수 없습니다. 사용자가 수행할 수 있는 작업은 Organization Role과 Product에 부여된 범위 안에서 결정됩니다.

SECURITY

RBAC

역할 기반 접근 제어

Kaibotos는 다음 Authorization Role을 사용합니다.

OWNER
ADMIN
OPERATOR
CURATOR
MEMBER
AUDITOR

Organization에서 부여된 Role은 Product assignment에 따라 더 좁은 범위로 제한될 수 있습니다.

Session의 감독·조사·구현·감리 Role은 위 Authorization Role이 아니며 사용자 권한을 부여하지 않습니다.

WEB CONSOLE

Administrator

Administrator란

Administrator는 Kaibotos 인스턴스의 동작 방식과 운영 설정을 관리하는 권한을 가진 사람입니다. AI Agent의 Session Role이 아니며, 일반 사용자가 Task를 수행할 수 있도록 인스턴스의 공통 환경과 정책을 구성합니다.

AI 구성 관리

Administrator는 Kaibotos의 각 기능에 사용할 Provider와 Model 구성을 관리합니다. 기능과 지원 범위에 따라 사고 수준과 같은 실행 옵션도 함께 지정할 수 있습니다.

대표적인 관리 대상은 다음과 같습니다.

각 Context 범위에 정보를 편입할지 판독하는 Provider, Model과 사고 수준
보존된 정보에서 현재 작업에 필요한 Context를 구성하는 Provider, Model과 사고 수준
임베딩에 사용할 Provider, Model과 지원되는 처리 옵션
Product와 Organization에 적용할 기본 구성과 범위별 재정의

설정 화면에서는 각 구성이 적용되는 범위와 현재 상태를 확인하고 변경합니다.

인스턴스 운영

Administrator는 Provider 연결 상태, 지원되는 Model과 Host Agent 상태를 확인하고, 인증과 권한 정책 등 인스턴스 운영에 필요한 관리 기능을 사용합니다. 실제로 노출되는 항목은 설치된 제품 버전과 권한에 따라 달라질 수 있습니다.

WEB CONSOLE

User

Web Console의 기본 작업 단위

Web Console에서 사용자의 기본 작업 단위는 Session이 아니라 Task입니다.

Task를 만들 때 다음 내용을 선택하거나 입력합니다.

Product
감독 Provider
자연어로 작성한 목표

Task가 준비되면 감독 Role의 실제 AI Session에 연결된 Task Terminal에서 작업합니다.

감독 Task Terminal

사용자는 감독과 상호작용합니다. 감독 Session이 종료, 장애 또는 교체로 재생성되어도 같은 Task 화면과 같은 Terminal 위치에서 계속 작업합니다.

하위 Session 종합뷰

하위 Session은 기본적으로 Terminal을 직접 노출하지 않고 Task 화면에서 상태를 종합해 보여줍니다.

Role
현재 Mission
Provider와 Model
Reasoning Level
Session 상태
Context Window 사용량과 관측 상태

Context 준비 상태

Task 생성이나 재구성에 시간이 필요한 경우 Web Console은 현재 처리 단계와 진행 상태를 표시합니다. 반복 실패한 경우 다시 시도하거나 현재 Context로 Task를 시작할 수 있습니다.

하위 Session에 요청하기

하위 Session의 작업을 바꾸거나 제어해야 할 때도 감독에게 요청합니다. 일반 사용자는 작업 지시와 Session 제어를 별도 문법으로 구분할 필요가 없습니다.

REFERENCE

Host Agent

Host Agent란

Kaibotos Host Agent는 각 Host에서 실제 AI Session과 Terminal을 제어하는 비AI 실행 Agent입니다.

Host Agent는 AI 의미 판단이나 제품 의사결정을 수행하지 않습니다. Kaibotos가 확정한 정책, 권한과 상태에 따라 실제 Host의 Session과 Terminal 제어를 집행합니다.

주요 책임

Session에 Prompt와 Input 전달
Session 생성, 종료와 재실행
Terminal 명령 전달
실행 결과 회수

Message Broker와의 차이

Session 사이의 질문, 지시와 응답은 Kaibotos의 Message·Event 경로로 전달됩니다. Host Agent는 그 결정에 따라 실제 Host의 Session과 Terminal을 제어하는 실행 말단입니다.

AI Agent가 아닌 이유

Host Agent는 Context를 해석하거나 기억의 가치를 판단하지 않습니다. 의미 판단과 제품 정책은 Kaibotos가 담당하고 Host Agent는 결정된 제어를 실행합니다.

REFERENCE