ユースケース知識バンドル
Bundle OKF 0.1 · 14 conceitos · aiagate/agentic-chat-foundation
Open source Repository Open in the app JSON README (API)
About
# ユースケース知識バンドル
このディレクトリは、agentic-chat-foundation の会話、関係育成、会話履歴整理に関する業務能力を表す OKF v0.1 バンドルである。
LLM や人間は、まずこのファイルを読み、必要な概念だけを開くこと。
## 読み方
### 目的と境界
- [プロジェクトの目的とアクター](/actors.md)
- [スコープ](/scope.md)
- [ハイレベルユースケース](/high-level-use-cases.md)
### 業務ユースケース
- [業務ユースケース一覧](/use-cases/)
- [メッセージを受け付ける](/use-cases/accept-incoming-message.md)
- [会話への応答を作成する](/use-cases/create-conversation-response.md)
- [応答結果を利用者へ届ける](/use-cases/deliver-conversation-result.md)
- [会話履歴を整理する](/use-cases/consolidate-conversation-history.md)
### 不変条件と結果
- [共通業務規則](/business-rules.md)
- [完了状態](/completion-states.md)
- [将来判断する事項](/future-decisions.md)
### 別Bounded Context
- [Discord公開議論](../discussion/index.md)
## 正本の扱い
このバンドルの業務上の記述がユースケースの正本である。実装クラス、データベース、
外部サービス、プロセス構成の説明は、必要に応じて別の技術リファレンスを参照する。
用語は[ユビキタス言語バンドル](../ubiquitous-language/index.md)で定義する。
## OKF 仕様
- [Open Knowledge Format v0.1 specification](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md)
- [Google Cloud:
Details
- Kind
- OKF bundles
- Topic
- AI, RAG & memory
- Publisher
- aiagate
- Origin
- okf_github
- Category
- dados
- Version
- 0.1
- Last push
- 2026-08-23T09:38:57Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-09-09 05:08:26
- Updated
- 2026-09-09 05:08:26
- Origin id
aiagate/agentic-chat-foundation:docs/product/application-use-cases/index.md
README
# agentic-chat-foundation `agentic-chat-foundation` は、外部の会話チャネルからの入力を受け付け、対話相手との継続的な会話と 長期記憶を扱う agentic chat application foundation です。 単純な chatbot の雛形ではなく、会話の受付、応答作成、結果の通知、長期記憶の整理を それぞれの業務境界で扱うための土台として作られています。 このプロジェクトは現在開発中です。実装、ドキュメント、移行計画は継続的に更新されています。 ## 何を作るためのものか このリポジトリは、次のようなアプリケーションを作るためのテンプレートです。 - 外部の会話チャネルを通じた1対1のテキスト会話 - 現在の会話、過去の交流から整理された長期記憶、必要な外部情報を用いた応答作成 - 利用者のメッセージの受付、記録、応答、結果の通知 - 会話から人物像、出来事、対象・関係を長期記憶として整理すること - 複数チャネル上の利用者識別子を一人の利用者へ結び付けること ## 主な能力 - 外部の会話チャネルを通じた1対1のテキスト会話 - 現在の会話、過去の交流から整理された長期記憶、必要な外部情報を用いた応答作成 - 利用者のメッセージの受付、記録、応答、結果の通知 - 会話から人物像、出来事、対象・関係を長期記憶として整理すること - 複数チャネル上の利用者識別子を一人の利用者へ結び付け、利用者の境界を守ること - 独立起動した複数のDiscord Botが、共有DBを使わず同じチャンネルで議論すること 会話の受付、応答作成、結果の通知は一つの要求に対する論理的な流れとして扱います。 長期記憶の整理は、利用者の応答とは異なる定期的な契機から行います。 ## 設計の中心 このプロジェクトは、外部入口、業務ユースケース、ドメイン概念、技術アダプタを分離する アーキテクチャを基調にしています。依存方向と境界の詳細は [アーキテクチャ概要](docs/architecture/architecture-overview.md)で定義します。 ## 応答作成 受付済みメッセージについて、会話履歴、長期記憶、対話相手の設定、必要な外部情報を用いて 応答を作成します。応答を作成または届けられない場合は、応答不能の結果として扱います。 ## Memory Memory は会話履歴と長期記憶を分けて扱います。会話履歴は意味を変えない記録、長期記憶は 将来の対話に有用な意味を整理した結果です。長期記憶には人物像、出来事、対象・関係を含め、 それぞれに根拠と不確実性を持たせます。 外部情報は現在の応答の根拠として扱い、取得しただけで長期記憶へ加えません。 複数チャネル上の識別子を同じ利用者へ結び付けた場合も、会話履歴と長期記憶は同じ利用者の境界で扱います。 ## ドキュメント 業務上の説明は `docs/product/` と `docs/architecture/`、技術リファレンスは `docs/infrastructure/` 配下に分かれています。 ### 業務・設計 - [ユースケース知識バンドル](docs/product/application-use-cases/index.md) - [ユビキタス言語バンドル](docs/product/ubiquitous-language/index.md) - [Discord公開議論バンドル](docs/product/discussion/index.md) - [アーキテクチャ概要](docs/architecture/architecture-overview.md) ### 技術リファレンス - [Domain 実装ガイド](docs/domain/domain-implementation-guide.md) - [ドメイン図](docs/domain/domain-diagram.md) - [Memory Markdown Schema バンドル](docs/infrastructure/memory-markdown-schema/index.md) - [User Identity Mapping](docs/infrastructure/user-identity-mapping.md) - [Autonomous Discord Discussion](docs/infrastructure/discord-autonomous-discussion.md) - [Memory Write Flow](docs/infrastructure/memory-write-flow.md) - [Relationship System](docs/infrastructure/relationship-system.md) - [Database Migrations](docs/infrastructure/database-migrations.md) ## 開発時の前提 起動と運用は Docker Compose を前提にしています。 コード変更後はコンテナを再ビルドして再起動します。 ```bash docker compose up --build -d ``` 依存管理と検証コマンドは `uv` を使います。 詳細な開発ルールは [AGENTS.md](AGENTS.md) と `docs/` の各設計文書を参照してください。 ## License This project is licensed under the [MIT License](LICENSE).