Documentation

ドキュメント

Division API と Orchestra IDE の公式ドキュメントです。 AIエージェントの構築・統合・カスタマイズに必要な情報をまとめています。

はじめに

Division APIは、複数のAIモデルを役割ベースで自動振り分けるオーケストレーションAPIです。 1つのリクエストで、Leader AIがタスクを分解し、最適なAIモデルが並列・直列に実行して最終成果物を返します。

実行フロー

ユーザー: 「クイズアプリを作って」
  |
Leader AI (GPT-4.1) — タスクを分析・分解 + finalRole を決定
  |
  +-- 並列実行
  |     Searcher  ->  Perplexity
  |     Planner   ->  Gemini
  |     Ideaman   ->  Claude
  |
  +-- 直列実行（依存タスク）
  |     Coder     ->  Claude
  |     Reviewer  ->  Gemini
  |
Writer / Coder — 全出力を統合（合成ステップ）
  |
最終成果物を Markdown で返却

認証

すべてのAPIリクエストに Division API キーを含めます。

Authorization: Bearer div_...

クイックスタート

curl -N -X POST https://api.division.he-ro.jp/api/agent/stream \
  -H "Authorization: Bearer div_..." \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "your-project-id",
    "input": "クイズアプリを作って",
    "format": "sse"
  }'

Orchestra IDE

Orchestraは、Division APIを活用して動作するAIネイティブな統合開発環境（IDE）です。 He-roが開発し、コーディングの体験そのものをAIで再定義することを目指しています。

AIネイティブエディタ

コードを書きながらリアルタイムで補完・提案・リファクタリング。Division APIの145+モデルがバックエンドで稼働。

ロールベース AIアシスタント

coding・search・review・planningなどタスクに応じて最適なAIモデルが自動切り替え。

マルチモデルスイッチ

ワンクリックでAIモデルを切り替え。Anthropic・Google・OpenAI・Perplexity・xAI・DeepSeekが利用可能。

MCP統合ターミナル

内蔵ターミナルからDivision APIのMCPツールに直接アクセス。

注意

Orchestra IDEのAI機能を利用するには有料プランへの加入が必要です。 Division APIのアカウントを作成し、orchestra_plusプランに加入することでフル機能がアンロックされます。

Orchestra をダウンロード

Orchestraのセットアップ

Orchestra IDEを使い始めるための完全なガイドです。インストール、初期設定、APIキー設定、そして基本的な使い方まで、すべてを網羅しています。

1. インストール

最新版のOrchestra IDEをダウンロードしてインストールします。

# MacOS
brew install orchestra-ide

# Windows / Linux
# https://orchestra.he-ro.jp/download からダウンロード

2. Division APIキーの設定

Orchestraを起動したら、Division APIキーを設定します。

手順

  1. メニューバーから Settings を開く
  2. API Keys タブを選択
  3. Division API Key フィールドに div_... から始まるキーを貼り付け
  4. Save をクリック

3. AIモデルの選択

Orchestraの右下にあるモデルセレクターで、使用するAIモデルを選択できます。

ヒント

複数のモデルを試すには、セレクターから別のモデルを選択するだけです。 設定を保存する必要はありません。すべての設定は自動的に保存されます。

4. 基本的な使い方

コード補完

エディタでコードを入力中に、AIが自動的に補完・提案を表示します。Tab キーで提案を受け入れるか、Escape キーで閉じます。

コード生成

Cmd+K (Mac) または Ctrl+K (Windows/Linux) を押して、 要件を説明すればコードが生成されます。

リファクタリング

コードを選択して、コンテキストメニューから「Refactor」を選択します。 AIが自動的にコードを改善し、複数の提案を表示します。

5. ターミナル内蔵とMCP連携

Orchestra IDEのターミナルでは、Division APIのMCPツールに直接アクセスできます。

# ターミナル内で直接実行可能
division_run --project your-project-id --input "FizzBuzzを書いて"

# または対話的に実行
division_stream --project your-project-id --format sse

トラブルシューティング

Q — APIキーが無効と言われる

Division APIダッシュボードで新しいキーを生成し直してください。 古いキーは無効になっている可能性があります。

Q — 補完が動作しない

Orchestraを再起動し、Settings → API Keys でキーが正しく設定されているか確認してください。 ネットワーク接続も確認しましょう。

Divisionプロジェクト設定

Division APIの動作をカスタマイズするには、プロジェクトルートの agents.json ファイルを設定します。 各ロール（role）に対して、使用するAIモデルをプロバイダー（provider）から選択して割り当てられます。

agents.json ファイルの構造

{
  "activeProjectIds": [
    "d9a0ad4e-dcda-40ac-b8aa-183d4f412674"
  ],
  "projects": [
    {
      "projectId": "d9a0ad4e-dcda-40ac-b8aa-183d4f412674",
      "name": "Division Project",
      "agents": [
        {
          "role": "leader",
          "provider": "OpenAI",
          "model": "gpt-4.1"
        },
        {
          "role": "coder",
          "provider": "Anthropic",
          "model": "claude-opus-4-7"
        },
        {
          "role": "reviewer",
          "provider": "Anthropic",
          "model": "claude-opus-4-7"
        }
        // ... その他のロール
      ]
    }
  ]
}

設定の詳細

activeProjectIds

このプロジェクトで有効なプロジェクトIDのリストです。複数のプロジェクトを定義する場合、 ここで有効にするプロジェクトIDを指定してください。

projectId

プロジェクトの一意なID。Division APIダッシュボードで確認できます。 APIリクエストを送信する際、このIDを指定します。

name

プロジェクトの表示名です。管理画面やログで使用されます。

agents (ロール設定)

各ロールに割り当てるAIモデルを指定します。以下の構成です：

  • role: ロール名 (leader, coder, reviewer, planner, designer, searcher など)
  • provider: プロバイダー名 (OpenAI, Anthropic, Google, Perplexity, xAI, DeepSeek)
  • model: 具体的なモデル名

ロールと推奨モデルの組み合わせ

ロール推奨プロバイダー推奨モデル
leaderOpenAIgpt-4.1 (タスク分解に最適)
coderAnthropicclaude-opus-4-7 (コード生成に高性能)
reviewerAnthropic / Googleclaude-opus-4-7 / gemini-2.5-pro
searcherPerplexitysonar-pro (ウェブ検索に特化)
plannerGooglegemini-2.5-pro (戦略立案に強い)
designerGooglegemini-2.5-pro (ビジュアルコンテンツ生成)
writerOpenAIgpt-4.1 (文章品質が高い)

agents.json をカスタマイズする

デフォルト設定から特定のロールのモデルだけを変更したい場合：

{
  "activeProjectIds": ["d9a0ad4e-dcda-40ac-b8aa-183d4f412674"],
  "projects": [
    {
      "projectId": "d9a0ad4e-dcda-40ac-b8aa-183d4f412674",
      "name": "My Custom Division Project",
      "agents": [
        {
          "role": "leader",
          "provider": "OpenAI",
          "model": "gpt-5.4"  // 最新のモデルを使用
        },
        {
          "role": "coder",
          "provider": "DeepSeek",  // Deepseekに変更
          "model": "deepseek-r1"
        },
        {
          "role": "searcher",
          "provider": "Perplexity",
          "model": "sonar-deep-research"  // 深い調査に対応
        }
        // その他のロール...
      ]
    }
  ]
}

複数プロジェクトを管理する

複数のプロジェクトを定義して、異なるモデル構成を使い分けられます：

{
  "activeProjectIds": [
    "project-1-id",
    "project-2-id"
  ],
  "projects": [
    {
      "projectId": "project-1-id",
      "name": "Web Development Project",
      "agents": [ /* 高性能モデルを集中 */ ]
    },
    {
      "projectId": "project-2-id",
      "name": "Content Creation Project",
      "agents": [ /* ライティング重視のモデル */ ]
    }
  ]
}

設定変更の反映

自動反映

agents.json を編集して保存すると、Division APIは自動的に新しい設定を読み込みます。 APIの再起動は不要です。

APIリファレンス

Base URL: https://api.division.he-ro.jp

POST /api/agent/stream — マルチエージェントストリーミング

リアルタイムでマルチエージェントの実行状況をSSEストリームで受信できます。 依存関係のないタスクは並列実行され、最後に合成ステップで統合されます。

curl -N -X POST https://api.division.he-ro.jp/api/agent/stream \
  -H "Authorization: Bearer div_..." \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "your-project-id",
    "input": "FizzBuzzを書いて",
    "format": "sse"
  }'

SSEイベント一覧

イベント説明
session_startセッション開始（sessionId含む）
leader_startLeader AIがタスク分解を開始
leader_doneタスク分解完了（依存関係・finalRole情報）
wave_start並列実行グループの開始
task_startサブタスク実行開始
task_chunkサブタスクAIからのストリーミングテキスト
task_doneサブタスク完了（出力含む）
synthesis_start合成ステップ開始（Coder/Writerが全出力を統合）
synthesis_done合成完了（最終Markdown出力）
session_done全タスク完了（集計結果含む）

POST /api/agent/run — エージェント実行（非ストリーム）

curl -X POST https://api.division.he-ro.jp/api/agent/run \
  -H "Authorization: Bearer div_..." \
  -H "Content-Type: application/json" \
  -d '{"projectId": "your-project-id", "input": "FizzBuzzを書いて"}'

overrides — モデル切り替え

overrides パラメータで、特定の役割に使うAIを自由に切り替えできます。

{
  "projectId": "your-project-id",
  "input": "コードをレビューして",
  "overrides": {
    "coder": "deepseek-r1",
    "searcher": "grok-3",
    "reviewer": "gpt-4.1",
    "planner": "gemini-2.5-pro"
  }
}

対応モデル（145以上 / 6プロバイダー）

プロバイダーAPIからリアルタイムで取得。モデル数は自動同期により常に最新です（Vercel Cron: UTC 04:00）。

プロバイダー主要モデル
OpenAIGPT-4.1, GPT-4.1 Mini/Nano, GPT-4o, o3/Mini
AnthropicClaude Opus 4, Sonnet 4.5, Haiku 4.5
GoogleGemini 2.5 Pro/Flash, Gemini 2.0 Flash
PerplexitySonar Deep Research, Sonar Reasoning Pro, Sonar Pro
xAIGrok 4, Grok 3/Mini
DeepSeekDeepSeek Chat (V3), DeepSeek Reasoner (R1)

ロール設計

Division APIはタスクの種類に応じて最適なAIモデルを自動で割り当てます。 全エージェントの作業完了後、Leader が指定した finalRole（coder または writer）が全出力を統合して最終成果物を生成します。

ロールデフォルトAI説明
leaderGPT-4.1タスク分解・統括・finalRole決定
coderClaudeコード生成・実装・デバッグ
searcherPerplexity Sonar Proウェブ検索・情報収集
plannerGemini企画・設計・戦略立案
writerOpenAI文章作成・ドキュメント
reviewerGeminiレビュー・品質確認
researcherPerplexity Deep Research徹底調査・包括的分析
designerGeminiUI/UXデザイン・HTML生成
imagerGPT Image 1画像生成・ビジュアルコンテンツ
ideamanClaudeアイデア発想・ブレインストーミング

MCP統合

Cursor / Antigravity / Claude Desktop / Orchestra のMCP設定に追加するだけで Division API を IDE から直接利用できます。

接続設定

{
  "mcpServers": {
    "division": {
      "url": "https://api.division.he-ro.jp/mcp?key=div_..."
    }
  }
}

利用可能なMCPツール

ツール説明
division_runAIエージェントにタスクを実行させる
division_streamストリーミング付きでエージェントを実行する
division_list_models利用可能な全モデルを一覧表示
division_healthAPIの稼働状態を確認

Division APIを試してみる

アカウントを作成してAPIキーを取得。すぐに145以上のAIモデルが使えます。

無料で始めるOrchestra IDEをダウンロード