docs(subgroups): improve subgroup descriptions (#226)

* docs(subgroups): improve subgroup descriptions

* docs(metadata-descriptions): update subgroup descriptions

Part of kestra-io/docs#3426

Author: aj-emerich

src/main/java/io/kestra/plugin/ai/agent/package-info.java

@@ -1,7 +1,7 @@
 @PluginSubGroup(
-    description = "This sub-group of plugins contains AI tasks.",
+    description = "Tasks that run AI agents combining system prompts, user input, tools, content retrievers, and optional memory to produce grounded responses.",
     categories = { PluginSubGroup.PluginCategory.AI, PluginSubGroup.PluginCategory.DATABASE }
 )
 package io.kestra.plugin.ai.agent;
 
-import io.kestra.core.models.annotations.PluginSubGroup;
+import io.kestra.core.models.annotations.PluginSubGroup;

src/main/java/io/kestra/plugin/ai/completion/package-info.java

@@ -1,7 +1,7 @@
 @PluginSubGroup(
-    description = "This sub-group of plugins contains AI completion tasks.",
+    description = "Tasks that call LLMs for chat, classification, image generation, and JSON-structured extraction, with optional tools, memory, and provider flexibility.",
     categories = { PluginSubGroup.PluginCategory.AI }
 )
 package io.kestra.plugin.ai.completion;
 
-import io.kestra.core.models.annotations.PluginSubGroup;
+import io.kestra.core.models.annotations.PluginSubGroup;

src/main/java/io/kestra/plugin/ai/embeddings/package-info.java

@@ -1,7 +1,7 @@
 @PluginSubGroup(
-    description = "This sub-group of plugins contains Embeddings Store providers for the other Langchain4j plugins.",
+    description = "Tasks that provision embeddings stores (Chroma, PGVector, Pinecone, Redis, Qdrant, etc.) for chunk storage and similarity search powering RAG flows.",
     categories = { PluginSubGroup.PluginCategory.AI, PluginSubGroup.PluginCategory.DATABASE }
 )
 package io.kestra.plugin.ai.embeddings;
 
-import io.kestra.core.models.annotations.PluginSubGroup;
+import io.kestra.core.models.annotations.PluginSubGroup;

src/main/java/io/kestra/plugin/ai/memory/package-info.java

@@ -1,7 +1,7 @@
 @PluginSubGroup(
-    description = "This sub-group of plugins contains Memory providers for the other Langchain4j plugins.",
+    description = "Tasks that supply conversational memory backends (Kestra KV Store, Redis, PostgreSQL) to persist recent messages for agents and chat completions.",
     categories = { PluginSubGroup.PluginCategory.AI }
 )
 package io.kestra.plugin.ai.memory;
 
-import io.kestra.core.models.annotations.PluginSubGroup;
+import io.kestra.core.models.annotations.PluginSubGroup;

src/main/java/io/kestra/plugin/ai/package-info.java

@@ -1,8 +1,7 @@
 @PluginSubGroup(
-    description = "This sub-group of plugins contains tasks for Generative AI for Kestra.\n" +
-        "It uses the Langchain4j framework.",
+    description = "Tasks that orchestrate generative AI in Kestra with LangChain4j, covering chat completions, agents, RAG, tools, and shared providers.",
     categories = PluginSubGroup.PluginCategory.AI
 )
 package io.kestra.plugin.ai;
 
-import io.kestra.core.models.annotations.PluginSubGroup;
+import io.kestra.core.models.annotations.PluginSubGroup;

src/main/java/io/kestra/plugin/ai/provider/package-info.java

@@ -1,7 +1,7 @@
 @PluginSubGroup(
-    description = "This sub-group of plugins contains Large Language Model (LLM) providers for the other Langchain4j plugins.",
+    description = "Tasks that configure Large Language Model providers (OpenAI, Gemini, Anthropic, Mistral, Bedrock, etc.) to supply chat/completion models used across the AI plugins.",
     categories = PluginSubGroup.PluginCategory.AI
 )
 package io.kestra.plugin.ai.provider;
 
-import io.kestra.core.models.annotations.PluginSubGroup;
+import io.kestra.core.models.annotations.PluginSubGroup;

src/main/java/io/kestra/plugin/ai/rag/package-info.java

@@ -1,9 +1,8 @@
 @PluginSubGroup(
     title = "RAG",
-    description = "This sub-group of plugins contains tasks for Retrieval Augmented Generation AI for Kestra.\n" +
-        "It uses the Langchain4j framework.",
+    description = "Tasks that ingest, chunk, and embed documents, search vectors, and run retrieval-augmented chat so LLM answers stay grounded in indexed content.",
     categories = PluginSubGroup.PluginCategory.AI
 )
 package io.kestra.plugin.ai.rag;
 
-import io.kestra.core.models.annotations.PluginSubGroup;
+import io.kestra.core.models.annotations.PluginSubGroup;

src/main/java/io/kestra/plugin/ai/retriever/package-info.java

@@ -1,8 +1,7 @@
 @PluginSubGroup(
-    description = "This sub-group of plugins contains content retriever for Retrieval Augmented Generation AI for Kestra.\n" +
-        "It uses the Langchain4j framework.",
+    description = "Tasks that pull external context for Retrieval Augmented Generation: web search via Google or Tavily, or SQL database retrieval feeding results into AI prompts.",
     categories = PluginSubGroup.PluginCategory.AI
 )
 package io.kestra.plugin.ai.retriever;
 
-import io.kestra.core.models.annotations.PluginSubGroup;
+import io.kestra.core.models.annotations.PluginSubGroup;

src/main/java/io/kestra/plugin/ai/tool/package-info.java

@@ -1,8 +1,7 @@
 @PluginSubGroup(
-    description = "This sub-group of plugins contains tools for Generative AI for Kestra.\n" +
-        "It uses the Langchain4j framework.",
+    description = "Tasks that expose tools agents can call: Kestra flow/task runners, code execution, MCP clients, and web search to extend LLM reasoning with actions and real-time data.",
     categories = PluginSubGroup.PluginCategory.AI
 )
 package io.kestra.plugin.ai.tool;
 
-import io.kestra.core.models.annotations.PluginSubGroup;
+import io.kestra.core.models.annotations.PluginSubGroup;

src/main/resources/metadata/agent.yaml

@@ -1,7 +1,7 @@
 group: io.kestra.plugin.ai.agent
 name: "agent"
 title: "Agent"
-description: "This sub-group of plugins contains AI tasks."
+description: "Tasks that run AI agents combining system prompts, user input, tools, content retrievers, and optional memory to produce grounded responses."
 body: ""
 videos: []
 createdBy: "Kestra Core Team"