Orchestra
Plusを始める
Documentation

ドキュメント

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


はじめに

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

実行フロー

ユーザー: 「クイズアプリを作って」
  |
Leader AI (GPT-6 Astra) — タスクを分析・分解 + 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.io/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の最新モデルがバックエンドで稼働。

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

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

マルチモデルスイッチ

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

MCP統合ターミナル

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

注意

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

Orchestra をダウンロード

Orchestraのセットアップ

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

1. インストール

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

# macOS / Windows / Linux
# Orchestra公式ページからインストーラーをダウンロード
# https://division.he-ro.io/orchestra

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は、内蔵チャットとMCP連携を通じてDivision APIを利用します。 Division専用のコマンドラインツールは提供していません。コマンドを直接実行するのではなく、 Orchestraのチャットから依頼するか、対応するMCPクライアントへ接続してください。

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

トラブルシューティング

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-6.1-sol"
        },
        {
          "role": "coder",
          "provider": "Anthropic",
          "model": "claude-opus-5-5"
        },
        {
          "role": "reviewer",
          "provider": "Anthropic",
          "model": "claude-opus-5-5"
        }
        // ... その他のロール
      ]
    }
  ]
}

設定の詳細

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-6-astra (タスク分解に最適)
coderAnthropicclaude-opus-5-5 (コード生成に高性能)
reviewerAnthropic / Googleclaude-opus-5-5 / gemini-3.1-pro-preview
searcherPerplexitysonar-pro (ウェブ検索に特化)
plannerGooglegemini-3.1-pro-preview (戦略立案に強い)
designerGooglegemini-3.8-flash (ビジュアルコンテンツ生成)
writerOpenAIgpt-5.6-terra (文章品質が高い)

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-6-astra"  // 最新のモデルを使用
        },
        {
          "role": "coder",
          "provider": "DeepSeek",  // Deepseekに変更
          "model": "deepseek-v4-pro"
        },
        {
          "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.io

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

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

curl -N -X POST https://api.division.he-ro.io/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.io/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-v4-pro",
    "searcher": "grok-4.7",
    "reviewer": "gpt-6.1-sol",
    "planner": "gemini-3.1-pro-preview"
  }
}

対応モデル(最新モデル / 9プロバイダー)

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

プロバイダー主要モデル
OpenAIGPT-6.1 Sol, GPT-6 Astra/Luna, GPT-5.6 Terra, o3 Deep Research, GPT Image 2.5
AnthropicClaude Fable 5.1, Opus 5.5, Sonnet 5.5, Haiku 4.5
GoogleGemini 3.8 Flash, Gemini 3.1 Pro Preview, Gemini 3.5 Flash Lite, Antigravity Agent Preview, Nano Banana Pro / 2
PerplexitySonar Deep Research, Sonar Reasoning Pro, Sonar Reasoning, Sonar Pro, Sonar
xAIGrok 4.7, Grok Build 0.1, Grok Imagine Image 2.0 / Video 1.5
DeepSeekDeepSeek V4 Pro, DeepSeek Flash
Moonshot AIKimi K3, Kimi K2.7 Code, K2.7 Code Highspeed, Kimi K2.6
v0v0 Max, v0 Pro, v0 Mini
TypeSafe APIJEV (jev-latest)

ロール設計

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

ロールデフォルトAI説明
leaderGPT-6 Astraタスク分解・統括・finalRole決定
coderClaude Sonnet 5.5コード生成・実装・デバッグ
searcherPerplexity Sonar Reasoning Proウェブ検索・情報収集
plannerGemini 3.1 Pro Preview企画・設計・戦略立案
writerGPT-5.6 Terra文章作成・ドキュメント
reviewerClaude Opus 5.5レビュー・品質確認
researcherPerplexity Sonar Deep Research徹底調査・包括的分析
designerGemini 3.8 FlashUI/UXデザイン・HTML生成
imagerNano Banana 2画像生成・ビジュアルコンテンツ
ideamanClaude Sonnet 5.5アイデア発想・ブレインストーミング

MCP統合

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

接続設定

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

利用可能なMCPツール

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

Division APIを試してみる

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