HN 日本語サマリー

← 一覧へ戻る
AI・機械学習

qm

qm (github.com)

644 pointsby tosh151 コメント

要約

qmは、スタートアップ向けに設計されたマルチプレイヤーAIエージェントハーネスです。各従業員は独立したワークスペースを持ち、エージェントとチャネル、グループメッセージ、プロジェクトで協力できます。各ユーザーとルームには、スコープ化されたメモリ、ファイル、権限、サンドボックスなどが備わっています。Pi、OpenCode、Codex、Claude Codeなど、複数のモデルやハーネスを切り替え可能で、ベンダーに依存しない設計です。

全文翻訳

QM

[画像: QM]

仕事のためのマルチプレイヤーエージェントハーネス。SlackとWebで利用可能。
独自のモデルとキーを使用して、自身のクラウドで実行できます。

[画像: CI] [画像: license] [画像: node] [画像: npm]

デプロイ · 仕組み · セキュリティモデル · カスタマイズ · 貢献 · ドキュメント

概要

ほとんどのエージェントはパーソナルアシスタントのように設計されています。会社全体で機能させることも可能ですが、すぐに複雑になります。QMはスタートアップ向けに設計されています。従業員はそれぞれ独立したワークスペースを持ち、チャンネル、グループメッセージ、プロジェクトでエージェントと共同作業することもできます。

各個人と各ルームは、独自のスコープされたメモリ、ファイル、キーチェーンビュー、権限、クロン、Webアプリ、および耐久性のあるサンドボックスを持っています。

オープンソースを念頭に置いて構築されています。独自のハーネスとモデルを選択し、それらを切り替えることができます。PiとClaude Codeは同じコアを駆動し、Piは多くのプロバイダーのモデルを実行するため、デプロイメントは単一のベンダーに縛られません。

セットアップ

選択したコーディングエージェントに「Let's deploy https://github.com/yc-software/qm」と指示してください。そこから、このリポジトリのデプロイガイドに従うはずです。

こちらでサードパーティホスト版のQMを試すこともできます。

インフラプロバイダーでQMのホスト版を提供することに興味がある場合は、お気軽にお問い合わせください。

機能

  • 個人用および共有スコープ。 人々はエージェントを「自分専用」にカスタマイズし、Slackチャンネルやプロジェクトで共同作業することもできます。
  • SlackとWeb。 同じIDと設定がSlackとWebアプリ間で引き継がれます。
  • 管理者コントロール。 組織レベルの設定、セキュリティ、共有ポリシーを設定します。利用可能なハーネスとモデルを選択します。
  • Webアプリ。 カスタム内部アプリを起動し、適切なユーザーに公開します。
  • 共有スキル。 スキルはスコープ所有であり、付与によって共有可能で、管理者が組織全体に昇格させたり、Gitリポジトリからスキルパックをインポートしたりできます。
  • バックグラウンド処理。 クロン、ウォッチ、インバウンドWebフックは、あなたが不在の間も機能します。

これでできること

  • 内部メモ、メール、ドキュメント、データベース、およびWebを一緒に検索する
  • 内部アプリを構築し、適切なユーザーに公開し、データを最新の状態に保つ
  • 過去の送信からライティングボイスを学習し、スケジュールに基づいて受信トレイをトリアージする — ラベルと返信ドラフトを含む
  • 既存のリポジトリで作業する:テストを実行し、PRを開き、CIを監視し、システムログを確認する
  • 共有チャンネルでプロジェクトを追跡し、更新とフォローアップを投稿する

アーキテクチャ

flowchart LR
  DB[("Postgres<br/>sessions · memory · queue")]

  subgraph CORE["Headless core"]
    API["API · identity · policy · scheduler"]
    LOOP["Agent loop<br/>(Pi, Claude Code)"]
    API <--> LOOP
  end

  SBX["Per-scope sandbox<br/>files · tools · logged-in services"]

  DB <--> API
  LOOP <--> SBX

読み込み中

耐久性のために、DATABASE_URLとSESSION_STORE=postgresを設定してください — これがない場合、セッションはプロセスメモリに保存され、再起動時に消滅します。実際のモデルと実際のPostgresに対してブランチをテストするには、Web/管理の場合はnpm run dev-instance:web、Slackの場合はnpm run dev-instance:slackを実行します。両方のサーフェスを同時にテストする場合は、npm run dev-instance:bothを使用します。単なるnpm run dev-instanceは、新しいインスタンスではデフォルトでWebを使用し、リロード時にサーフェスを保持します。明示的なサーフェスコマンドで既存のインスタンスを切り替えます。

仕組み

すべてのターンは中央コアを通過し、コアはさまざまなモデルとハーネスを使用して応答を生成できます。Postgres永続化レイヤーは、ユーザーデータ、セッション履歴、その他の永続状態を保持します。エージェントは小さく固定されたツールサーフェスを持っています。そのツールの1つがexecuteで、これはスコープ独自の分離されたサンドボックス — インストールされたツールがインストールされたままになる耐久性のあるコンピューター — でコマンドを実行します。Web UIと管理パネルは1つのサービスを共有します。ポータルとオプションの組み込み認証ブローカーは別のサービスを共有します。これらのモジュールは、HTTP APIを介してコアと通信します。設定と移行については統合サービスを参照してください。Slackは、コアが直接サービスクライアントを介して開始および監視するオプションのインプロセスプラグインです。

コアはNode上でTypeScriptを直接実行し、HTTPにはFastifyを使用します。SlackプラグインはBoltを使用し、Web UIはViteで構築され、Litでレンダリングされます。

コア自体は汎用的です。1つの会社に固有のすべて — 組織構成、カスタムツールとスキル、サンドボックスイメージ、インフラストラクチャ — は、qm CLIが検証およびデプロイするデプロイメントディレクトリに格納されます。すべてのサブストレート(ハーネス、セッションストア、サンドボックス、メモリ)はインターフェースの後ろにあります。メモリは、組み込みノートブックを維持しながら、スコープによって外部プロバイダーにルーティングすることもできます。

セキュリティとシークレット

QMのアプローチは、OpenCode、Codex、Claude Codeなどのローカルコーディングエージェントに従います。エージェントは、その資格情報と権限を持つ担当者として機能し、そのすべての操作は監査されます。組織は1つのセキュリティポスチャーを選択し、それより狭いスコープはそれを強化することしかできません。

  • Strict — 人間の承認のために、効果のない2つのターン終了以外は、すべてのハーネスツールの呼び出しが一時停止します。
  • Auto(デフォルト) — プライベートネットワークアクセスをブロックします。
  • Dangerous — ツール承認ゲートはなく、コンテンツスクリーニングは観察のみを行います。

コンテンツスクリーニングはデプロイメント設定securityScreen.modeで、off(デフォルト)、observe、またはenforceがあり、securityScreen.classifierは組み込みのmodelまたは外部のproxyを選択します。オンの場合、すべてのポスチャーで外部コンテンツを分類します。observeは監査ログに判定のみを記録します。enforceは、Dangerousの場合を除き、リリース承認を待ってフラグ付けされたコンテンツを検疫します。Dangerousはスクリーニングをobserveに制限します。

事前定義されたコマンドポリシー — 再帰的削除や破壊的なSQLなどの承認ルールとハード拒否 — は、Dangerousを含め、すべてのポスチャーで適用されます。

共有ポスチャーは独立しています。

  • Isolated(デフォルト) — リソースは明示的に共有されない限り、そのスコープ内に留まります。
  • Open — ライブ認証された内部人間のターンで、話者のオプトインした個人ファイル、成果物、スキル、およびメモリは、オプトインされた共有ルームで読み取ることができます。

SECURITY.mdには、脅威モデル、オペレーターの前提条件、および既知の制限事項が記載されています。

組織のためにデプロイする

@yc-software/qmに依存する組織所有のデプロイメントリポジトリを作成します。

npm exec --yes --package=@yc-software/qm@latest -- \
  qm init . --org <slug> --target <fly-or-aws>
npm install

初期化により、エージェント用のデプロイメントスキルが生成され、インフラストラクチャ、Webサインイン、コネクタ資格情報、オプションのSlackアクセス、デプロイメント、およびライブ検証がウォークスルーされます — ソースチェックアウトは不要です。各デプロイメントはオペレーター自身のクラウドアカウントで実行されます。初期化はデプロイメントCIを生成または有効化せず、このリポジトリには本番デプロイメントワークフローがありません。詳細はdeployment.mdを参照してください。

貢献

私たちは、コードではなく、人間が書いたテキストとして貢献を受け付けます — CONTRIBUTING.mdを参照してください。変更したい内容をadrs/内の.txtまたは.mdファイルで非公式に説明してください。合意が得られれば、実装を行います。脆弱性は、公開された問題ではなく、SECURITY.mdを参照してプライベートに報告してください。

インスタンスのカスタマイズ

QMをカスタマイズする方法を選択します。

  • 構成、ツール、スキル、およびサービス: 上記のデプロイメントリポジトリを使用します。これは@yc-software/qmをピン留めし、そのリリースのランタイムイメージを使用します。ソースコピーは不要です。
  • QM自体の変更: 独自のソースフォーク(公開または非公開)を維持します。コアの任意の部分(ランタイム、プラグイン、CLI、ドキュメント、CIを含む)を変更できます。それらの変更をアップストリームに貢献することはオプションです。
ソースフォークの作成

プライベートソースフォークの場合、GitHubのフォークネットワーク外にスタンドアロンのプライベートリポジトリを作成します。mainのみをシードし、デフォルトブランチとして明示的に設定します。

gh repo create <org>/qm-private --private
git clone --single-branch --branch main --no-tags git@github.com:yc-software/qm qm-private
git -C qm-private remote rename origin upstream
git -C qm-private remote add origin git@github.com:<org>/qm-private
git -C qm-private push -u origin main
gh repo edit <org>/qm-private --default-branch main

git push --mirrorでシードしないでください。これは無関係なアップストリームブランチやタグをコピーし、デフォルトブランチの選択を暗黙的にし、後続のプッシュで宛先専用の参照を削除する可能性があります。upstreamリモートは、それらの参照をリポジトリにコピーせずにソースアップデートを提供します。パブリックソースフォークの場合、GitHubのForkボタンもオプションです。パブリックリポジトリのGitHubフォークはプライベートにできません。プライベートな作業は、そのネットワークの外に置いてください。

Actionsを有効にする前や資格情報を追加する前に、継承されたワークフローを確認してください。必要なCIチェックを選択し、独自のパッケージおよびイメージレジストリ用のアップストリームリリースおよびパブリッシングワークフローを無効にするか、適応させてください。ソースをコピーしても、本番デプロイメントCIは構成されません。

ソースのカスタマイズと実行

デプロイメント構成、ツール、スキル、プラグインイメージ、およびインフラストラクチャは、プライベートソースフォークのdeploy/layers/<org>/内、またはソースがパブリックな場合は別のプライベートデプロイメントリポジトリに保持します。シークレットをコミットしないでください。初期化とレイアウトについては、deploy/layers/README.mdを参照してください。デプロイメントデータをコアコードから分離しますが、望ましい動作が必要な場合はコアを変更してください。

ソースチェックアウトから、npm ciで依存関係をインストールし、インツリーCLIを使用します。deployment.mdでプロバイダーセットアップを完了した後、変更されたサービスを明示的にビルドしてデプロイします。

node cli/bin/qm.ts check --config <deployment-dir>/qm.config.jsonc
node cli/bin/qm.ts plan --config <deployment-dir>/qm.config.jsonc --build-from .
node cli/bin/qm.ts up --config <deployment-dir>/qm.config.jsonc --build-from .
node cli/bin/qm.ts check --config <deployment-dir>/qm.config.jsonc --live

CLI自体を変更する場合は、このチェックアウトのCLIを使用します。--build-fromなしでは、通常のデプロイメントパスは公開されているイメージを選択するため、ソースを編集するだけではデプロイされたランタイムは変更されません。カスタムイメージを公開する場合は、imageOverridesを介してそれらの不変参照を構成します。プロバイダーガイドに従ってサンドボックスイメージをビルドしてください。サービスビルドは、そのステップを置き換えるものではありません。

最新の状態に保つ

ソースフォークの場合、update-qmは意図したローカル動作を維持しながらアップストリームの変更をマージします。同期PRは、マージの祖先をそのままにして着陸させ、決してスクワッシュまたはリベースしないでください。コンフリクトは、カスタマイズを破棄する必要があるのではなく、期待されるメンテナンス作業です。汎用的な変更を貢献したい場合のみupstream-prを使用してください。これは、プライベートデプロイメントデータや履歴なしでクリーンなアップストリームブランチを準備します。

パッケージデプロイメントの場合、@yc-software/qmの依存関係とロックファイルを正確にアップグレードし、契約変更と生成されたアセットを確認してから、検証およびデプロイします。マージするアップストリームソース履歴はありません。

より深く学ぶ

ライセンス

特に明記されていない限り、QMはMITライセンスの下で利用可能です。