update: update Koog and MCP descriptions #5177
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
koshachy
force-pushed
the
update-ai-development-overview
branch
from
3e47f14 to
2d3a65e
Compare
devcrocod
reviewed
Nov 20, 2025
Collaborator
devcrocod
left a comment
devcrocod
left a comment
There was a problem hiding this comment.
lgtm 👍
left a couple of comments
devcrocod
approved these changes
Nov 27, 2025
sarahhaggarty
requested changes
Dec 1, 2025
Collaborator
sarahhaggarty
left a comment
sarahhaggarty
left a comment
There was a problem hiding this comment.
Neat! I have mostly minor suggestions. It's request changes because of one typo in a header.
| Each project is self-contained. You can use each project as a reference or template for building Kotlin-based AI applications. | ||
| ## Koog | ||
|
|
||
| [Koog](https://koog.ai) is a JetBrains open‑source framework for building AI agents, from simple to complex. |
Collaborator
There was a problem hiding this comment.
Suggested change
| [Koog](https://koog.ai) is a JetBrains open‑source framework for building AI agents, from simple to complex. | |
| [Koog](https://koog.ai) is an open‑source framework from JetBrains for building AI agents, from simple to complex. |
Nitpick.
|
|
||
| ### Key features of Koog | ||
|
|
||
| * **Support for multiplatform development**. Multiplatform support enables agentic application development for JVM, JS, |
Collaborator
There was a problem hiding this comment.
Suggested change
| * **Support for multiplatform development**. Multiplatform support enables agentic application development for JVM, JS, | |
| * **Support for multiplatform development**. Multiplatform support enables agentic application development for the JVM, JavaScript, |
Shouldn't we expand JS and wasmJS terms?
| ### Key features of Koog | ||
|
|
||
| * **Support for multiplatform development**. Multiplatform support enables agentic application development for JVM, JS, | ||
| WasmJS, Android, and iOS. |
Collaborator
There was a problem hiding this comment.
Suggested change
| WasmJS, Android, and iOS. | |
| WebAssembly, Android, and iOS. |
| * **Support for multiplatform development**. Multiplatform support enables agentic application development for JVM, JS, | ||
| WasmJS, Android, and iOS. | ||
| * **Reliability and fault-tolerance**. With built-in retries, Koog lets developers handle failures such as timeouts or tool errors. | ||
| And the agent persistence allows restoring full agent state machines instead of just chat messages. |
Collaborator
There was a problem hiding this comment.
Suggested change
| And the agent persistence allows restoring full agent state machines instead of just chat messages. | |
| Agent persistence makes it possible to restore full agent state machines instead of just chat messages. |
To avoid the sentence beginning with "And". What do you think?
| * **Reliability and fault-tolerance**. With built-in retries, Koog lets developers handle failures such as timeouts or tool errors. | ||
| And the agent persistence allows restoring full agent state machines instead of just chat messages. | ||
| * **Built-in history compression techniques for long contexts**. Koog comes with advanced strategies to compress and | ||
| manage long-running conversations out of the box. |
Collaborator
There was a problem hiding this comment.
Suggested change
| manage long-running conversations out of the box. | |
| manage long-running conversations without extra setup. |
Since "out of the box" is used a couple of times already. WDYT?
|
|
||
| Use Kotlin to connect to major model providers such as OpenAI, Anthropic, Google, and others: | ||
|
|
||
| * [OpenAI](https://github.com/openai/openai-java) — official Java SDK for the OpenAI API. It covers responses and chat, images, and audio. |
Collaborator
There was a problem hiding this comment.
Suggestion: what do you think about turning this list into a table to make it easier to read?
|
|
||
| ### Create retrieval-augmented generation (RAG) piplelines and agent-based apps | ||
|
|
||
| * [Spring AI](https://github.com/spring-projects/spring-ai) — multi-provider abstraction for prompts, chat, embeddings, tools and function calling, and vector stores. |
Collaborator
There was a problem hiding this comment.
Also not sure if it should be "chats" here?
| * [Azure OpenAI](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/openai/azure-ai-openai) — official Java client for Azure OpenAI Service. It supports chat completions and embeddings. | ||
| * [AWS Bedrock](https://github.com/aws/aws-sdk-kotlin) — official SDKs to invoke foundation models. It includes the Kotlin SDK and Java SDK for Bedrock and Bedrock Runtime. | ||
|
|
||
| ### Create retrieval-augmented generation (RAG) piplelines and agent-based apps |
Collaborator
There was a problem hiding this comment.
Suggested change
| ### Create retrieval-augmented generation (RAG) piplelines and agent-based apps | |
| ### Create retrieval-augmented generation (RAG) pipelines and agent-based apps |
What do you think about moving the RAG acronym out of the header to make it shorter and explaining it in the LangChain4j bullet point?
|
|
||
| <a href="https://docs.koog.ai/getting-started/"><img src="get-started-with-koog.svg" width="700" alt="Get started with Koog" style="block"/></a> | ||
|
|
||
| ### Key features of Koog |
Collaborator
There was a problem hiding this comment.
Suggested change
| ### Key features of Koog | |
| ### Key features |
Since it's already in the Koog section. WDYT?
| @@ -1,4 +1,4 @@ | |||
| [//]: # (title: Build a Kotlin app that uses Spring AI to answer questions based on documents stored in Qdrant — tutorial) | |||
| [//]: # (title: Create a Kotlin app that answers questions with Spring AI — tutorial) | |||
Collaborator
There was a problem hiding this comment.
Don't forget to update the name in the What's next section of kotlin-ai-apps-development-overview.md :)
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.