agenticorg

AgenticOrg

AgenticOrg は、金融、人事、マーケティング、運用、バックオフィス、コミュニケーション、および範囲を限定したエージェント型コマースのユースケースにわたるエージェントワークフローの構築、実行、ガバナンスを支援するエンタープライズ向け AI エージェントプラットフォームです。現在のソースコードの権利と、将来提案されているプラットフォームライセンスについては、利用方法とライセンスをご覧ください。

所有権： AgenticOrg は Orchestrum Technologies LLP が所有しています。

発明者／所有者： Sanjeev Kumar

連絡先： [email protected] | [email protected]

ウェブサイトのデモおよびトライアルに関するリード通知の既定の送信先は [email protected] です。 セルフホスト環境の運用者は、AGENTICORG_DEMO_NOTIFY_TO を使用して、マーケティング用の受信先を1つ選択できます。これは、問い合わせ者への確認メール、ワークスペース通知、アカウント復旧メールの送信先を変更するものではなく、SMTP の設定に代わるものでもありません。

正式な所有権と連絡先に関する声明および NOTICEをご覧ください。

ウェブサイト | アプリケーション | プレイグラウンド | ユーザーマニュアル | 技術ドキュメント | 現在の製品ステータス | セキュリティポリシー

効果を測定できるパイロットから始めましょう：銀行のサービス案件、 フィンテック／API の統合、または 加盟店と外部購入者のワークフロー。 視覚的な導入チェックリストでは、 ソースの設定、レビュー、外部確認、拡張について説明しています。タスクや システムについては [email protected] までご相談ください。公開の問い合わせに 認証情報や顧客データを送信しないでください。

信頼できる情報源

公開されている製品情報エンドポイントで、稼働中の製品の集計値とデプロイ済み製品のバージョンを確認できます。

GET https://app.agenticorg.ai/api/v1/product-facts

レスポンスには version、agent_count、connector_count、tool_count が含まれます。これらの値をドキュメント、ページの文言、テストに転記しないでください。値は実行時のレジストリから算出されるため、ドキュメントのリリースとは無関係に変わることがあります。ソースビルドで宣言されるバージョンは pyproject.toml に記載されています。

請求上限と表示価格は core/billing/catalog.py で定義されています。本番環境へのデプロイの動作は scripts/deploy_cloud_run.sh で定義されています。

現行リリースの概要

独自のチャネルと AI 認証情報を使用する

新しいエージェントでは、デフォルトで gemini-3.5-flash-lite が使用されます。明示的に選択したモデルは変更されません。Google またはその他のプロバイダーのキーは、保護された AI 認証情報の設定に保存してください。モデル選択、フォールバック、会社のスコープは引き続き設定可能です。 このモデルでは、Agent Configuration > Gemini thinking から、複数ステップの推論に使用するオプションの中程度プロファイルを選択できます。既存のエージェントと汎用呼び出しでは、プロバイダーのデフォルトが維持されます。グローバルフラグやデフォルトは変更されません。API では llm.thinking_level="medium" に相当します。プロバイダーのデフォルトに戻すには null を設定してください。 どちらのランタイムクライアントも、明示的なプロファイルを適用します。思考処理は出力トークンとして課金されるため、既存の上限内で追加のトークン使用量と応答時間を考慮してください。これは正確性を保証するものではありません。以前のモデル設定とすべての機能フラグは変更されません。推論の受け入れテストを参照してください。

Channels ダッシュボードでは、独自の WhatsApp Cloud API、Meta Messenger、Telegram、Viber、Mailgun の受信メール、または署名付きゲートウェイをエージェントやワークフローに接続できます。認証情報は暗号化され、コールバックは認証され、未リンクのメッセージには確認が必要です。また、プライベート送信者リンクでは、現在の権限のみが委任されます。既存の Twilio 音声／通話設定とリモート MCP ツールの検出は、それぞれ別の統合機能です。 ネイティブチャネルの返信では、ステータス通知がデフォルトで任意となります。Telegram のエージェント接続では、リンク済みのプライベート送信者向けに、Channels > Reply content から上限付きの最終回答返信を有効にできます。トレースとツール呼び出しの記録は AgenticOrg に保持されます。承認、送信者の認証、テナント制御も引き続き適用されます。暗号化された受信データによって、認証済み送信者の ID がサービス間で引き継がれます。この証明がない古い受信記録は、エージェントが処理を完了していても引き続き保留されます。 このオプトインモードで、トラフィック分割のないツール不使用の Telegram エージェントを使用する場合、フォローアップでは、同じリンク済みプライベート送信者およびエージェント／会社のスコープ内で、直近 30 分間に確認済みの質問と回答のペアを最大 4 組まで使用できます。これは上限付きのテキストコンテキストであり、永続的なメモリでも、アクションを繰り返す許可でもありません。プライバシースキャン前のモデル入力では、ヒンディー語やその他の Unicode 文字を読み取れる状態に保ちます。既存のマスキング処理は引き続き適用されます。

アカウントの作成、コールバックの登録、送信者のリンク、検証については、チャネルアカウントとワークフローのガイドに従ってください。ローカルのワイヤーコントラクトテストは、実際のプロバイダーアカウントから配信された証明にはなりません。すでに接続済みのボットには既存の Telegram 接続を再利用してください。2 つ目の接続で、その Webhook を上書きしてはいけません。権限があり、キューに保留中または実行中のタスクがない場合に限り、Save settings から宛先を変更してください。実際のモデル推論は、トランスポートのみのワークフローとは分けて検証してください。1 回の配信で両方を証明できない限り、Telegram から Gemini までの一連のフローを検証済みと称してはいけません。

受け入れチェックでは、終了ステータスだけでなく、実際の回答も検証します。信頼度の高いモデル実行が完了していても、回答が間違っている可能性があります。数値の結果は個別に照合し、原因を調査する際も PII の保護を維持してください。本番環境での上限付き受け入れテスト手順書を参照してください。

現在の本番プラットフォームには、ガバナンスが適用されたエージェント／ワークフローの実行、スキャン文書の OCR を含むドキュメント取り込み、プロバイダー管理の STT／TTS を備えた署名付き Twilio 音声、テナントスコープのブラウザー RPA、Python および TypeScript SDK、MCP／A2A のインターフェース、上限付きの Shopify から OACP へのコマースランタイムが含まれます。リリース済み、設定に依存、未リリースの各範囲の正確な情報については、現在の製品ステータスを参照してください。

外部アクションは明示的に実行されます。音声プロバイダー、コネクター、ブラウザースクリプト、購入者チャネル、決済手段、マーチャントシステム、POS 経由で操作するには、対象テナントに必要な認証情報、スコープ、設定があり、プロバイダーの承認を得ている必要があります。

ガバナンス管理されたビジネスケース

このリポジトリには、テナント単位で制御されるビジネスオンボーディングケースのワークフローが含まれています。読み取り専用のプロバイダー調査、出典を明記したメモ、決定論的なポリシー評価、スクリーニング結果、人によるレビュー、監査可能な引き継ぎを備えています。有効なロールエージェント、登録済みツール、ケースの正確なローカル目的、委任された許可がすべて呼び出しを認可しない限り、プロバイダーへの呼び出しは拒否されます。一般的なツールの強制が off または warn モードであっても、このケース固有のチェックは厳格に適用されます。

AgenticOrg は grantex==0.7.1 に固定し、許可トークン、コネクター、ツール、および数値の金額があればそれを指定して、強制チェックを呼び出します。ケース ID やケースの目的は渡さないため、この経路ではトークンのケース目的とケースごとの上限はチェックされません。ロールの case_purposes リストは AgenticOrg 内の制御であり、プールされた許可は単一のケースには紐づきません。意思決定とアナリストの操作には、引き続きサインイン済みの人間が必要です。API キー、エージェントトークン、MCP ツールは、その人間の代理として操作できません。テナントで有効化して設定するまでは、ケースのランタイムはオフです。このソースの説明は、特定のホスト型デプロイでこのワークフローが有効になっていることを示すものではありません。ケースのライフサイクルとセットアップ、許可の強制に関する運用手順書、意思決定リクエストを参照してください。

音声、メール、OCR、ブラウザー RPA は、リリース前に Docker ベースのローカルマルチチャネルシミュレーションでまとめてテストできます。このシミュレーションでは、新しい PostgreSQL、ローカルの Mailpit 配信、実際の Tesseract、任意で実際の Playwright Chromium を使用し、有料の呼び出しと本番環境への変更は無効にします。

ナレッジのアップロード状況では、抽出と検索可能なインデックス作成を区別します。アップロードの復旧をオプトインすると、一時的なネイティブの埋め込み失敗は既存のワーカーで再試行されます。置き換えが成功するまでは、以前の検索可能なコピーが保持されます。形式が不正な PDF／Office ファイルは、置き換え前に拒否されます。状況の意味、引用、復旧の制限については、ナレッジと OCRを参照してください。推論専用のエージェントを使用する場合は、提案ツールを無効にし、ツール／コネクターの選択を空のままにしてください。これによってテナントの予算制限を回避することはできません。プロバイダーの料金とクォータは引き続き適用されます。信頼度には構造化出力を使用し、レビューのしきい値を維持してください。また、テスト用の支出枠には、説明の呼び出しとプロバイダーの再試行も含めてください。制限付きの受け入れ手順と、オプトイン方式の直接実行説明履歴については、エージェントの作成および実行とチャットを参照してください。

ダッシュボードの「最近のアクティビティ」は監査レコードを検索します。これとは別の内部ライブフィードパイプラインは、イベントの公開時にテナントごとにイベントを永続化し、WebSocket の中断後にはシーケンス番号を使って再生できます。このパイプラインに書き込むのは会話スーパーバイザーコンソールのみです（デフォルトでは無効で、AGENTICORG_CONVERSATION_V2_ENABLED の背後にあります）。コンソールはメッセージ本文を含めずに会話の変更を通知し、「会話」画面で使用されます。他の運用イベントの書き込み元は、このパイプラインには接続されていません。ブラウザーコンポーネントは、接続状況と追いつき状況を表示しますが、生のペイロードは表示しません。また、ダッシュボードのライブストリームとしてはマウントされていません。ブローカーの再接続、ソケットファンアウトの上限設定、認証情報の定期的な再検証は、ローカルテストでカバーされています。本番環境でのレイテンシー、スループット、可用性は、まだ測定されていません。アクティビティ配信ガイドでは、この境界について説明しています。スケールとレジリエンスの評価では、接続規模、負荷、復元に関する残作業を追跡しています。復旧ガイドでは、計画上の目標と、本番環境で実証済みの制御を区別しています。

AI 支出インテリジェンス

AI 支出インテリジェンスでは、組織独自の構造に照らして、ルピー建ての AI 支出を測定します。デフォルトでは無効で、AGENTICORG_SPEND_INTELLIGENCE_ENABLED によって制御されます。無効の場合、GET /api/v1/spend/status は enabled: false を返し、それ以外の支出関連ルートはすべて 404 を返します。計測も行われません。フェーズ 1 は API のみで、アプリケーションにはまだ支出画面がありません。

デプロイ環境でこの機能を有効にすると、管理者は支出の測定基準となる参照データを管理します。これには、組織ツリー、ソースマッピング、モデルのエイリアス、有効期間付き料金表（契約料金表は通常料金表より優先され、キャッシュ入力の価格、ボリューム階層、保存済みのバッチ割引を含みますが、フェーズ 1 ではバッチ割引はまだ適用されません）、すべての価格を INR に換算する為替レート、コミットメントが含まれます。計測されたモデル呼び出しはすべて、サーバー側の帰属情報を含む使用量レコードとして記録され、請求日現在有効な料金表の価格（またはモデルのトークンについてはデプロイ環境の通常価格）で価格が算定されます。埋め込み、OCR ページ、音声の分数、価格設定されたツール呼び出し、ストレージの GB 日数、社内 GPU のノード時間も同様に記録されます。これらのレコードには、日次集計、未帰属分を含むカバレッジ、メーターの欠落、監査済みのメンテナンスジョブが紐付きます。プロバイダーの請求書は請求月ごとにインポートされ、照合許容差 1% 以内で照合されます。差異がある場合は、請求書のインポート担当者以外の管理者が理由を添えて承認します。GET /api/v1/spend/gate は、ある月のゲート 1 のステータスを報告します。条件は、INR 建て支出の少なくとも 98% が事業部門、部署、チーム、またはコストセンターに帰属していること、価格未設定、換算未実施、または為替処理待ちのレコードがないこと、そしてすべてのプロバイダーが 1% 以内で照合済みであることです。

flowchart TD
  flag{"AGENTICORG_SPEND_INTELLIGENCE_ENABLED"}
  flag -->|"off, the default"| off["Only GET /api/v1/spend/status answers, other spend routes are 404"]
  flag -->|"on"| ref["Reference data: organisation tree, source mappings, model aliases, rate cards, FX to INR, commitments"]
  usage["Model calls, embeddings, OCR pages, speech minutes, priced tool calls, storage GB-days, GPU node hours"] --> meter["Meter and writer: server-side attribution and pricing"]
  ref --> meter
  meter --> records["Usage records"]
  records --> rollups["Daily rollups, coverage and the unattributed share"]
  invoices["Imported provider invoices"] --> recon["Reconciliation per provider and billing month"]
  records --> recon
  recon -->|"outside the 1% match tolerance"| accept["Acceptance with a reason by a second administrator"]
  rollups --> gate(["Gate 1 status: at least 98% attributed and every provider within 1%"])
  recon --> gate

料金表、コミットメント、価格、請求書、照合、ゲートの情報を取得できるのは、人間の管理者または監査担当者のみです。それ以外の閲覧者には、エージェントの可視性に基づいてフィルタリングされた使用量が表示され、テナント全体の数値は取得できません。支出ダッシュボード、予算、支出アラート、予測、明細書、月次締めは後続フェーズで対応します。ユーザーガイド、機能リファレンス、ロールアウト手順書を参照してください。

このリポジトリの内容

領域	現在の実装
エージェントランタイム	モデルルーティング、ツール呼び出し、信頼度の処理、再試行ポリシー、永続化された実行状態を備えた FastAPI および LangGraph ランタイム
エージェント作成	組み込みエージェント定義、カスタムエージェント、プロンプトテンプレート、組織階層、ノーコード UI
ワークフロー	ワークフロー定義、実行、スケジュール、条件、承認、監査イベント
ガバナンス	テナントとロールの境界、スコープ付きツール、人間参加型のキュー、シャドー評価、ポリシーチェック、キルスイッチのパターン
インテグレーション	ネイティブコネクターレジストリと任意のインテグレーションゲートウェイ。実際に利用できるかどうかは、認証情報、スコープ、プロバイダーへのアクセス、テナント設定によって異なります
ナレッジとチャネル	ネイティブおよび OCR によるドキュメントの取り込み／検索、レポート、通知、署名付き Twilio 音声通話、RPA、その他の設定済みチャネル
開発者向けアクセス	REST API、Python SDK と CLI、TypeScript SDK、MCP サーバー、レガシーの A2A 形式タスク API、ソースコードに実装された A2A v1 HTTP+JSON 同期テキスト
コマース	マーチャントのスコープに限定した Shopify の読み取り専用同期、OACP アーティファクトの取り込み／キャッシュ、購入者向けの安全な回答、公開カタログの画面、準備済みのプロバイダーまたは POS への引き継ぎ
運用	PostgreSQL、Redis、オブジェクトストレージ、オブザーバビリティフック、マイグレーション、セキュリティチェック、Cloud Run デプロイツール
AI 支出インテリジェンス	デフォルトでは無効。API のみで利用できる組織ツリー、ソースマッピング、料金表、INR への FX 換算、コミットメント、モデル呼び出しとトークン以外の使用量に関する帰属済み使用記録、日次集計、カバレッジ、請求書の照合、作成者と承認者による受け入れ、Gate 1 のステータス

ソース定義が存在するだけでは、特定のテナントがプロバイダーに接続済みであることや、書き込みアクセスを有効にしていることの証拠にはなりません。Connectors ページでは、登録状況と、設定済みの認証情報、および最近の、古い、失敗した、または未実施のヘルスチェックを区別するようになりました。これらの証拠によって、プロバイダーのスコープ、API コントラクトのカバレッジ、継続的な同期、エラーバジェットが検証されるわけではありません。コネクターのアクションには、承認済みの認証情報、スコープ、ポリシー、およびプロバイダーの利用可能性が引き続き必要です。

機能のステータス

プラットフォームに実装済み

• エージェント定義とテナント作成エージェント
• 認証済み API を通じたエージェントとワークフローの実行
• 人間による承認キューと設定可能なエスカレーション条件
• ガバナンス対象のランタイムアクティビティに関する監査記録
• プロンプトテンプレート、組織構造、ロールを考慮したアプリケーションビュー
• ネイティブコネクター定義とスコープ付きツールゲートウェイ
• 認証済みの実行パスを備えた公開 A2A および MCP ディスカバリー
• Python および TypeScript クライアントパッケージと MCP サーバーパッケージ
• ホスト型の課金上限とチェックアウトインテグレーション
• OACP コマース設定、Shopify の読み取り専用同期、アーティファクトのキャッシュ、購入者向けチャネル、安全な引き継ぎの準備

設定依存またはプロバイダーによる制限あり

• LLM の呼び出しには、サポート対象のモデルプロバイダーまたはローカルモデルランタイムの設定が必要です。
• 各コネクターには、プロバイダーの認証情報、テナントの認可、および関連するスコープが必要です。ネイティブレジストリ名、認証情報の項目、ヘルスチェック、およびロールアウト制御付きのカタログ事前入力については、コネクターのセットアップガイドに従ってください。登録済みの行があっても、プロバイダーへの接続が確立されている証拠にはなりません。
• Composio はオプションのインテグレーションゲートウェイです。そのカタログはネイティブコネクターレジストリとは異なります。
• 本番イメージには、Tesseract、Poppler、LibreOffice が同梱されています。ナレッジの取り込みを参照してください。
• 本番の音声経路では、署名付き Twilio webhook と、プロバイダー管理の STT／TTS、暗号化された文字起こしデータの保存を使用します。音声ランタイムを参照してください。
• Jev／System One のサポートは、助言的でシャドウ実行に対応したインテグレーションとして実装されていますが、TypeSafe への登録は現在、新規ユーザーに対して停止されています。TypeSafe からアクセスが許可され、測定評価が承認されるまで、本番環境では off のままです。Jev インテグレーションを参照してください。
• 公開されている評価ページでは、合成コーパスのカバレッジ、上限付きサンプリングと予算管理、明示的なレビューゲートを含む、読み取り専用の Jev シャドウプランを公開しています。Jev を呼び出したり、アクティブなルーティングを有効にしたりすることはありません。
• 測定用の Jev シャドウランナーは明示的なローカル実行です：python scripts/run_jev_shadow_evaluation.py --dry-run。--live には、TypeSafe が発行した TYPESAFE_API_KEY、上限付きゲート、およびオペレーターが承認した出力先が必要です。キーを捏造したり、コミットしたり、リポジトリに貼り付けたりしないでください。
• ブラウザー自動化には、テナントスコープのスクリプト、スケジュール、永続的な履歴、 承認済みドメインへのエグレス制御が含まれます。実行は常に明示的な外部 アクションです。RPA ランタイムを参照してください。
• 外部通知とローカルモデルのプロファイルには、それぞれを支えるサービスが必要です。
• AI 支出インテリジェンスはデフォルトでオフです。AGENTICORG_SPEND_INTELLIGENCE_ENABLED を API、ワーカー、beat サービスで設定するまで、使用量の計測は行われません。配賦は組織ツリーとテナント 管理者が入力したマッピングに従います。価格には、テナントの料金表がある場合はその価格を使用し、ない場合はモデルのトークンに対するデプロイメントの定価を使用します。 これらの価格は、テナントの為替レートで INR に換算されます。 ロールアウトと有効化の手順書に従ってください。
• 多くのガバナンスおよび BFSI サービスはソースに含まれていますが、デフォルトではオフで、それぞれ独自の AGENTICORG_* 設定によって制御されています。対象には、モデルゲートウェイ、ガードレールフックとその強制適用、オペレーターによるオーバーライド、 データ所在地の強制適用、監査チェーン、トレーシングと合成チェック、ランタイム制限とメモリ、ビジュアルワークフロービルダー、 プロンプトのメーカーチェッカーと比較機能、評価データセットと昇格ゲート、エージェントレジストリ、 ガバナンスインベントリとモデルカード、FinOps の配賦、しきい値と予測、 対話型サービス、コンテンツサービス、ドキュメント処理、ワークベンチ、音声と トランザクションインテリジェンス、リネージ、パーソナライズ機能があります。デフォルトのインストールでは、これらの機能はどれも有効になりません。 機能スイッチの表と、 デフォルトで無効な画面のガイドを参照してください。
• SSO、SCIM、エンタープライズサポート、カスタム SLA は、プランとデプロイメント設定に依存します。
• WhatsApp、Telegram、決済プロバイダー、銀行、POS、加盟店システムの各フローには、プロバイダーのセットアップと、検証済みのコールバックまたはアダプターが必要です。
• WooCommerce、ERP、PIM、OMS、WMS、カスタムコマース API、追加の決済手段は、アダプター対応の設定として記録できますが、承認済みのアダプターが存在するまでは、アクティブな実行経路として扱われません。

明示的な非目標と境界

• OACP アーティファクトは、注文の作成、在庫の確保、マンデートの作成、決済の処理、返金の発行、有料状態の証明を行いません。
• AgenticOrg は、記録の正式な管理元として、販売事業者、銀行、決済プロバイダー、POS、SaaS システムに取って代わるものではありません。
• キャッシュされたコマースのエビデンスは、回答や準備済みの引き継ぎを支援できますが、プロバイダーが管理する実行結果はプロバイダーによる確認が必要です。
• ソースに記載されたコネクターは、顧客との統合が稼働中であることの証明にはなりません。
• ワークフローの例や編集コンテンツは、パフォーマンスを保証するものではありません。
• リポジトリ内のセキュリティ管理は、サードパーティによる認証を受けていることを示すものではありません。

ランタイムの仕組み

ブラウザーまたは SDK
    |
    v
React 19 アプリケーション / FastAPI API
    |
    +-- 認証、テナントコンテキスト、ロール、スコープ
    +-- エージェントレジストリと LangGraph の実行
    +-- ワークフローエンジン、スケジュール、承認キュー
    +-- ツールゲートウェイとコネクターアダプター
    +-- 監査、評価、オブザーバビリティ、コスト記録
    |
    +-- PostgreSQL / Cloud SQL
    +-- Redis
    +-- GCS または互換性のあるオブジェクトストレージ
    +-- 設定済みの LLM と外部サービスプロバイダー

管理された本番環境の構成では、Google Cloud Run 上で API サービスと UI サービスを分離して実行します。Artifact Registry のイメージはコミットに固定され、ロールアウト前にマイグレーションを実行でき、トラフィックの切り替えは明示的に行われます。レガシーの Kubernetes 関連資料は、現在の本番環境の構成ではありません。

OACP コマースの境界

AgenticOrg は、OACP に基づくコマースの周辺で、買い手および売り手エージェントのランタイムを管理します。Grantex は、信頼性の権限、プロトコルとポリシーのガバナンス、正規アーティファクト、アーティファクトの検証、アダプターの権限を管理します。Shopify と販売事業者のシステムは、引き続き業務上の記録の正式な管理元です。Pine Labs Plural/P3P、銀行、POS システム、決済プロバイダーは、それぞれの実行基盤を管理します。

現在サポートされているソースのフローは次のとおりです。

1. 販売事業者がテナント、販売事業者、店舗、売り手エージェントの各スコープに応じた設定を保存します。
2. AgenticOrg は、承認済みの認証情報管理経路を通じて Shopify の認証情報を保存します。
3. AgenticOrg は、読み取り専用の Shopify Admin GraphQL 同期を実行します。
4. 外部公開に安全なエビデンスが、設定済みの Grantex 権限経路に送信されます。
5. 発行された OACP アーティファクトは、鮮度、スコープ、リスク、失効状態とともにキャッシュされます。
6. 買い手向け画面では有効なアーティファクトに基づいて回答し、ソースと鮮度を明示します。
7. 購入意思は、実行を伴わないプロバイダー、販売事業者、または POS への引き継ぎ、あるいはフェイルクローズのブロッカーとなります。
8. 外部での結果を確認できるのは、検証済みのプロバイダーまたは販売事業者のコールバックのみです。

docs/oacp/README.md とランタイム起動完了 PRDから始めてください。

要件

• Python 3.12 以降
• Node.js 22.22 以降（UI のルーターに必要です。CI では 22.22.0 を使用します）
• ローカルの PostgreSQL および Redis 用の Docker と Docker Compose
• モデルを利用した実行には、サポート対象の LLM プロバイダーキーを少なくとも 1 つ用意するか、ローカルモデルランタイムを設定してください

UI では現在 React 19 を使用しています。依存関係のバージョンは pyproject.toml と ui/package.json で宣言されています。

ローカル開発

リポジトリをクローンして設定します。

git clone https://github.com/mishrasanjeev/agentic-org.git
cd agentic-org
cp .env.example .env

プラットフォームと開発用の追加パッケージをインストールします。

python -m venv .venv
python -m pip install -e ".[v4,dev]"

ローカル依存サービスを起動します。

docker compose up -d postgres redis minio

マイグレーションを実行して、API を起動します。AGENTICORG_ENV は .env のみに設定するのではなく、シェル環境に設定する必要があります。認証情報ボルトはプロセス環境を読み取るため、ローカル、dev、development、test、または CI のランタイム以外では、実際のボルトキーがないと起動を拒否します。

export AGENTICORG_ENV=development
python scripts/alembic_migrate.py
uvicorn api.main:app --host 0.0.0.0 --port 8000 --reload

別のターミナルで UI をインストールして実行します。

cd ui
npm ci
npm run dev

ステージング環境や本番環境では、サンプルのシークレットを使用しないでください。承認済みのシークレット管理手順を通じて、実際のシークレットを設定してください。

オプションの Compose プロファイルには、ローカルの CPU／GPU モデルランタイムや、RAG または音声サービスをサポートするサービスが含まれます。プロファイルを有効にする前に、機能によってハードウェア、イメージ、認証情報が異なるため、docker-compose.yml を確認してください。

パブリック API とプロトコル

標準のルート A2A Agent Card 検出パスを除き、アプリケーションの API ルートは /api/v1 以下にマウントされます。

サーフェス	目的	認証方式
GET /api/v1/health	サービスの健全性	パブリック
GET /api/v1/product-facts	ライブのバージョンとレジストリの合計数	パブリック
GET /.well-known/agent-card.json	A2A v1 汎用 Agent Card（リリースおよびイングレスの設定後）	パブリック
GET /api/v1/a2a/extendedAgentCard	マーチャント固有のセラーカード	マーチャントが発行したバイヤー認証情報
POST /api/v1/a2a/message:send	A2A v1 同期テキストリクエスト	セラーへの Q&A にはバイヤー認証情報、非コマースエージェントにはスコープ付きテナント認証情報
GET /api/v1/a2a/agent-card	レガシーの AgenticOrg 検出カード。A2A v1 ではありません	パブリック
GET /api/v1/a2a/.well-known/agent.json	レガシーの検出エイリアス。A2A v1 ではありません	パブリック
GET /api/v1/mcp/tools	MCP 互換エージェントの検出	パブリック
エージェント、ワークフロー、ツール、請求、コマースの変更操作	テナント操作	認証済みかつスコープ設定済み

デプロイメントで有効にすると、API サービスからインタラクティブな OpenAPI ドキュメントを利用できます。詳細なルート一覧は docs/route_inventory.json に、API の説明ドキュメントは docs/api-reference.md にあります。

外部のバイヤーエージェントは、AgenticOrg 上で実行する必要はありません。マーチャントは、任意の A2A v1 HTTP+JSON クライアント向けに、取り消し可能でスコープが限定されたバイヤー認証情報を発行できます。一方、セラーの回答は拘束力を持たず、OACP キャッシュをソースとします。正確な ID の制限、SDK の呼び出し、マイグレーション／イングレスの要件、サポート対象外のトランスポートについては、A2A 相互運用ガイドを参照してください。このリポジトリの実装は、特定のバイヤープラットフォームが AgenticOrg を導入または推奨していることを意味するものではありません。

Python SDK と CLI

sdk/README.md を参照してください。

pip install agenticorg
agenticorg agents list
agenticorg a2a card

SDK 0.4.0 は、エージェント、ワークフロー、コネクターの診断、ナレッジ／OCR、音声、RPA、ローカルブリッジ、セラーコマースランタイムに対応しています。外部アクションを実行するメソッド（アウトバウンド通話、RPA の実行、コネクターの同期、ブリッジのルーティングなど）は、引き続き明示的な呼び出しが必要で、テナント認証も必要です。サーバー機能を使用するには、インストール済みクライアントより新しいデプロイメントが必要な場合があるため、利用者はパッケージとサーバーのリリースノートを確認してください。

TypeScript SDK

sdk-ts/README.md を参照してください。

npm install agenticorg-sdk

TypeScript 0.4.0 のリソース範囲は、ナレッジ／OCR、音声、RPA、ブリッジ、コマース準備 API など、Python ランタイムの対応範囲と同じです。

MCP サーバー

mcp-server/README.mdを参照してください。

npx agenticorg-mcp-server

MCP パッケージは、ガバナンスの適用された AgenticOrg のエージェントおよびコマースの検索機能を公開します。MCP クライアントにすべてのコネクターアクションへの無制限のアクセスを許可するものではありません。

逆方向の連携では、Connectors > Remote MCP により、テナントが所有する HTTPS Streamable HTTP サーバーを暗号化されたベアラー認証情報で登録し、ツールを検出して、保存されたカタログをエージェントの選択およびランタイムのディスパッチと共有できます。 レビュー済みの読み取りツールは、許可とアクションポリシーに従って実行できます。書き込みツールは制限されたままです。検出結果は、上流プロバイダーのすべての機能を証明するものではありません。 接続、レビュー、プローブ、エージェント実行のワークフローを参照してください。

料金と制限

ホスト型プランの信頼できる唯一の情報源は、core/billing/catalog.pyにある型付きのPUBLIC_PLAN_CATALOGです。core/billing/limits.pyにある互換性ビューは、このカタログから導出されます。

プラン	米ドルの表示価格	INR の表示価格	エージェント	実行数	ストレージ
Free	$0/month	INR 0/month	3	1,000/month	1 GB
Pro	$99/month	INR 9,999/month	15	10,000/month	50 GB
Enterprise	$499/month	INR 49,999/month	無制限	無制限	無制限

このリポジトリは Apache-2.0 ライセンスで提供されています。インフラストラクチャ、モデルプロバイダー、外部 API、決済プロバイダー、およびサポートの費用は、ソフトウェアライセンスとは別です。

セキュリティとガバナンス

このコードベースには、以下が含まれています。

• 保護対象の API 操作に対するテナント、ロール、スコープのチェック
• 設定可能な人による承認と、信頼度またはポリシーに基づくゲート
• スコープが設定されたコネクターツールと、中央管理されたツールゲートウェイ
• コネクターおよびクラウド認証情報のシークレット参照パターン
• モデル呼び出しの前およびログ内での、設定可能な PII のマスキング
• 暗号化サポートを備えた PyJWT による JWT 検証
• レート制限、セキュリティヘッダー、認証状態の制御
• 依存関係、静的解析、コンテナー、回帰のセキュリティチェック
• ガバナンス対象の操作に関する監査記録とオブザーバビリティ記録
• OACP の鮮度、失効、プロバイダー境界チェックにおけるフェイルクローズ動作

本番環境のセキュリティは、適切なデプロイ設定、鍵の管理、プロバイダー設定、テナントポリシー、運用監視に依存します。脆弱性はSECURITY.mdから報告してください。脆弱性が疑われる場合は、公開 issue を作成しないでください。

テスト

ローカルで Docker の完全な再生テストを行うには、make dev、make check、make test、 make seed、make seed-casesを実行してから、 AGENTICORG_E2E_REQUIRE_GOVERNED_CASES=true make e2eを実行してください。tools イメージはランタイムと同様に Python 3.14 を使用します。両方のブラウザーランナーは、固定された Playwright のバージョンと一致している必要があります。 分離されたテストデータベース、合成プロバイダーフィクスチャ、判断付与のブラウザーチェックについては、 ローカルクイックスタートを参照してください。

バックエンド：

pytest

バックエンドの対象を絞ったチェックは、ディレクトリまたはファイル単位で実行できます。

pytest tests/unit
pytest tests/regression
pytest tests/connector_harness

フロントエンド：

cd ui
npm ci
npm run lint
npm run typecheck
npm test
npm run build

ブラウザーテスト：

cd ui
npx playwright test

Playwright のテストスイートには、対象のアプリケーションと、ドキュメントに記載されたテスト認証情報またはフィクスチャが必要です。.github/workflows以下の CI ワークフローファイルが、各イベントで実行されるスイートの信頼できる唯一の情報源です。この README は、すべての E2E テストスイートがすべてのプッシュで実行されるとは主張していません。

本番環境へのデプロイ

現在のマネージドロールアウト用ヘルパーは、Google Cloud Run を対象としています。

bash scripts/deploy_cloud_run.sh --sha <commit-sha> --yes

利用できるモードは次のとおりです。

bash scripts/deploy_cloud_run.sh --sha <commit-sha> --skip-build --with-migrations --yes
bash scripts/deploy_cloud_run.sh --sha <commit-sha> --skip-build --traffic preserve --yes
bash scripts/deploy_cloud_run.sh --sha <commit-sha> --dry-run

このヘルパーを使用するには、デプロイする SHA と完全に一致する、変更のないチェックアウトが必要です。リビジョン固有のイメージをステージングし、イメージとコミットのメタデータを検証します。また、移行を先行させるデプロイに対応し、ヘルスチェックを行い、選択したモードに従ってトラフィックを移行します。本番環境の認証情報を使用する前に、スクリプトのヘルプとdocs/deployment.mdをお読みください。

スクリプトのデフォルト設定では、Cloud Run サービスは asia-southeast1 に、Artifact Registry は asia-south1 に配置されます。どちらも設定を変更できます。以前の Kubernetes に関する資料は、歴史的な背景または代替デプロイ方法の参考としてのみ残されています。

リポジトリの構成

api/                 FastAPI アプリケーションとバージョン管理されたルート
auth/                認証・認可ミドルウェア
core/                エージェントのランタイム、モデル、課金、コマース、オーケストレーション
connectors/          ネイティブコネクターの実装とフレームワーク
workflows/           ワークフローの定義とランタイムヘルパー
sdk/                 Python SDK と CLI
sdk-ts/              TypeScript SDK
mcp-server/          MCP サーバーパッケージ
ui/                  React 19 アプリケーションと公開 Web アセット
migrations/          データベースの移行
observability/       メトリクス、トレーシング、ログのヘルパー
tests/               バックエンドのユニット、回帰、セキュリティ、統合テスト
ui/e2e/              Playwright のブラウザーテスト
docs/                製品、アーキテクチャ、運用、プロトコルに関するドキュメント
scripts/             検証、移行、リリース、デプロイ用のヘルパー

検索および回答エンジン向けアセット

公開サイトには、従来型の検索と回答エンジンによる発見を支援するアセットが含まれています。

• robots.txt
• sitemap.xml
• llms.txt
• llms-full.txt
• ルートごとのタイトル、説明、canonical、ソーシャルメタデータ、構造化データ
• クロール可能なブログ、リソース、製品、プロトコル、ソリューション、信頼性、法務に関するページ

2 つの llms ファイルは、ui/scripts/generate-llms.mjsによって生成されます。これらは機械可読な補助ナビゲーションドキュメントであり、クロール可能な HTML、正確な構造化データ、robots の制御、サイトマップに代わるものではありません。

追跡対象のサイトマップと llms のコピー、およびルートの JSON-LD CSP ハッシュを更新するには、次のコマンドを実行します。

cd ui
npm run seo:sync
npm run seo:verify

ドキュメント

• エンドユーザー向けマニュアル：最初のエージェント、日常業務、BFSI プレイブック。UI では、同じ Markdown コンテンツを agenticorg.ai/docs で提供しており、全文検索、視覚的なプロセスフロー、印刷しやすいガイド、モバイルナビゲーションを利用できます。docs.agenticorg.ai のエイリアスでは Cloud DNS とマネージド HTTPS が設定されています。ホスティングおよび検証の手順はドキュメント運用手順書をご覧ください。
• BFSI の機能対応状況と未対応項目では、実装済み、一部対応、未対応の機能を、検証シナリオおよび製品の適用範囲とともに示します。
• 公開されている BFSI 機能の対応状況では、未完了の作業も含め、同じ評価を平易な言葉でまとめています。
• ドキュメント、会話、通話、ワークベンチでは、既定で無効になっているサービスのコンソール画面と、それぞれに必要な設定を説明します。
• ドキュメントサイトの公開とサブドメインの運用手順書
• マーケティング問い合わせの配信、SMTP の設定、モデル利用料の保護 では、営業エージェントを実行せずに、既定で無効になっている Grantex の問い合わせフォームからの引き継ぎについても説明します。
• ドキュメントホーム
• 現在の製品状況
• アーキテクチャ
• API リファレンス
• デプロイ
• AI 利用料インテリジェンスのユーザーガイド、機能リファレンス、ロールアウトおよび有効化の運用手順書
• ナレッジの取り込みと OCR
• ローカルでの音声、メール、RPA、OCR のシミュレーション
• 音声ランタイム
• RPA ランタイム
• OACP ランタイムのドキュメント
• 外部 A2A 購入者および販売者のアクセス
• ローカルの合成販売者と独立した A2A 購入者のデモ
• 加盟店から外部購入者への A2A コマースのガイド付きジャーニー
• 本番環境のスモークテスト運用手順書
• テストガイド
• Python SDK
• TypeScript SDK
• MCP サーバー
• 変更履歴
• ロードマップ

ドキュメントホームでは、現在有効な資料、設定に依存する資料、過去の資料、目標設計の資料を区別しています。日付入りの監査記録、古い PRD、段階的な実装レポートは、履歴資料として引き続き参考になりますが、現在のコード、OpenAPI、運用手順書、保持されているリリースの証拠、または稼働中の製品に関する事実に優先するものではありません。

コントリビューション

CONTRIBUTING.md と CODE_OF_CONDUCT.md をお読みください。プルリクエストの対象を絞り、動作変更にはテストを追加し、信頼できる情報源のフィールドを変更した場合は、生成される公開ドキュメントも更新してください。

ライセンス

AgenticOrg は Apache License 2.0 に基づいてライセンスされています。

承認済みの将来方針（ソフトウェアへの適用は保留中）：個人利用／社内利用は無料です。 プラットフォームの商用利用には、Orchestrum Technologies LLP との契約が必要です。[email protected] までご連絡ください。 この方針は新規アカウントだけでなく、対象となる既存ユーザーと新規ユーザーにも適用されます。 既存のホスト型サービスの顧客には、適用される通知および契約条件に従って移行します。 利用条件とライセンスをご覧ください。現在の Apache-2.0 の権利に変更はありません。 具体的な移行では、将来の対象プラットフォーム素材について、利用資格のある利用者向けに別途セルフユース／商用契約ライセンスを適用します。レガシーコードに条件を追加するものではありません。