# Ankole

> Ankole は、Company Brain を備えたオープンソースの Claude Tag 代替製品です。企業向け Agent Harness が、社内の意思決定に必要な共有コンテキストを Agent に提供します。

AI Agent 向けの Ankole ドキュメントです。各ページのリンクは、そのページの Markdown 版を開きます。

Ankole インスタンスをデプロイまたは設定するときは、まず [クイックスタート](https://ankole.agentbull.com/ja-JP/docs/quickstart/index.md) を読んでください。すべてのデプロイ方法、アイデンティティプロバイダー、LLM Provider、チャットチャネルを扱います。障害の原因を調べるときは [FAQ とトラブルシューティング](https://ankole.agentbull.com/ja-JP/docs/faq/index.md) を読んでください。

## はじめに

- [はじめに](https://ankole.agentbull.com/ja-JP/docs/introduction/index.md): Ankole Agent Harness と Company Brain が提供する機能と、専用環境に配置したインスタンスの動作を説明します。
- [クイックスタート](https://ankole.agentbull.com/ja-JP/docs/quickstart/index.md): Ankole をデプロイし、エンタープライズの identity とモデルを設定し、IM チャンネルを接続して、実際の Agent との会話を完了させます。
- [アダプター設定ガイド](https://ankole.agentbull.com/ja-JP/docs/adapter-configuration/index.md): 各 Ankole の Identity と chat アダプターについて、アプリの種類、credential、権限、検証手順を調べる。

## ユーザーガイド

- [環境変数](https://ankole.agentbull.com/ja-JP/docs/worker-env/index.md): コマンドラインツール、MCP サーバー、Background Agent Job が必要とする環境変数を Console で設定する。
- [Agents](https://ankole.agentbull.com/ja-JP/docs/agents/index.md): Console で Agent を作成し、所有者、永続的な動作、モデル、機能、環境変数を設定する方法を説明します。
- [シグナルルーティングルール](https://ankole.agentbull.com/ja-JP/docs/signal-bindings/index.md): チャットアプリを Agent に接続し、グループメッセージの処理方法を選択します。
- [アンビエント介入](https://ankole.agentbull.com/ja-JP/docs/ambient-intervention/index.md): Agent が「May intervene」グループでいつ発言するかをどう判断するか、返信がどのように質問した人に紐付くか、channel standing orders がいつ発言すべきかをどう伝えるか。
- [Brain](https://ankole.agentbull.com/ja-JP/docs/brain/index.md): 会話、ファイル、Web ページから出所を追跡できる組織知識を蓄積し、明確な開示境界の中で Agent が想起、修正、忘却できるようにします。
- [Workflow](https://ankole.agentbull.com/ja-JP/docs/workflows/index.md): 有界の作業を並行するサブエージェントに分け、構造化された 1 つの結果を元の会話で受け取ります。
- [Background Agent Jobs](https://ankole.agentbull.com/ja-JP/docs/background-jobs/index.md): 現在の会話を利用可能なまま、再開可能なバックグラウンド Job に長い作業を委任します。
- [スケジュール](https://ankole.agentbull.com/ja-JP/docs/schedules/index.md): 定期的な作業には Cron を使い、一度だけの遅延フォローアップには Checkback を使います。
- [Automation Jobs](https://ankole.agentbull.com/ja-JP/docs/automation-jobs/index.md): 決定論的なスクリプトで Cron、Checkback、Webhook のトリガーを受け止める。機械的なチェックは静かに完了し、判断が必要なときだけ Agent が起きる。
- [Webhook 委譲](https://ankole.agentbull.com/ja-JP/docs/webhook-delegations/index.md): Agent または決定性スクリプトが、ポーリングなしで低頻度の外部イベントを待てるようにします。
- [画像生成](https://ankole.agentbull.com/ja-JP/docs/image-generation/index.md): Agent 用の画像 model を選択し、チャットで画像を生成または編集する。
- [OCR テキスト認識](https://ankole.agentbull.com/ja-JP/docs/ocr/index.md): GPU も外部の OCR サービスも使わずに、Agent にスキャンした PDF、写真、スクリーンショット、領収書を読ませる方法。
- [ファイル管理](https://ankole.agentbull.com/ja-JP/docs/file-management/index.md): Console で参照資料をアップロードし、Agent の成果物をダウンロードし、Agent の永続ファイルを管理します。
- [Agent Library](https://ankole.agentbull.com/ja-JP/docs/skills/index.md): Agent Plugin、Skill、Control Plane Plugin を、全体または 1 つの Agent に対して有効化します。
- [Web ツール](https://ankole.agentbull.com/ja-JP/docs/web-tools/index.md): Agent の web 検索とページ読み取りを設定し、代わりにブラウザを使うべき場面を見極めます。
- [Skill 教訓](https://ankole.agentbull.com/ja-JP/docs/skill-lessons/index.md): 共有 Skill を変更せずに、各 Agent へ短い作業上の注意事項を届けます。
- [ChatGPT サブスクリプション Provider](https://ankole.agentbull.com/ja-JP/docs/chatgpt-subscription-provider/index.md): デバイスログインと共有 credential pool で ChatGPT サブスクリプションを AIGateway に接続します。
- [Agent に画像を読ませる](https://ankole.agentbull.com/ja-JP/docs/vision/index.md): Agent に画像理解を設定し、chat でのスクリーンショット、写真、図の読み取りを検証する。
- [AppConfigure](https://ankole.agentbull.com/ja-JP/docs/app-configuration/index.md): Console で Ankole の AppConfigure 実行時設定を管理し、組み込みの設定キーを参照します。
- [LLM observability](https://ankole.agentbull.com/ja-JP/docs/llm-observability/index.md): AIGateway LLM semantics を含む optional cross-runtime Agent Turn trace を OTLP/HTTP receiver に export します。
- [Principal と permission group](https://ankole.agentbull.com/ja-JP/docs/principal-and-groups/index.md): 人と組織ディレクトリを同期し、directory group、static group、computed group でアクセスを割り当てます。
- [Worker](https://ankole.agentbull.com/ja-JP/docs/worker-management/index.md): Console で Agent Computer Worker の状態、容量、heartbeat を確認し、よくある障害を解決する。
- [ログの読み方](https://ankole.agentbull.com/ja-JP/docs/log-reading/index.md): Docker Compose または Kubernetes から Ankole のログを取得し、イベント名と context フィールドを使って障害箇所を特定します。

## 開発者ガイド

- [アーキテクチャ](https://ankole.agentbull.com/ja-JP/docs/architecture/index.md): control plane、Agent Computer Worker、Actor Runtime、Brain、Background Agent Job が Ankole Agent Harness をどう構成するかを説明します。
- [AIGateway API](https://ankole.agentbull.com/ja-JP/docs/ai-gateway/index.md): OpenResponses 互換の AI boundary。HTTP、SSE、WebSocket endpoint、stateless と stateful の呼び出し、provider routing について説明します。
- [SignalsGateway](https://ankole.agentbull.com/ja-JP/docs/signals-gateway/index.md): 共有作業の入口レイヤー——chat、webhook、provider イベントが、ソースの事実を実行状態に書き換えることなく actor イベントになる仕組み。
- [Actor Runtime](https://ankole.agentbull.com/ja-JP/docs/actor-runtime/index.md): 長時間実行のセッションがどのように生き、目覚め、失敗し、復旧するか——actor key、OTP の失敗ドメイン、activation フェンス、RuntimeFabric のライブパス。
- [Background Agent Jobs](https://ankole.agentbull.com/ja-JP/docs/background-agent-jobs/index.md): worker の損失を生き延びる永続的で再開可能な作業 — Job ステートマシン、入力待ち、owner の wakeup、Actor Runtime との境界。
- [Principal と AuthZ](https://ankole.agentbull.com/ja-JP/docs/principal-authz/index.md): Ankole デプロイメントインスタンスの権限境界 — 説明責任のある主体としての Principal、権限 grant、グループメンバーシップ、プロンプトの慣習ではなくランタイムによる強制。
- [Agent Library](https://ankole.agentbull.com/ja-JP/docs/agent-library/index.md): Agent にできること——Skill はファイルシステム上の bundle として、Agent Plugin は Codex パッケージとして扱い、Agent ごとに「既定 → 上書き」で解決する有効化モデル。
- [Agent Computer Worker](https://ankole.agentbull.com/ja-JP/docs/agent-computer-worker/index.md): Bun と TypeScript の Worker が、コントロールプレーンが各ターンをフェンス管理する一方で、モデルループ、ツール、ファイル、ターミナル状態、ストリーミング出力をどのように実行するか。
- [Rust Kernel](https://ankole.agentbull.com/ja-JP/docs/kernel/index.md): 共有ネイティブレイヤー。認可、RuntimeFabric transport、AI データプレーンのプリミティブの 1 つの Rust 実装であり、Elixir control plane と Bun worker の両方からロードされます。
- [Control Plane Plugins](https://ankole.agentbull.com/ja-JP/docs/control-plane-plugins/index.md): ファーストパーティの Elixir 拡張モデル — 発見・アクティブな plugin、サブシステム契約、AppConfigure キー、監督付き子プロセス、次回起動時の有効化境界。
- [Skill と Control Plane Plugin の開発](https://ankole.agentbull.com/ja-JP/docs/writing-a-skill/index.md): Agent に仕事の方法を追加するか、identity、channel、configuration、監督下の service を control plane に追加します。
- [Worker CLI の機能](https://ankole.agentbull.com/ja-JP/docs/cli-capabilities/index.md): Agent の機能を、--help が契約を担う shell コマンドとして出荷し、Agent が関連する判断をする場所に一文のポインタを配置します。
- [Provider の追加](https://ankole.agentbull.com/ja-JP/docs/adding-a-provider/index.md): AIGateway provider の宣言方法。DSL、コンパイルされた定義、設定、能力、prepare 関数、plugin ベースの登録について説明します。
- [Context の圧縮とコンパクション](https://ankole.agentbull.com/ja-JP/docs/context-compression-and-caching/index.md): Ankole が長い会話をモデルのコンテキスト内に保つ仕組み — AIGateway による自動履歴コンパクションと、逐語的なユーザー原文の保持。
- [Agent ループ](https://ankole.agentbull.com/ja-JP/docs/agent-loop/index.md): コントロールプレーンのターンライフサイクルと worker 側の agent ループの境界 — 各側が所有するもの、通信方法、反復予算と再試行の所在。
- [プロンプト組み立て](https://ankole.agentbull.com/ja-JP/docs/prompt-assembly/index.md): agent が毎ターン見るシステムプロンプトがどう構築されるか — コントロールプレーンのデータ provider、それを worker に運ぶ 2 つの channel、最終プロンプトを生成する worker 側の組み立て。
- [Provider ランタイム](https://ankole.agentbull.com/ja-JP/docs/provider-runtime/index.md): AIGateway が selector を provider に解決し、準備済みリクエストを構築し、kernel を通じてディスパッチする仕組み — モデル呼び出しから provider 応答までの 3 つの段階。
- [Tool ランタイム](https://ankole.agentbull.com/ja-JP/docs/tools-runtime/index.md): Worker が Turn ごとの tool を schema 化して dispatch する仕組み。メイン Turn の Workflow tool と、制限された Workflow タスクの tool catalog を含みます。
- [軌跡とメッセージ形式](https://ankole.agentbull.com/ja-JP/docs/trajectory-format/index.md): Ankole が会話メッセージとBackground Agent Jobの軌跡をどう保存・プロジェクションするか — 2 つの保存形状、ChatML の正規形式、モデルが見るプロジェクション。
- [コード実行](https://ankole.agentbull.com/ja-JP/docs/code-execution/index.md): Ankole の Agent が、通常の会話または永続的な Background Agent Job としてコードを実行する方法。
- [MCP-backed Skill を使う](https://ankole.agentbull.com/ja-JP/docs/using-mcp/index.md): 有効化された Skill が、mcporter を通じて Agent または Automation スクリプトを MCP server にルーティングする方法。
- [Todo と clarify](https://ankole.agentbull.com/ja-JP/docs/todo-and-clarify/index.md): Ankole の Agent が複雑なタスクを計画し、作業の途中で実際の曖昧さを解決する方法——todo ツール（session ごと、進行中の項目は最大 1 つ）と clarify ツール（判断の質問を 1 つあて、恒久的に記録し、その Turn を終了する）。Agent がそれぞれをどう使うか、operator が何を期待すべきでないか。
- [監査証跡](https://ankole.agentbull.com/ja-JP/docs/audit-trail/index.md): Ankole の監査面の読み方——AuthZ の付与記録、control-plane の構造化ログ、そしてそれぞれが誰がいつ何を変えたかをどう記録するか。
- [AIGateway API の使い方](https://ankole.agentbull.com/ja-JP/docs/aigateway-api-usage/index.md): 外部の呼び出し側が AIGateway REST API を使う方法——OpenResponses 互換エンドポイント、agent と admin の token の違い、ステートレス/ステートフル呼び出し、実践例。

## リファレンス

- [kit CLI リファレンス](https://ankole.agentbull.com/ja-JP/docs/kit-cli/index.md): devkit のコマンドサーフェス — オペレーターやコントリビューターが実行するすべての `bun run kit` コマンドと、それをラップするスクリプト。
- [MCP server リファレンス](https://ankole.agentbull.com/ja-JP/docs/mcp/index.md): Skill バックの MCP 依存関係が、Main、Background、Automation の各実行にどのように入るかです。
- [デプロイメント環境変数](https://ankole.agentbull.com/ja-JP/docs/environment-variables/index.md): control plane と Agent Computer Worker がプロセス起動時に読み取るデプロイメント設定のリファレンス。
- [Console API リファレンス](https://ankole.agentbull.com/ja-JP/docs/console-api/index.md): Console が使用する /api/v1 REST API のリファレンス。認証、リソースの route、authorization action を含みます。
- [FAQ とトラブルシューティング](https://ankole.agentbull.com/ja-JP/docs/faq/index.md): 観察できる症状から、Ankole の deployment、identity、model、Worker、chat channelの障害を特定します。

## ガイド

- [Deep Research で長時間の調査を実行する](https://ankole.agentbull.com/ja-JP/docs/deep-research-job/index.md): 複数ソースの調査を Background Agent Job に移し、プラグ可能な調査方法で、独立したレビュー後に出典付きのレポートを納品します。
- [Git 統合](https://ankole.agentbull.com/ja-JP/docs/git-integration/index.md): Ankole Agent が通常の会話または Background Agent Job で git をどのように使うか。
- [Jupyter データ分析](https://ankole.agentbull.com/ja-JP/docs/jupyter-data-analysis/index.md): ライブ Jupyter kernel で反復的な Python データ分析を実行する agent のセットアップ方法 — jupyter-live-kernel skill、DataFrame の検査、実践例。
- [ブラウザ自動化](https://ankole.agentbull.com/ja-JP/docs/browser-automation/index.md): Ankole の Agent が実際のブラウザセッションを操作する仕組み——browser Skill、web_search/web_fetch の代わりに使うべき場面、有効化の方法、そして Agent が Chromium を自前で起動せず、事前設定済みの ankole-browser CLI を使わなければならない理由。
- [PDF 生成](https://ankole.agentbull.com/ja-JP/docs/pdf-generation/index.md): PDF ファイルを作成・検査・編集する agent の設定方法——pdf skill、それを使うツール、完全な例。
- [Context.dev のウェブデータ](https://ankole.agentbull.com/ja-JP/docs/context-dev/index.md): Context.dev API を通じて、Agent に bot 対策済みのページ読み取り、サイト全体のクロール、スキーマ形状の抽出、ブランドプロフィール、スケジュールされた変更監視を提供する。
- [運用のヒント](https://ankole.agentbull.com/ja-JP/docs/tips/index.md): Ankole を運用するときに時間を節約できる、検証済みの短い手順 — ログの読み方、Agent のスコープ、secret のローテーション、詰まった Turn からの回復、model profile スロットの調整。
- [自動化ブループリント](https://ankole.agentbull.com/ja-JP/docs/automation-blueprints/index.md): トリガーを Agent session、automation job、background job、signal ルーティングルールと組み合わせ、Workflow との違いを説明します。
- [コスト管理](https://ankole.agentbull.com/ja-JP/docs/cost-management/index.md): Ankole の支出を制御するレバー——model profile、reasoning effort、web ツール、agent ループ予算、Workflow の fanout、background job の再試行とスロット上限。
- [バックアップとリストア](https://ankole.agentbull.com/ja-JP/docs/backup-and-restore/index.md): バックアップしなければならない 2 つのもの — PostgreSQL と Agent Home — のバックアップ方法、リストア方法、そして未テストのバックアップがバックアップではない理由。
- [セキュリティの強化](https://ankole.agentbull.com/ja-JP/docs/security-hardening/index.md): Ankole デプロイインスタンスを強化する end-to-end の形——最小権限、secret の規律、SSRF、credential のローテーション、最小限のネットワーク入り口。
- [パフォーマンスチューニング](https://ankole.agentbull.com/ja-JP/docs/performance-tuning/index.md): 容量ノブ — 同時ターン、データベースプール、Postgres の最大接続数、worker ターン上限、agent ごとの Job スロット — と、デプロイメントインスタンスが一度にどれだけ処理できるかを決める、それらの間の関係。
- [ディザスタリカバリ](https://ankole.agentbull.com/ja-JP/docs/disaster-recovery/index.md): Ankole の導入インスタンスを消失から復旧する全容——何が復旧できて何ができないか、クロスホスト移行、そして復旧を現実のものにするリハーサル。
- [コントリビューション](https://ankole.agentbull.com/ja-JP/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/ko-KR/llms.txt)

## Optional

- [ドキュメント全文](https://ankole.agentbull.com/ja-JP/llms-full.txt): この言語のすべてのページを 1 つの Markdown ファイルにまとめたもの