OCL Context Layer

OCL 標準

OCL は、AI システムに Odoo の構造化され、範囲が明確で、検証可能なビジネス上の意味を提供するための実験的なオープンフォーマットです。

Odoo コネクターは、レコードへのアクセス方法を説明します。OCL コンテキストパックは、関連するレコードやフィールドが何を意味するか、どのような解釈に誤りがあるか、どのような曖昧さを解消する必要があるか、適用される安全上の境界は何かを説明します。

question -> OCL context -> AI reasoning + existing connector -> Odoo

OCL を使う

製品に合った利用方法を選んでください。

経路	呼び出し	利点	アルファ版の利用状況
AI エージェント向け MCP	get_context, resolve_noun, explain_field	範囲を限定した Odoo の意味を、エージェントのツールループに直接組み込めます	公開サンプルまたは招待制ランタイム
CLI	get-context "What is revenue?"	コンテキストパックとその警告をすぐに確認できます	公開サンプルを現在利用可能
Python バリデーター	validate_entry(entry, schema)	相互運用可能な OCL ドキュメントを読み込み、生成できます	現在利用可能
TypeScript 統合	本番運用向けの5種類の操作形式	製品を検証済みホスト型ランタイムに接続できます	ソースアルファ版および招待制ランタイム

コンテキストの動作をクローンして試してください。

git clone https://github.com/Nantiai/ocl-standard.git
cd ocl-standard
python reference/python/ocl_examples.py get-context "What is revenue?"

結果では、どの収益定義を適用するかが尋ねられ、account.move.amount_total を普遍的な収益として扱わないよう警告が返されます。

エージェントにサンプル MCP を追加する

{
  "mcpServers": {
    "ocl-public-examples": {
      "command": "python",
      "args": [
        "/absolute/path/to/ocl-standard/reference/python/ocl_examples.py",
        "serve-mcp"
      ]
    }
  }
}

このローカルサーバーは、公開されている10件の候補サンプルを使って、実際の OCL ツールコントラクトを実演します。商用の Odoo 19 ランタイムではありません。

統合の流れ、MCP 呼び出し、CLI コマンド、SDK の例、応答処理、現在のアクセス境界については、OCL の使用方法 をご覧ください。コネクターおよび MCP の実装者は、適合性テストフィクスチャとともに コネクターランタイムコントラクト を基準にしてください。ホスト型ランタイムのクライアントは、検証済みアルファ版の呼び出しガイド を参照できます。開発者はまず 検証済みの判断をライブで1件試す ことができ、その後 範囲を限定した7日間のトライアルを開始 できます。GitHub、パッケージのインストール、Odoo の認証情報、顧客データは必要ありません。GitHub からのリクエスト と メール も代替手段として引き続き利用できます。

このリポジトリには、オープンな相互運用レイヤーが含まれています。

• セマンティックエントリーおよびリクエスト範囲のコンテキストパック向け JSON Schema
• 依存関係を抑えた Python バリデーターと TypeScript クライアントの形式
• 主要なナレッジタイプを網羅する、Odoo 19 の候補サンプル10件
• 実行可能な適合性テストスイート
• サンプル専用のリゾルバーと MCP サーバー
• 公開ベンチマークの方法論

nanti.ai の商用レジストリ、本番用アセンブラー、検証ハーネス、ソースフィンガープリント、非公開ベンチマーク、テナントオーバーレイ、メモリー、未公開のオントロジー候補は含まれていません。

ステータス

バージョン 0.1.0 は実験的な技術アルファ版です。独立した実装によるテストが進む間、フォーマットは変更される可能性があります。サンプルはフォーマットを実演するものであり、商用の検証済みレジストリではなく、恒久的な保証もありません。

現在、標準バージョンの対象は Odoo 19 のみです。

外部開発者向けアルファ版

開発者は、標準をクローンして適合性テストを実行し、サンプル MCP サーバーを統合して、独立した実装について報告できます。開発者向けアルファ版ガイドをご覧ください。

公開アルファ版は相互運用のための窓口であり、商用の検証済みレジストリに対する無料の一括アクセスではありません。範囲を限定した検証済みランタイムは https://api.context.nanti.ai で稼働中です。ネイティブ形式では、有効期限付きの範囲限定評価キーがすぐに発行されます。

基本的な考え方

meaning -> evidence -> rule -> assertion -> applicability -> confidence

LLM がもっともらしい JSON を作成したからといって、事実が検証済みになるわけではありません。適合するドキュメントは、証拠と主張を記述します。レジストリ運用者は、リリースにおける主張に対してどの検証ポリシーが十分かを別途判断します。

詳細はこちら

• 概要
• テクニカルアルファ
• フォーマット v0
• クイックスタート
• OCL の使用
• コネクターランタイム契約
• 外部開発者向けアルファ
• ガバナンス
• コントリビューション

独立性

Odoo は Odoo S.A. の商標です。このプロジェクトは独立して開発されており、 Odoo S.A. と提携しておらず、同社から承認を受けているものでもありません。

ライセンス

公開リポジトリはApache License 2.0の下でライセンスされています。 商用の OCL レジストリおよびサービスは別個のものであり、このリポジトリでは配布されていません。