vocion-core

Vocion (@vocion/core) は、AIエージェントのワークフローを単なるプロトタイプではなく、本番環境で実行するためのオープンフレームワークです。READMEでは、想定ユーザーをエージェントチームを本番導入しようとしているエンジニアやテックリードとしており、単一のチャットボット、使い捨てのスクリプト、またはホスト型のノーコードビルダーには適さないことを明記しています。Postgresの運用、gitでの設定管理、および重要なアクションへの人間による介在（human-in-the-loop）を前提としています。コアパッケージはnpmに公開されておらず、リポジトリをクローンして自身で実行する形式です。 プラットフォームの構成 Vocionは、Next.jsアプリ、Postgresスキーマ、MCPサーバー、およびワークフローランナーを組み合わせたものとして説明されています。Sources、Objects、Skills、Playbooks、Workflows、Missions、Automations、Agents、Teamsをgit上のYAMLおよびMarkdownで作成し、データベースに適用することで、統一された人間レビューキュー、オブザーバビリティ、プラグインエコシステムを備えた型定義済みランタイムを利用できます。 1つのランタイムで3つの動作モードを共有します： - Workflows：承認および問い合わせゲートを持つ決定論的なステップ。 - Missions：オープンエンドな継続的責任。エージェントチームが計画・作業し、レビューの下で成果物を生成します。 - Teams：リードエージェントの下にグループ化された複数のエージェントと、責任を持つ人間。 その他の機能として、Google Ads、GA4、HubSpot、Gmail、Slack、Google Drive向けの組み込みコネクタパック（増分ベースのクライアントスコープ取り込みパイプライン）が提供されています。また、権限プリンシパルに解決されるテナントBearerトークンを備えたマルチテナント制御プレーン、REST経由でレビューキューを公開する書き込みAPI（レビュー一覧および決定エンドポイント）、およびエージェント・ツールプレーンとしてのHTTP経由のMCPを備えています。探索権限と変更権限は分離されており、承認ゲートを伴う自律性ラダーが実行を制御し、クライアント間の分離はプロンプトではなくクエリレベルで強制されます。 エージェントの実行は、単一の設定「harness.runsOn」で構成可能です。ドキュメント化されているオプションには、アプリプロセス内でのエージェントループ実行、AWS Bedrock AgentCore Runtime上のプロジェクト専用コンテナでの実行、またはAWSのマネージドハーネスへの委譲があり、それぞれのケースでどのAWSアカウントがトークン費用を支払うかが説明されています。 レイヤードパッケージとプラグイン契約 リポジトリは、より大きなプラットフォームのコアレイヤーとして機能します。SDKパッケージは、SkillおよびPluginManifest型、LLMクライアント型を含む安定したプラグイン契約を定義します。コネクタとスキルは個別のプラグインnpmパッケージとして提供され、フォーク可能なスターターインストールが別リポジトリで計画されています。 プラグインはマニフェストをエクスポートするnpmパッケージであり、コアは起動時にSDK経由でマニフェストをロードします。READMEには、スキーマ検証ライブラリを使用して構築されたスキル定義のサンプルが示されており、slug、name、version、provider、承認要件、入出力スキーマ、およびrun関数を宣言し、PluginManifestとしてエクスポートします。参照用のtranscript-highlightsプラグインがpackages/pluginsディレクトリに存在します。 Workspace as Code すべてのテナントコンテキストはワークスペースに格納されます。これはリポジトリチェックアウトの外にある、gitで管理されたYAMLとMarkdownのディレクトリ（通常は独自のリポジトリ）であり、これによりクライアントコンテキストをプルリクエストでレビューでき、コアに混入することを防ぎます。環境変数でアプリにパスを指定し、指定がない場合はワークスペースは構成されません。ドキュメント化されているエンティティタイプと場所には、ワークスペースマニフェスト、エージェント（YAMLファイルとシステムプロンプトMarkdownファイル）、チーム、スキル、プレイブック、ミッション、APIで作成されたワークフロー実行、ワークフロー、時間とイベントを定義する唯一の場所であるオートメーション、ソースウェイトと分類プロンプトを持つオブジェクトタイプ、コネクタの種類と同期頻度を持つソース、自動実行可能なアクションを定義する信頼ルール、蓄積されたルールの名前付きバケットである学習ステップ、エージェントごとのテストケース用評価データセット、およびテナント定義のダッシュボードページが含まれます。 コア内部にベースパックが同梱されており、ワークスペースの下にレイヤーとして配置されます。extendsディレクティブで固定し、useリストでエージェントを有効化し、同じslugのファイルでデフォルトをオーバーライドします。ワークスペースをデータベースに適用すると、ワークスペースバージョンを含む監査行が記録され、ツール呼び出しにはワークスペースハッシュがスタンプされるため、出力結果を生成したプロンプトまで遡ることができます。 セットアップと運用 導入手順は、クローンとインストール、環境例ファイルのコピー、データベースURL、認証シークレット、および少なくとも1つのLLMプロバイダーキーの設定から始まります。dev:upスクリプトでサポートサービス（Postgres、Langfuse、Temporal）を起動し、マイグレーションを実行し、ワークスペースをスキャフォールディングしてWORKSPACE_PATHを指定し、適用した後、localhostのポート3000で開発サーバーを起動します。プロジェクトスクリプトには、リンティング、型チェック、テスト、ワークスペースの適用、および評価実行も含まれています。 Claude Code、Cursor、ZedなどのMCPクライアント向けに、単一開発者向けのローカルstdioコマンドと、テナントBearerトークンから組織が導出されるリモートHTTPエンドポイントが提供されています。すべてのツール呼び出しは、人間と同じ権限モデルの下でその組織にスコープされます。 認証情報は双方向で処理され、ダッシュボードページから管理されます。インバウンドトークンはVocionによって発行され、SHA-256ハッシュとしてのみ保存され、平文では一度だけ表示されます。アウトバウンドのベンダーキーはワークスペースごとに提供でき、組織ごとのデータ暗号化キーを用いてAES-256-GCMで保存時に暗号化されるため、ワークスペース自身のベンダーアカウントに請求されます。プラットフォームあたり、組織あたり1つのライブキーが保持されます。すべてのアウトバウンドベンダー呼び出しは、まずワークスペースに保存されたキーを解決し、次にサーバーの環境変数を解決します。これはチャットモデル、取り込みおよびクエリ時の埋め込み、リランキング、ビジョン、画像生成をカバーしますが、設計上の2つの内部パスはサーバーキーを維持します。暗号化設定には、開発用のローカルVaultモードと、実際の顧客キーを保持するインストールに推奨されるKMSモードがあります。 検索はファーストパーティで提供されます。pgvector（HNSWコサイン）とPostgres全文検索を組み合わせ、2つのアームを相互順位融合（Reciprocal Rank Fusion）で統合し、オプションでLLMリランクを行います。埋め込みおよびリランクモデルは環境レベルの設定であり、タイプ別およびエージェント別の検索ウェイトは、コード変更なしにワークスペースで作成されます。 スタックと統合 使用されているスタックは、App Routerを備えたNext.js 16、React 19、厳格なTypeScript、ORMを備えたPostgreSQL 16、Auth.js / NextAuth v5（アカウントおよびプロジェクトメンバーシップによるロールベースアクセス制御）です。LLMプロバイダーとしてOpenAIとAnthropicをスキルごとに切り替えて利用でき、LLMトレースにLangfuse、スパンとメトリクスにOpenTelemetryを使用しています。また、Postgres上のインプロセス耐久性ワークフローステップランナーを備えています。Slackチャットインターフェースでは、エージェントをメンションするとスレッド返信が生成されますが、承認が行われるのは（機能フラグの背後にある）レビューキューのみです。さらに、リース、ハートビート、実行ごとのコスト、およびリーパーを備えた、数時間に及ぶ実行のための外部ワーカー制御プレーン（これも機能フラグ付き）を備えています。 ライセンス 本プロジェクトはMozilla Public License 2.0の下でソース公開されており、これはOSI承認済みでファイルレベルのコピーレフトです。利用、セルフホスト、検査、修正、およびより大きなプロプライエタリシステムへの組み込みが可能であり、配布される修正済みVocionファイルはMPLの下でオープンに保たれますが、周囲のアプリケーションコードはユーザーに帰属します。READMEには、データ、ビジネスコンテキスト、エージェント設定、ワークフロー、評価履歴、および運用出力はユーザーに帰属し、プロジェクトを独自の環境にデプロイ可能であることが明記されています。Vocion自体のホワイトラベル化、プロプライエタリライセンスでの配布、ベンダーサポート付きマネージドサービス、プロプライエタリなエンタープライズモジュール、または商用保証およびサービスレベルの提供などの特定の利用には、別途契約が必要です。名称およびロゴはMetacto, Inc.の商標であり、MPLは商標権を付与しません。 ドキュメントへのポインタ READMEには、コードなしで空のディレクトリから動作するエージェントワークフォースを構築するクイックスタートガイド、リポジトリ内で動作するコーディングエージェント向けファイル、マシン読み取り可能なドキュメントインデックス、ワークスペース作成ガイド、エンティティごとのフィールドリファレンス、すべてのオブジェクトがどこで作成・保存・実行・表示されるかを説明するオブジェクトモデルページ、ダッシュボードページガイド、および複数の環境と親プロジェクトパターンをカバーするデプロイメントドキュメントへのリンクがあります。貢献ガイドでは、ツールによって強制されるConventional Commits、DCOサインオフ、およびコミット前の型チェック、テスト、リンティングの実行について説明されています。