문서

Ankole 실행과 운영

Ankole을 배포하고, 런타임 구조를 이해하고, 회사가 관리하는 배포 인스턴스를 운영합니다.

도입부터 시작하기

01시작하기

02사용자 가이드

03개발자 가이드

아키텍처Control Plane, Agent Computer Worker, Actor Runtime, Brain, Background Agent Jobs가 Ankole Agent Harness를 구성하는 방식을 설명합니다.
AIGateway APIOpenResponses 호환 AI 경계 — HTTP, SSE, WebSocket 엔드포인트, stateless·stateful 호출, provider 라우팅.
SignalsGateway공유 작업(shared work)의 수신 계층 — 채팅, 웹훅, 프로바이더 이벤트가 소스 사실을 실행 상태로 만들지 않고 액터 이벤트가 되는 방식을 설명합니다.
Actor Runtime장기 실행 session이 유지되고, 깨어나고, 실패하고, 복구되는 방식 — actor key, OTP 실패 도메인, activation 펜스, RuntimeFabric 라이브 경로.
Background Agent JobsWorker 손실을 견디는 durable하고 재개 가능한 작업 — 작업 상태 머신, 입력 대기(wait-for-input), 소유자 wakeup, Actor Runtime과의 경계를 다룹니다.
Principal 및 AuthZAnkole deployment instance의 권한 경계 — 책임 주체로서의 Principal, 권한 부여(permission grant), 그룹 멤버십, 그리고 프롬프트 관례가 아닌 런타임 강제.
Agent LibraryAgent가 할 수 있는 일 — 파일시스템 번들로서의 Skill, Codex 패키지로서의 Agent Plugin, 그리고 Agent별로 해석되는 기본값-후-재정의 활성화 모델.
Agent Computer WorkerBun과 TypeScript Worker가 control plane이 각 turn을 fence하는 동안 model loop, tool, 파일, 터미널 상태, 스트리밍 출력을 실행하는 방식.
Rust Kernel공유 네이티브 레이어 — 인가, RuntimeFabric 트랜스포트, AI 데이터 플레인 프리미티브의 단일 Rust 구현으로, Elixir 제어 플레인과 Bun worker 양쪽이 로드합니다.
Control Plane Plugins퍼스트파티 Elixir 확장 모델 — discovered 및 active plugin, subsystem contract, AppConfigure key, supervised children, 그리고 next-start 활성화 경계.
Skill 및 Control Plane Plugin 개발Agent에 작업 방식을 추가하거나, identity, channel, configuration 및 supervised service를 control plane에 추가하는 방법을 설명합니다.
Worker CLI 기능Agent 기능을 `--help`가 계약을 담당하는 shell 명령으로 제공하고, Agent가 관련 결정을 내리는 위치에 한 문장짜리 포인터를 배치합니다.
Provider 추가AIGateway Provider를 선언하는 방법 — DSL, 컴파일된 정의, 설정, Capability, prepare 함수, 플러그인 기반 등록.
Context 압축과 compactionAnkole이 긴 대화를 model의 context 안에 유지하는 방법 — AIGateway의 자동 history compaction과 사용자 원문의 그대로 보존.
에이전트 루프제어 플레인 턴 수명 주기와 worker 측 에이전트 루프 사이의 경계 — 각 측이 소유하는 것, 통신 방식, 그리고 반복 예산과 재시도가 위치하는 곳.
프롬프트 조립에이전트가 매 턴마다 보는 시스템 프롬프트가 어떻게 만들어지는지 설명합니다 — 제어 플레인의 데이터 제공자, 프롬프트를 Worker로 전달하는 두 채널, 그리고 최종 프롬프트를 생성하는 Worker 측 조립 과정.
Provider 런타임AIGateway가 selector를 provider로 해석하고, 준비된 요청을 만들고, kernel을 통해 디스패치하는 방법 — 모델 호출에서 provider 응답까지의 세 단계.
Tool 런타임worker가 turn이 model에 제공하는 tool을 수집하고 schema로 변환하며 dispatch하는 방식 — WorkerAgentTool contract, turn별 조립, schema 변환, dispatch 경로.
Trajectory 및 메시지 형식Ankole이 대화 메시지와 백그라운드 Job 궤적을 저장하고 투영하는 방식 — 두 저장 형태, ChatML 정규 형식, 그리고 모델이 보는 투영.
코드 실행Ankole Agent가 대화 중 또는 영구 Background Agent Job으로 코드를 실행하는 방식.
MCP 기반 Skill 사용활성화된 Skill이 Agent 또는 Automation 스크립트를 mcporter를 통해 MCP 서버로 라우팅하는 방법.
Todo와 clarifyAnkole 에이전트가 복잡한 작업을 계획하고 작업 중에 실제 모호함을 해결하는 방식 — todo 도구(세션별, 진행 중 항목 최대 1개)와 clarify 도구(결정 질문 1개, 영구 기록, 턴 종료). 에이전트가 각각을 언제 사용하는지, 운영자가 이들에서 기대해서는 안 되는 것.
Audit trail(감사 기록)Ankole의 audit 표면 읽는 방법 — AuthZ grant 기록, control-plane 구조화 log, 그리고 각 표면이 누가 무엇을 언제 변경했는지를 어떻게 기록하는지 설명합니다.
AIGateway API 사용법외부 호출자가 AIGateway REST API를 사용하는 방법 — OpenResponses 호환 endpoint, agent vs admin 토큰, 상태비저장(stateless) 및 상태보존(stateful) 호출, 작업 예시.

04참조

05가이드