PremAgentic

PremAgentic

オンプレミスで、エージェントのために。その名が示すとおりです。顧客自身のネットワーク内だけで動作する、ガバナンスの効いたナレッジ検索です。Markdown、テキスト、PDF、Word、Excel ファイルを含むフォルダーを指定し（最後の3種類は、管理者が許可したファーストパーティ拡張機能を通じて読み込みます）、どのユーザーがどのフォルダーを読めるかを設定すると、ユーザーやエージェントは、検索前にルールが適用された状態で、引用付きの回答を得られます。

PremAgentic は、モデルが何を知ることを許可されるかを決定します。すべての回答は、信頼性、作成者、鮮度が示された引用付きの文章です。

the customer's folders of documents -> connector -> chunk -> embed (locally)
-> plain PostgreSQL -> access, lifecycle, trust and freshness gates
-> lexical search in PostgreSQL + exact vector search in process, fused
-> cited answers
-> a golden set that proves it works on THIS corpus

実行時には、デフォルトのローカル埋め込みプロバイダーを使う場合、PremAgentic は外部への呼び出しを行わず、サードパーティの API キーも必要とせず、独自にドキュメントをどこかへ送信することもありません。ホスト型モデルで動作するアシスタントには、検索のたびに返される文章が渡されます。PremAgentic は各エージェントのモデルがどこで動作するかを確認し、すべての監査行に回答を記録します。また、そのモデルを使うものとして登録されたすべてのエージェントから、フォルダーを隠すこともできます（アシスタントを接続するを参照）。管理者がオプションの openai 埋め込みプロバイダーを選択するか、外部への呼び出しを行う拡張機能をインストールして許可しない限り、PremAgentic がほかのものに接続することはありません。メールを送信するリマインダー用シンクはサンプルであり、組み込み機能ではありません。認証局が発行した HTTPS 証明書を使う場合、実行環境の TLS スタックが証明書の失効状態（OCSP）や不足している中間証明書を複数回取得することがあります。デフォルトの自己署名証明書の設定では、そのようなアドレスへの名前解決は行われません。

この主張をどのように検証するか、またインストール時に一度だけインターネット接続が必要となる内容については、PremAgentic とはを参照してください。

読み込むファイル

Markdown ファイルとプレーンテキストファイルは、組み込みリーダーで読み込まれます。PDF、Word（.docx）、Excel（.xlsx および .xlsb）ファイルは、このリポジトリに含まれる3つのファーストパーティ拡張機能、extensions/pdf-reader、extensions/docx-reader、extensions/xlsx-readerで読み込まれます。これらはソリューションとともにビルドされますが、ほかの拡張機能と同様に、それぞれのビルド出力を拡張機能フォルダーに配置し、prem extensions allow で許可した場合にのみ読み込まれます。3つともテキストだけを読み込み、それ以外は扱いません。ドキュメント内のリンク、スクリプト、マクロ、埋め込みファイルをたどったり実行したりすることはなく、上限を超えたファイルは、超過した上限とともに報告され、部分的に読み込まれることもありません。PDF の文章はページ、Word の文章はドキュメント独自の見出し、Excel の文章はシートを引用元として示します。リーダーが認識してもインデックス化しないファイルは、.pdf (テキストレイヤーなし)、.doc (旧形式の .doc)、.docm (マクロ有効) のように、その理由とともに集計されます。どのリーダーも対応しないファイルは拡張子ごとに集計されるため、該当ファイルばかりのフォルダーが、何も処理されなかったように見えることはありません。ファイルをリーダーに渡す前に、実行時に読み込む量は最大256 MBです。また、インデックスに保存できないファイルがあっても、処理は停止しません。

tests/Premagentic.Benchmark は合成インデックス上の検索処理にかかる時間を測定します。誰でも使い捨てのデータベースで再実行でき、出力される各表には、実行したマシンと2つのモードのどちらを使ったかが記載されます（自分で測定する）。

対応していないこと

• ソースには書き込みません。
• 文章を生成しません。
• 画像やスキャンしたページの文字を認識しません。

最初の2つについては、対応していないことで説明しています。読み込むファイルについては上記をご覧ください。会社のディレクトリを使ったサインインについては、Teams 向け PremAgenticで次に説明します。

クイックスタート

# 1. Local stock PostgreSQL 17, on 5434 to stay clear of any PostgreSQL already on 5432 or 5433
docker compose up -d

# 2. Use the local development database for this shell. PremAgentic connects to
#    nothing unless told where; this switch names the compose instance.
$env:PREM_DEV_DATABASE = "1"    # Linux or macOS: export PREM_DEV_DATABASE=1

# 3. One time: fetch the local embedding model (all-MiniLM-L6-v2 ONNX, ~90 MB)
./scripts/download-model.ps1          # Windows; on Linux or macOS: ./scripts/download-model.sh

# 4. Create the two groups the sample corpus and golden set name
dotnet run --project src/Premagentic.Cli -- groups add hr
dotnet run --project src/Premagentic.Cli -- groups add engineering

# 5. Ingest the sample corpus. Each folder gets its own rule, so the two go in
#    separately with different audiences.
dotnet run --project src/Premagentic.Cli -- ingest ./sample-docs/open --public --prefix open
dotnet run --project src/Premagentic.Cli -- ingest ./sample-docs/hr --principals group:hr --prefix hr

# 6. Ask it something
dotnet run --project src/Premagentic.Cli -- search "how long do I have to file an expense claim" --as group:engineering

# 7. Prove the gate. HR reaches the salary bands; engineering does not.
dotnet run --project src/Premagentic.Cli -- search "band four compensation review" --as group:hr
dotnet run --project src/Premagentic.Cli -- search "band four compensation review" --as group:engineering

# 8. Run the golden set, which asserts both of those outcomes. It is the starter
#    profile's own file, so the questions are the ones the profile applies.
dotnet run --project src/Premagentic.Cli -- eval samples/profiles/starter/golden-set.json eval/report.md

# Tests (unit plus a Testcontainers end-to-end slice; Docker required)
dotnet test

同じ設定はプロファイルでもあります。新しいデータベースで prem profile apply ./samples/profiles/starter を実行すると、2 つのグループを作成し、ルールとともに 2 つのソースを登録して、ゴールデンセットを一度に設定します。再度適用しても変更はなく、その旨が表示されます。プロファイルをご覧ください。

データベースを設定していなくても、コマンドラインの使い方を確認できます。

prem --help                  every command, with every option explained
prem <command> --help        one command's part
prem --version               the version, with the commit it was built from
prem reminders run [--plan]  what each source owner is reminded of: stale documents and the review queue

全コマンドの一覧は、プログラムから生成される「prem」コマンドをご覧ください。

アシスタントを接続する

エージェントは、同じプロセス内の /mcp で、トークンを使って MCP 経由で接続します。エージェントには読み取り専用のツール search_knowledge と get_document_section が提供され、書き込み、保存、記憶を行うツールはありません。stdio のみを使用するエージェント向けには、Premagentic.McpServer がブリッジになります。接続方法については、アシスタントを接続するをご覧ください。

ユーザーは /portal/connect で自分のアシスタントを接続できます。そこで作成されるエージェントはそのユーザー本人としてのみ動作し、トークンは使用するアシスタントの設定とともに一度だけ表示されます。ユーザーは同じ場所でトークンを失効させることもできます。管理者は agents.self_service_max でユーザーごとの上限を設定できます（0 にすると無効になります）。また、connect.snippets で任意の設定文を書き換えられます。管理者は prem settings set mcp.instructions "<text>" で、すべてのアシスタントにデプロイ固有の指示を与えられます。接続時にサーバーから送られる内容を読み取るクライアントには、その指示がリソース premagentic://instructions として提供されます。また、接続ページには、AGENTS.md、CLAUDE.md、またはクライアント独自の指示に貼り付けられるよう、その指示が表示されます。

実際の画面を見る

フォルダールールによって、誰が何を読めるかが決まります。呼び出し元を指定する最初のエントリーが適用され、一致するものがなければ拒否されます。

任意のユーザーとドキュメントについて理由を尋ねると、PremAgentic がルールとすべてのゲートを表示します。ここでは、請負業者が温室のメモを閲覧できないよう制限されています。

すべてのエージェントには、モデルの実行場所が記録されています。エージェントをホスト型モデルに切り替えると、ホスト型モデルのエージェントに対して制限されていたフォルダーは、そのエージェントの次の呼び出し時に閉じられます。

監査には、誰が、どのポリシーの下で、モデルがどこで実行されたときに問い合わせたかと、提供されたすべてのパッセージが表示されます。ここでは、ホスト型モデルのエージェントに提供された内容に絞り込んでいます。

ドキュメント

• はじめに: PremAgentic とは、使い始める、アシスタントを接続する
• 判断の仕組み: アクセス、ライフサイクル、信頼性、新鮮さ、管理
• 運用: インストール、実行、アップグレードと削除、設定、ストレージ、完全ローカルなスタック
• 拡張: ソース、リーダー、チャンカー、拡張機能、拡張機能の作成、コネクター、プロファイル、チューニングとゴールデンセット
• リファレンス: サーフェス、prem コマンド、既知の状態、ロードマップ

各ドキュメントの内容を記載した一覧は、docs/README.mdをご覧ください。

参加する

貢献についてはCONTRIBUTING.mdをご覧ください。最初のプルリクエストでは、コントリビューターライセンス契約に一度署名していただきます。質問やアイデアはリポジトリのディスカッションに投稿してください。最初の変更は「good first issue」ラベルの付いたイシューから始め、次に何をするかはロードマップをご覧ください。

サポート

Agave Information Solutions, LLC の PremAgentic for Teams には、インストールとアップグレードの支援、ハードウェアのサイジング、組織のディレクトリとアクセス許可を PremAgentic に対応付ける支援、メンテナーからの回答が含まれます。[email protected] までご連絡ください。

質問はリポジトリのディスカッションに、バグはイシューにお寄せください。メンテナーが確認し、トリアージします。セキュリティに関する報告には必ず対応します。詳細はSECURITY.mdをご覧ください。

ライセンス

PremAgentic は、GNU Affero General Public License バージョン3のみ（AGPL-3.0-only）に基づくフリーソフトウェアです。LICENSEとNOTICEをご覧ください。依存関係とモデルのライセンスはTHIRD-PARTY-NOTICES.mdに記載されています。

Agave Information Solutions, LLC は、クローズド製品への組み込みや、変更したコピーをユーザーにソースコードを提供せずに実行するための商用ライセンスでも PremAgentic を提供しています。[email protected] までご連絡ください。

PremAgentic for Teamsは、組織が多くの人に PremAgentic を利用してもらうために追加するものです。ディレクトリグループのマッピング、監査記録の保持とエクスポートが含まれます。今後追加される機能は、グループ同期に対応した Microsoft、Google、その他の OIDC プロバイダー経由のサインイン、SharePoint、OneDrive、Windows ファイル共有向けの、ソース独自のアクセス許可を読み取るコネクター、管理 API、署名済みインストーラーです。サポートも含まれます。

このアドオンは、同じ拡張機能ホストに1つの拡張機能としてインストールされます。他の拡張機能と同様にハッシュで許可され、ユーザー数が10人以下のデプロイでは無料です。お客様はアドオンのソースコードを閲覧できます。

PremAgentic の名称は Agave Information Solutions, LLC に帰属し、コードとともにライセンスされるものではありません。

脆弱性の報告はSECURITY.mdをご覧ください。貢献についてはCONTRIBUTING.mdをご覧ください。

ウェブサイト: https://premagentic.com

掲載ページとソース: https://github.com/premagentic/premagentic

アリゾナ州スコッツデールのAgaveISが開発・保守しています。