Skip to content

バージョニング ​

Koogは、X.Y.Z 形式(例: 1.3.0)のセマンティック バージョニングに従います。

このフレームワークはAPI安定性を備えています。パブリックAPIが一度リリースされると、メジャーバージョンの更新なしに破壊的変更が行われることはありません。

バージョン構成 ​

コンポーネント名前形式意味
XメジャーX.y.z既存のAPIに対する破壊的変更
Yマイナーx.Y.z新しいAPIの追加と非推奨化。既存のすべてのAPIは引き続き動作します
Zバグ修正x.y.Zバグ修正のみ。APIの変更はありません

メジャー (X) ​

  • 既存のAPIに破壊的変更が導入される場合があります。
  • 古いAPIが削除される可能性があります。
  • 移行ガイドが提供されます。
  • リリースは最大で年1回です。

マイナー (Y) ​

  • 新しいAPIが追加される場合があります。
  • 既存のAPIが非推奨になる(代替手段が提供される)場合がありますが、非推奨のAPIも引き続き機能します。
  • 破壊的変更はありません。前のマイナーバージョンに対してコンパイルされたすべてのコードは、引き続きコンパイルおよび動作します。
  • リリースは最大で月1回です。

バグ修正 (Z) ​

  • バグ修正のみを含みます。
  • APIの追加、削除、非推奨化はありません。
  • リリースは最大で週1回です。

非推奨ポリシー ​

マイナーリリース(Y)で非推奨になったAPIは、少なくとも次のメジャーリリース(X)まで利用可能なまま維持されます。 非推奨の警告には、推奨される代替手段が示されます。

安定版およびベータ版モジュール ​

一部のモジュールは実験的であると見なされ、標準の X.Y.Z ではなく、-beta バージョンサフィックス(例: 1.3.0-beta)を付けて公開されます。モジュールがベータ版である理由には、以下のいずれかが含まれます。

  • 外部統合 — 基盤となるLLMプロバイダーのAPIや外部フレームワーク(例: Spring AI)自体が不安定であったり、頻繁な変更や変更が予想される対象であったりする場合。
  • 実験的な機能 — 機能領域がまだ調査中であり、APIの形状が進化する可能性がある場合(例: GOAPプランニング戦略)。
  • 実験的なプロトコル — モジュールが、それ自体がまだ安定していないプロトコルを実装している場合(例: A2A、Kotlin MCP)。

ベータ版モジュールの安定性を維持するためにあらゆる努力を払っていますが、マイナーリリースをまたいで一部のAPI変更が発生する可能性があります。ベータ版の変更が安定版モジュールに影響を与えることはありません。

バージョン X.Y.Z の安定版モジュールは、常にバージョン X.Y.Z-beta のベータ版モジュールと互換性があります(その逆も同様です)。すべてのモジュールを同期してアップデートできます。

アンブレラモジュール ​

モジュールバージョン内容
koog-agents1.3.0すべての安定版モジュール(推移的) — 推奨される開始ポイント
koog-agents-additions1.3.0-betaほとんどのベータ/実験的モジュール(スタンドアロンの外部統合を除く)

モジュールバージョン ​

モジュールバージョン
agents1.3.0
agents-core1.3.0
agents-features1.3.0
agents-features-chat-history-jdbc1.3.0
agents-features-chat-memory-sql1.3.0
agents-features-event-handler1.3.0
agents-features-memory1.3.0
agents-features-opentelemetry1.3.0
agents-features-persistence-jdbc1.3.0
agents-features-snapshot1.3.0
agents-features-sql1.3.0
agents-features-tokenizer1.3.0
agents-features-trace1.3.0
agents-mcp-metadata1.3.0
agents-test1.3.0
agents-tools1.3.0
agents-utils1.3.0
embeddings1.3.0
embeddings-base1.3.0
embeddings-llm1.3.0
http-client1.3.0
http-client-core1.3.0
http-client-java1.3.0
http-client-ktor1.3.0
http-client-okhttp1.3.0
http-client-test1.3.0
koog-agents1.3.0
koog-spring-ai1.3.0
prompt1.3.0
prompt-cache1.3.0
prompt-cache-files1.3.0
prompt-cache-model1.3.0
prompt-executor1.3.0
prompt-executor-anthropic-client1.3.0
prompt-executor-bedrock-client1.3.0
prompt-executor-cached1.3.0
prompt-executor-clients1.3.0
prompt-executor-model1.3.0
prompt-executor-ollama-client1.3.0
prompt-executor-openai-client1.3.0
prompt-executor-openai-client-base1.3.0
prompt-executor-openrouter-client1.3.0
prompt-llm1.3.0
prompt-markdown1.3.0
prompt-model1.3.0
prompt-processor1.3.0
prompt-structure1.3.0
prompt-tokenizer1.3.0
prompt-xml1.3.0
rag-base1.3.0
serialization1.3.0
serialization-core1.3.0
serialization-jackson1.3.0
serialization-test1.3.0
test-tck1.3.0
test-utils1.3.0
utils1.3.0
モジュールバージョン
a2a-client1.3.0-beta
a2a-core1.3.0-beta
a2a-server1.3.0-beta
a2a-test1.3.0-beta
a2a-test-server-tck1.3.0-beta
a2a-transport-client-jsonrpc-http1.3.0-beta
a2a-transport-core-jsonrpc1.3.0-beta
a2a-transport-server-jsonrpc-http1.3.0-beta
agents-ext1.3.0-beta
agents-features-a2a-client1.3.0-beta
agents-features-a2a-core1.3.0-beta
agents-features-a2a-server1.3.0-beta
agents-features-acp1.3.0-beta
agents-features-chat-history-aws1.3.0-beta
agents-features-longterm-memory1.3.0-beta
agents-features-longterm-memory-aws1.3.0-beta
agents-mcp1.3.0-beta
agents-mcp-server1.3.0-beta
agents-planner1.3.0-beta
koog-agents-additions1.3.0-beta
koog-ktor1.3.0-beta
koog-spring-ai-common1.3.0-beta
koog-spring-ai-starter-chat-memory1.3.0-beta
koog-spring-ai-starter-model-chat1.3.0-beta
koog-spring-ai-starter-model-embedding1.3.0-beta
koog-spring-ai-starter-vector-store1.3.0-beta
koog-spring-boot-starter1.3.0-beta
prompt-cache-redis1.3.0-beta
prompt-executor-dashscope-client1.3.0-beta
prompt-executor-deepseek-client1.3.0-beta
prompt-executor-google-client1.3.0-beta
prompt-executor-litert-client1.3.0-beta
prompt-executor-llms-all1.3.0-beta
prompt-executor-mistralai-client1.3.0-beta
rag-vector1.3.0-beta