however-yir/knowledgeops-agent

Spring AI ベースのエンタープライズ RAG プラットフォーム。マルチエージェント、ハイブリッド検索、知識グラフ、テナント分離、監査可能な実装基線です。

完成アプリ自由に使える · MITバックエンド・DBJava難易度
215+0今週0
16フォーク4Issue
デモ・公式サイトをひらくhowever-yir.github.io

中辛 の解説

Spring AI 1.0.0-M6 上に構築された、Java 17・Spring Boot 3.4.5 ベースのプラットフォーム。VectorRetriever(pgvector)・KeywordRetriever・GraphRetriever・WebRetriever を統合した HybridRetrievalService、AgentWorkflowEngine による状態機械型エージェント、EvidenceJudgeService による引用証拠スコアリング、長短期メモリ層を実装しています。MySQL・Redis・RabbitMQ・pgvector をスタックし、OpenTelemetry による Prometheus・Loki・Tempo 統合監視をサポート。デモは ./scripts/demo.sh で 5 分で起動、 は Swagger UI で検査可、Evaluation Studio で RAG 品質を回帰評測できます。難易度は 3(中程度)。多くの本格機能があるため初期設定と運用学習に時間を要します。

이런 레포예요

이럴 때 쓰면 좋아요

  • 企業向け知識ベース検索システムの構築。PDF・ドキュメント取り込みと引用可能な Q&A 機能を備える。
  • 複数部門が利用するインテリジェントカスタマーサービスプラットフォーム。テナント分離と監査ログにより規制要件に対応。
  • DeepResearch による業界リサーチやレポート自動生成。トピック拆解→混合検索→証拠評点→報告書生成の完全パイプライン。

핵심 기능

マルチエージェント AgentWorkflowEngine:CREATED→PLANNING→SEARCHING→RETRIEVING→JUDGING→REFLECTING→WRITING→DONE の状態機械、Task/Step/Event 永続化。ハイブリッド検索統合:Vector(pgvector)・Keyword・Graph・Web の 4 経路を HybridRetrievalService で融合スコアリング、EvidenceJudgeService による引用証拠評点。エンタープライズセキュリティ・運用基線:API Key・JWT・RBAC・テナント分離・監査ログ、Prometheus・Loki・Tempo 統合、Flyway・JaCoCo・E2E smoke test 検証。

대안 대비 차별점

単なる Chat API ではなく、非同期入庫・マルチテナント・テナント隔離・引用可追跡・本格 Agent 状態機械・完全監査・可視性・JaCoCo 品質門禁など、検証済みエンジニアリング基線を実装している点が異なります。LlamaIndex や既存 Spring AI サンプルは権限・監査・運用面を省略していますが、本プロジェクトはそれらを統合した実装基線です。

食べた人たち

実際に使ってみた人の記録です — 一言も完走の記録も、確認のうえで公開しています。

試食評 · 使った人のひとこと

まだ試食評がありません。使ってみたら、最初のひとことをどうぞ。

ほかのリポジトリの試食評を見る →

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

このリポジトリの作り方

はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。

준비물

  • JDK 17 以上
  • Maven 3.9 以上
  • Docker および Docker Compose
  • OpenAI 互換 API キー

すぐ動かしてみるDocker Compose

ギット飯がリポジトリの構成を確認して組み立てた実行コマンドです。ターミナルに貼り付ければ、取得から実行までまとめて進みます。

git clone --depth 1 https://github.com/however-yir/knowledgeops-agent.git &&
cd knowledgeops-agent &&
docker compose up

Docker가 필요해요 — 맥이라면 OrbStack(brew install --cask orbstack)을 추천해요.

コードは自分の環境で動きます — はじめて見るリポジトリなら、中身にひととおり目を通してから実行するのがおすすめです。

README가 안내하는 자세한 단계 보기
  1. リポジトリをクローンし、ディレクトリに移動します。
git clone https://github.com/however-yir/knowledgeops-agent.git
cd knowledgeops-agent
  1. ワンステップデモスクリプトを実行します(Docker・Docker Compose 必須)。
./scripts/demo.sh
  1. スクリプトが .env を生成し、OPENAI_API_KEY の入力を促します。有効な OpenAI 互換キーを入力してください。

  2. Docker コンテナが起動します。ヘルスチェックを待ちます(通常 30~60 秒)。

  3. 起動後、以下にアクセスします。

フロントエンド: http://localhost:8088
バックエンド API: http://localhost:8080
Swagger UI: http://localhost:8080/swagger-ui/index.html
  1. フロントエンド「認証」カードで開発用 API キーを確認するか、.env.example を参照します。

別途 make を使う場合:

make demo
make demo-verify
make demo-down

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try however-yir/knowledgeops-agent

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

スター推移 · 7日

215+0 / 7일

使いやすさ · まねしやすいか

サンプル評点 34/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2026 年に作成

「백엔드·DB」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/however-yir/knowledgeops-agent.svg)](https://www.gitbap.com/r/however-yir/knowledgeops-agent)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る