Ars Umbrisとは？
Ars Umbrisは、型付き知識のための柔軟でエージェントネイティブなIDEです。知識、型、スキル、ツール、UIコンポーネントを、相互に依存できるコンポーザブルなリポジトリに組み合わせます。
このプロジェクトは、これらのリポジトリを単一の型付きグラフとして読み込みます。フィールドと参照を検証し、エージェントが対処できる診断情報を提供します。人間とエージェントは、同じプリミティブとSDKを使ってツールを構築し、ビューを追加し、アプリケーションを変更できます。
Ars Umbrisは現在アーリーアルファ版です。そのため、バグや破壊的変更が発生する可能性があります。現在はmacOSのみをサポートしています。
アーキテクチャの構成
Ars Umbrisは、主に3つのレイヤーで構成されています。これらを理解すると、システムの設定や拡張時にどこを確認すべきか判断しやすくなります。
1. au-engine
au-engineは、型付きファイル基盤上に構築された、リポジトリ横断型のグラフエンジンです。リポジトリ間のファイルをインデックス化し、型付きでクエリ可能なライブグラフに変換します。
このエンジンは、MarkdownファイルとYAMLファイル向けのカスタム型付け言語も実装しています。詳しくはau-engine.mdを参照してください。
2. au-host
au-hostはElectronホストアプリケーションです。グラフ上に型付きのプロジェクション、つまりビューをマウントし、型付きデータに対する設定駆動型のコンポジションをサポートします。
これらのコンポジションは編集可能で、人間とエージェントの両方が操作できます。ホストのドキュメントについてはau-host.mdを参照してください。
3. au-mcp
au-mcpは拡張可能なエージェントレイヤーを提供します。MCPを通じて型付きツールとスキルを公開し、アダプターを介して任意のエージェントハーネスと連携します。
MCPレイヤーの詳細はau-mcp.mdを参照してください。
インストールの準備
インストールでは、次の2つのディレクトリを使用します。
~/arsumbris/には複数のArs Umbrisリポジトリを格納します。~/.arsumbris/にはArs Umbrisの設定ファイルを格納します。
このプロジェクトはmacOS専用で、現在も活発に開発されています。そのため、システムを変更する前に前提条件を確認してください。必要なソフトウェアとセットアップの順序については、リポジトリにある現在のインストール手順が正式な情報源です。
エントリーポイントリポジトリをインストールする
READMEでは、次の指示を使ってエージェントにインストールを実行させることを推奨しています。
Ars Umbrisのインストールを手伝ってください。
1) まだ存在しない場合は、次の2つのフォルダーを作成してください。
- ~/arsumbris/ は複数のリポジトリを格納します。
- ~/.arsumbris/ は設定を格納します。
2) エントリーポイントリポジトリをクローンしてください。
git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris
その保存先がすでに存在する場合は、先に確認してください。上書きしてはいけません。
3) ~/arsumbris/arsumbris/INSTALL.md を読み、現在のセットアップ手順に従ってください。
前提条件を確認し、私のマシンで必要となる変更について、実行前に説明してください。重要な安全手順は、クローンする前に既存の~/arsumbris/arsumbrisディレクトリを確認することです。既存のチェックアウトを上書きしてはいけません。リポジトリを利用できる状態にしたら、INSTALL.mdを開き、記載された現在の手順に順番どおり従ってください。
リポジトリの現在のセットアップ手順に従う
- macOSを使用していることを確認します。
- まだ存在しない場合は、
~/arsumbris/と~/.arsumbris/を作成します。 ~/arsumbris/arsumbrisがすでに存在するか確認します。- 存在しない場合は、
git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbrisでリポジトリをクローンします。 - すでに存在する場合は、置き換えずに確認します。
~/arsumbris/arsumbris/INSTALL.mdを読みます。- そのファイルで指定されている前提条件を確認・インストールし、適用前に提案されたマシンの変更内容を確認します。
INSTALL.mdに記載された順序で、残りのセットアップ手順を完了します。
Ars Umbrisは活発に開発されているため、第三者の情報源にある古いセットアップ手順に依存しないでください。インストールするバージョンについては、チェックアウトしたリポジトリのインストールガイドを使用してください。
基本的な使い方
Ars Umbrisは、型付き知識と機能を含むリポジトリを中心に設計されています。リポジトリには、知識、型定義、スキル、ツール、UIコンポーネントを含めることができます。また、リポジトリは他のリポジトリに依存できるため、プロジェクト間で機能や知識を再利用できます。
大まかなワークフローは次のようになります。
- 関連するリポジトリを
~/arsumbris/の下に配置またはクローンします。 au-engineに、それらのリポジトリ全体のファイル基盤をインデックス化させます。- 生成された型付きグラフを使って、関連するデータ、フィールド、参照を操作します。
au-hostを使って、グラフ上にプロジェクションとビューをマウントします。au-mcpとMCPアダプターを介してエージェントハーネスに接続します。- エージェントまたは人間のユーザーが診断情報を確認し、ツールを構築し、ビューを追加し、アプリケーションを変更します。
READMEでは、特定のサンプルプロジェクトやコマンドラインのワークフローを1つに定めていません。具体的なコマンドと利用可能なプロジェクションは、INSTALL.mdに記載されたセットアップと、接続するリポジトリによって異なります。
MCPを介してエージェントと連携する
Ars Umbrisは、Model Context Protocolを介してエージェントハーネスに接続できるように構築されています。au-mcpレイヤーが型付きツールとスキルを提供し、アダプターがそれらの機能を選択したハーネスに接続します。
これにより、エージェントはアプリケーションの構築に使われるものと同じ基盤のプリミティブとSDKを操作できます。実際には、インストールで利用可能な機能と設定の範囲内で、エージェントはツールの構築、ビューの追加、アプリの変更に参加できます。
高度なヒントと安全性に関する考慮事項
リポジトリを組み合わせ可能な状態に保つ
知識と機能を、再利用および接続できるリポジトリに整理します。リポジトリ間の依存関係はプロジェクトモデルの中心であるため、リポジトリを孤立したフォルダーではなく、1つの型付きグラフを構成する要素として捉えてください。
診断結果をフィードバックとして活用する
エンジンは、型付きグラフ全体のフィールドと参照をチェックします。型付きMarkdown、YAML、または関連するリポジトリのコンテンツを編集するとき、特にエージェントが変更を加える場合は、その診断結果をフィードバックとして扱ってください。
各レイヤーのドキュメントを読む
動作を理解する必要がある場合は、該当するレイヤーのドキュメントを参照してください。エンジン、ホスト、またはMCPエージェントレイヤーが該当します。
適用前に変更を確認する
インストールプロンプトでは、必要なマシンの変更を行う前に、その内容を説明することが明確に推奨されています。エージェントによるリポジトリや設定の変更を許可する場合も、同じ慎重な姿勢を取ってください。
現在のセキュリティモデルを考慮する
Ars Umbrisはマシン上でコードを実行し、現在サンドボックス機能を備えていません。プロジェクトを使用する前にSAFETY.mdを確認してください。特に、エージェントを接続する場合や、完全には管理していないリポジトリを扱う場合は注意が必要です。
まとめ
Ars Umbrisは、型付きのリポジトリ横断グラフ、Electronベースのホスト、MCPエージェントレイヤーを組み合わせた、型付き知識のための実験的なIDEです。使い始めるには、2つの設定ディレクトリを用意し、既存のファイルを上書きせずにエントリーポイントリポジトリをクローンして、現在のINSTALL.mdに従ってください。インストール後は、プロジェクトがアルファ版であり、サンドボックスなしでコードを実行するモデルであることを念頭に置きながら、リポジトリ、プロジェクション、ツール、スキル、エージェントがどのように連携するかを確認してみましょう。