Hane Platform

Hane Platform とは

業務アプリと AI エージェントが、共通のデータ・Workflow・承認・監査の上で動くための AI 業務プラットフォームの全体像を説明します。

このページでは、Hane Platform が何を解決するのか、誰のためのものか、どんな部品でできていて、それらがどう組み合わさるのかを説明します。

解決すること

業務アプリを個別に作ると、データの持ち方、承認の流れ、権限、監査の記録をアプリごとに作り直すことになります。そこに AI エージェントを加えると、「AI に何を読ませてよいか」「外へのメールや電話を誰が承認したか」「あとから何が起きたかを追えるか」も決めなければなりません。

Hane Platform は、これらを共通のサービスとして提供する AI 業務プラットフォームです。顧客の業務アプリと AI エージェントは、同じ業務データ・Workflow・承認・監査の上で動きます。アプリごとに作るのは、画面とその業務に固有の処理だけです。

業務データは、型と項目の定義に従って保存します。値ごとに「確定・推定・要照会・不明」の値の状態と、どこから来たかという出典を持ちます。
業務の進め方は Workflow として定義します。人の判断や作業は Task として担当に割り当てます。
AI エージェントが外へ影響する操作（メールの送信、電話、外部システムの更新など）を提案したときは、決めたポリシーに従って承認を通してから実行します。
操作はすべて、誰が、何を、どの権限で行ったかを監査に残します。

Hane は顧客に同じデータモデルや画面を押し付けません。型・Workflow・承認の規則は顧客ごとにマニフェストで定義し、実行・認可・監査の仕組みを共通にします。

誰のためのものか

読者	主にすること
顧客企業の開発者	公開 API・SDK・hanectl で業務アプリを作り、型や Workflow などの定義をマニフェストで管理する
組織の管理者	メンバーとロール、サービスアカウントと API キーを管理し、必要なら緊急停止をかける。監査ログを確かめる
業務の利用者・運用担当	業務アプリやコンソールで Task を処理し、承認を決め、案件の進み具合を見る

主な部品

部品	内容
Platform のサービス	組織・業務データ・定義・Workflow・承認・Agent・文書・Communication・外部接続・監査などのサービス。それぞれが `/v1/<サービス>/...` の公開 API を持つ
コンソール	組織の管理者・開発者・運用担当が使う Web の画面。定義と動いているものを見て、承認の決定、失敗した案件の再試行、緊急停止などの操作を行う
SDK と hanectl	TypeScript の SDK（`@hane/sdk`）で公開 API を呼ぶ。hanectl はマニフェストの検証・差分・apply と、ReleaseBundle の作成・昇格・有効化を行う CLI
Hane Cowork プレビュー	利用者の PC で動くデスクトップアプリ。Platform の認証・モデル・組織の設定を使い、手元のファイルやブラウザでの作業を進める

どう組み合わさるか

  顧客の業務アプリ ──┐
  コンソール ────────┤
  hanectl・SDK ─────┼──▶ 公開 API の入口 ──▶ Platform のサービス
  Hane Cowork ──────┘    （認証・レート制限）   業務データ・Workflow・承認・Agent・文書 …
                                                    │
                                                    ▼
                                 共通の土台：認可・秘密値・使用量・監査

顧客の業務アプリ、コンソール、hanectl は、どれも同じ公開 API を呼びます。コンソール専用の裏口はなく、画面からの操作も API と同じ認可・承認・監査を通ります。
型・Workflow・承認の規則・Agent などの定義は、Git で管理する YAML のマニフェストに書き、hanectl か Git からの同期で反映します。コンソールでは定義を変えません。
業務データ・案件・Task は、業務アプリから公開 API で読み書きします。

業務が進む例

車両リースの管理を例にすると、Hane の上では次のように業務が進みます。

毎朝のスケジュールが、申入れの期限が近いリース契約を業務データから探し、契約ごとに案件を始めます。
Workflow が、確定していない値（推定の満了日など）があれば担当に確認の Task を作り、確定するまで待ちます。
Agent が選択肢の費用を比べた起案を作り、担当が Task で方針を決めます。
リース会社への申込のように外へ影響する操作は、金額に応じて部門長、または部門長と経理の承認を通してから進みます。
案件が完了すると成果が記録され、途中の判断と操作はすべて監査に残ります。

この流れの部品（スケジュール・Workflow・Task・Agent・承認の規則）は、すべてマニフェストで定義します。

次に読む

主な概念組織・定義・業務データ・Workflow・Task などの言葉を1ページで確かめる

アーキテクチャ要求の流れ、イベント、組織と環境の分け方

クイックスタート組織を作り、定義を入れて、最初の API を呼ぶ

Hane Cowork とはPlatform とつながるデスクトップアプリ（プレビュー）