# Ankole

> Ankole은 Company Brain을 갖춘 오픈 소스 Claude Tag 대안입니다. 기업용 Agent Harness가 회사 의사결정에 필요한 공유 컨텍스트를 Agent에 제공합니다.

AI Agent용 Ankole 문서입니다. 각 페이지 링크는 해당 페이지의 Markdown 버전을 엽니다.

Ankole 인스턴스를 배포하거나 구성하려면 먼저 [빠른 시작](https://ankole.agentbull.com/ko-KR/docs/quickstart/index.md)을(를) 읽으십시오. 모든 배포 방법, identity provider, LLM Provider, 채팅 채널을 다룹니다. 장애 원인을 찾으려면 [FAQ 및 문제 해결](https://ankole.agentbull.com/ko-KR/docs/faq/index.md)을(를) 읽으십시오.

## 시작하기

- [소개](https://ankole.agentbull.com/ko-KR/docs/introduction/index.md): Ankole의 Agent Harness와 Company Brain이 모델에 컨텍스트, 권한, 실행, 피드백을 제공하는 방식을 설명합니다.
- [빠른 시작](https://ankole.agentbull.com/ko-KR/docs/quickstart/index.md): Ankole을 배포하고, 엔터프라이즈 identity와 모델을 설정하고, IM 채널을 연결한 뒤 실제 Agent 대화를 완료합니다.
- [어댑터 구성 가이드](https://ankole.agentbull.com/ko-KR/docs/adapter-configuration/index.md): 각 Ankole identity 및 채팅 어댑터의 앱 유형, 자격 증명, 권한, 검증 단계를 확인하는 방법.

## 사용자 가이드

- [환경 변수](https://ankole.agentbull.com/ko-KR/docs/worker-env/index.md): 명령줄 도구, MCP 서버, Background Agent Job에 필요한 환경 변수를 Console에서 구성하는 방법.
- [Agents](https://ankole.agentbull.com/ko-KR/docs/agents/index.md): Console에서 Agent를 만들고 소유자, 지속 동작, 모델, 기능, 환경 변수를 설정하는 방법을 설명합니다.
- [Signal routing 규칙](https://ankole.agentbull.com/ko-KR/docs/signal-bindings/index.md): chat application을 Agent에 연결하고 그룹 메시지 처리 방식을 선택하는 방법을 설명합니다.
- [Ambient intervention(주변 개입)](https://ankole.agentbull.com/ko-KR/docs/ambient-intervention/index.md): “May intervene” 그룹에서 Agent가 말할지 여부를 어떻게 결정하는지, 응답이 질문한 사람에게 어떻게 연결되는지, channel standing order가 언제 말할지 어떻게 알려 주는지 설명합니다.
- [Brain](https://ankole.agentbull.com/ko-KR/docs/brain/index.md): 대화, 파일, 웹페이지에서 출처를 추적할 수 있는 조직 지식을 축적하고, 명확한 공개 경계 안에서 Agent가 회상하고 수정하고 망각하도록 합니다.
- [Workflows](https://ankole.agentbull.com/ko-KR/docs/workflows/index.md): 고정되고 유한한 JavaScript로 독립적인 서브에이전트 task를 병렬로 실행하고 구조화된 결과를 결합합니다.
- [Background Agent Jobs](https://ankole.agentbull.com/ko-KR/docs/background-jobs/index.md): 현재 대화를 계속 사용할 수 있는 상태로, 재개 가능한 백그라운드 Job에 긴 작업을 위임합니다.
- [스케줄](https://ankole.agentbull.com/ko-KR/docs/schedules/index.md): 반복 작업에는 Cron을, 일회성 지연 후속 작업에는 Checkback을 사용하세요.
- [Automation Job](https://ankole.agentbull.com/ko-KR/docs/automation-jobs/index.md): 결정적(deterministic) 스크립트가 Cron, Checkback, Webhook 트리거를 소비하게 하세요. 기계적인 검사는 조용히 끝나고, Agent는 판단이 필요한 때만 깨어납니다.
- [Webhook 위임](https://ankole.agentbull.com/ko-KR/docs/webhook-delegations/index.md): Agent 또는 결정적 스크립트가 폴링 없이 저빈도 외부 이벤트를 기다릴 수 있게 합니다.
- [Image generation(이미지 생성)](https://ankole.agentbull.com/ko-KR/docs/image-generation/index.md): Agent용 이미지 모델을 선택하고 chat에서 이미지를 생성하거나 편집하는 방법을 설명합니다.
- [OCR 텍스트 인식](https://ankole.agentbull.com/ko-KR/docs/ocr/index.md): GPU나 외부 OCR 서비스 없이 Agent가 스캔한 PDF, 사진, 스크린샷, 영수증을 읽게 하세요.
- [파일 관리](https://ankole.agentbull.com/ko-KR/docs/file-management/index.md): 참고 자료를 업로드하고, Agent 산출물을 다운로드하며, Console에서 지속적인 Agent 파일을 관리하는 방법.
- [Agent Library](https://ankole.agentbull.com/ko-KR/docs/skills/index.md): Agent Plugins, Skills, Control Plane Plugins를 전역으로 또는 에이전트 하나에 대해 활성화합니다.
- [Web 도구](https://ankole.agentbull.com/ko-KR/docs/web-tools/index.md): Agent의 웹 검색과 페이지 읽기를 구성하고, 대신 브라우저를 사용해야 하는 상황을 알 수 있다.
- [Skill 교훈](https://ankole.agentbull.com/ko-KR/docs/skill-lessons/index.md): 공유 Skill을 변경하지 않고 각 Agent에 짧은 작업상 주의 사항을 제공합니다.
- [ChatGPT 구독 provider](https://ankole.agentbull.com/ko-KR/docs/chatgpt-subscription-provider/index.md): 디바이스 로그인과 공유 자격 증명 풀로 ChatGPT 구독을 AIGateway에 연결하는 방법.
- [Agent가 이미지를 읽을 수 있도록 하기](https://ankole.agentbull.com/ko-KR/docs/vision/index.md): Agent의 이미지 이해를 구성하고 채팅에서 스크린샷, 사진, 차트를 확인합니다.
- [AppConfigure](https://ankole.agentbull.com/ko-KR/docs/app-configuration/index.md): Console에서 Ankole AppConfigure 런타임 설정을 관리하고 내장 키를 참조합니다.
- [LLM observability](https://ankole.agentbull.com/ko-KR/docs/llm-observability/index.md): AIGateway LLM semantics가 포함된 선택적 cross-runtime Agent Turn trace를 OTLP/HTTP receiver로 export합니다.
- [Principal과 permission group](https://ankole.agentbull.com/ko-KR/docs/principal-and-groups/index.md): 사람과 조직 디렉터리를 동기화한 다음, directory, static 또는 computed group으로 액세스를 할당합니다.
- [Worker](https://ankole.agentbull.com/ko-KR/docs/worker-management/index.md): Console에서 Agent Computer Worker의 상태, 용량, heartbeat를 확인하고 흔한 장애를 해결하는 방법.
- [로그 읽기](https://ankole.agentbull.com/ko-KR/docs/log-reading/index.md): Docker Compose 또는 Kubernetes에서 Ankole 로그를 가져오고, 이벤트 이름과 컨텍스트 필드로 장애를 찾는 방법.

## 개발자 가이드

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

## 참조

- [kit CLI 레퍼런스](https://ankole.agentbull.com/ko-KR/docs/kit-cli/index.md): devkit 명령 표면 — 운영자나 contributor가 실행하는 모든 `bun run kit` 명령, 각 명령의 역할, 그리고 이를 감싸는 script에 대해 설명합니다.
- [MCP server 레퍼런스](https://ankole.agentbull.com/ko-KR/docs/mcp/index.md): Skill 기반 MCP dependency가 Main, Background, Automation 실행에 어떻게 들어가는지 설명합니다.
- [Deployment 환경 변수](https://ankole.agentbull.com/ko-KR/docs/environment-variables/index.md): control plane과 Agent Computer Worker가 프로세스 시작 시 읽는 deployment 설정을 설명합니다.
- [Console API 참조](https://ankole.agentbull.com/ko-KR/docs/console-api/index.md): Console이 사용하는 /api/v1 REST API에 대한 참조. 인증, 리소스 라우트, 권한 부여 동작을 다룹니다.
- [FAQ 및 문제 해결](https://ankole.agentbull.com/ko-KR/docs/faq/index.md): 관찰 가능한 증상에서 Ankole deployment, identity, model, Worker, 채팅 채널 실패를 진단합니다.

## 가이드

- [Deep Research로 장기 연구 실행하기](https://ankole.agentbull.com/ko-KR/docs/deep-research-job/index.md): 다중 소스 연구를 플러그 가능한 연구 방법을 사용하는 Background Agent Job으로 옮기고, 독립 검토를 거쳐 출처가 명시된 보고서를 전달합니다.
- [Git 통합](https://ankole.agentbull.com/ko-KR/docs/git-integration/index.md): Ankole Agent가 일반 대화 또는 Background Agent Job에서 git을 사용하는 방법.
- [Jupyter 데이터 분석](https://ankole.agentbull.com/ko-KR/docs/jupyter-data-analysis/index.md): 라이브 Jupyter kernel을 통해 반복적인 Python 데이터 분석을 실행하는 agent를 설정하는 방법 — jupyter-live-kernel skill, DataFrame 검사, 작업 예시.
- [브라우저 자동화](https://ankole.agentbull.com/ko-KR/docs/browser-automation/index.md): Ankole 에이전트가 실제 브라우저 세션을 구동하는 방식 — browser Skill, web_search/web_fetch 대신 사용해야 하는 상황, 활성화 방법, 그리고 에이전트가 사전 구성된 ankole-browser CLI를 반드시 사용하고 Chromium을 직접 실행하면 안 되는 이유.
- [PDF 생성](https://ankole.agentbull.com/ko-KR/docs/pdf-generation/index.md): PDF 파일을 만들고, 확인하고, 편집하는 agent를 설정하는 방법 — pdf skill, 사용하는 도구, 작업 예시.
- [Context.dev 웹 데이터](https://ankole.agentbull.com/ko-KR/docs/context-dev/index.md): Context.dev API를 통해 Agent에 bot 차단에 강한 페이지 읽기, 사이트 전체 크롤링, schema 형태의 추출, 브랜드 프로필, 예약된 변경 모니터링 기능을 제공합니다.
- [운영자 팁](https://ankole.agentbull.com/ko-KR/docs/tips/index.md): Ankole 운영 시 시간을 절약해 주는 검증된 짧은 요령 — 로그 읽기, 에이전트 범위 설정, 시크릿 순환, 멈춘 턴 복구, 모델 프로파일 다이얼 올바르게 설정하기.
- [자동화 블루프린트](https://ankole.agentbull.com/ko-KR/docs/automation-blueprints/index.md): 트리거를 Agent session, automation job, background job, 시그널 라우팅 규칙과 결합합니다.
- [비용 관리](https://ankole.agentbull.com/ko-KR/docs/cost-management/index.md): Ankole이 지출하는 금액을 통제하는 레버 — model-profile 계층, reasoning effort, web 도구 게이팅, agent-loop 예산, background-job 재시도, Workflow 호출 및 동시성 상한.
- [백업 및 복원](https://ankole.agentbull.com/ko-KR/docs/backup-and-restore/index.md): 반드시 백업해야 하는 두 가지 — PostgreSQL과 Agent Home — 의 백업 방법, 복원 방법, 그리고 테스트하지 않은 백업은 백업이 아닌 이유.
- [보안 강화](https://ankole.agentbull.com/ko-KR/docs/security-hardening/index.md): Ankole deployment instance 강화의 전체적인 형태 — 최소 권한(least authority), 비밀 관리 규율, SSRF, 자격 증명 회전, 최소 인그레스.
- [성능 튜닝](https://ankole.agentbull.com/ko-KR/docs/performance-tuning/index.md): 용량 노브 — 동시 턴, 데이터베이스 풀, Postgres 최대 연결, worker 턴 상한, 에이전트당 Job 슬롯 — 그리고 배포 인스턴스가 한 번에 처리할 수 있는 작업량을 결정하는 이들 사이의 관계.
- [재해 복구](https://ankole.agentbull.com/ko-KR/docs/disaster-recovery/index.md): Ankole 배포 인스턴스를 손실에서 복구하는 전체적인 형태 — 무엇을 복구할 수 있고 무엇을 복구할 수 없는지, 호스트 간 마이그레이션, 그리고 복구를 실제로 만드는 리허설을 다룹니다.
- [기여하기](https://ankole.agentbull.com/ko-KR/docs/contributing/index.md): 병합되는 Ankole 기여로 가는 길 — 규칙이 어디 있는지, 설정 방법, 올바른 검사를 실행하는 방법, 그리고 프로젝트가 요구하는 changelog와 PR 규율.

## 다른 언어

- [English](https://ankole.agentbull.com/en-US/llms.txt)
- [中文](https://ankole.agentbull.com/zh-Hans-CN/llms.txt)
- [日本語](https://ankole.agentbull.com/ja-JP/llms.txt)

## Optional

- [전체 문서](https://ankole.agentbull.com/ko-KR/llms-full.txt): 이 언어의 모든 페이지를 하나의 Markdown 파일로 묶은 것