Apply feedback

Author: innateteniuk

docs/docs/prompts/index.md

@@ -14,7 +14,7 @@ data class with the following properties:
 - `params`: Optional [LLM configuration parameters](prompt-creation/index.md#prompt-parameters) (such as temperature, tool choice, and others).
 
 Although you can instantiate the `Prompt` class directly,
-the recommended way to create prompts is by using the Kotlin DSL, 
+the recommended way to create prompts is by using the [Kotlin DSL](prompt-creation/index.md), 
 which provides a structured way to define the conversation.
 
 <!--- INCLUDE
@@ -95,8 +95,8 @@ Koog allows you to optimize performance and handle failures when running prompts
 ## Prompts in AI agents
 
 In Koog, AI agents maintain and manage prompts during their lifecycle.
-While LLM clients or executors are used for direct prompt execution, agents handle the flow of prompt updates to ensure
-the conversation history is relevant and consistent.
+While LLM clients or executors are used to run prompts, agents handle the flow of prompt updates, ensuring the 
+conversation history remains relevant and consistent.
 
 The prompt lifecycle in an agent usually includes several stages:
 
@@ -107,9 +107,10 @@ The prompt lifecycle in an agent usually includes several stages:
 
 ### Initial prompt setup
 
-When you [initialize an agent](../getting-started/#create-and-run-an-agent), you define a [system message](prompt-creation/index.md#system-message) that sets the agent's behavior.
-An initial [user message](prompt-creation/index.md#user-messages) is usually provided as input when you call the agent's `run()` method.
-For example: 
+When you [initialize an agent](../getting-started/#create-and-run-an-agent), you define 
+a [system message](prompt-creation/index.md#system-message) that sets the agent's behavior.
+Then, when you call the agent's `run()` method, you typically provide an initial [user message](prompt-creation/index.md#user-messages)
+as input. Together, these messages form the agent's initial prompt. For example: 
 
 <!--- INCLUDE
 import ai.koog.agents.core.agent.AIAgent
@@ -137,7 +138,7 @@ val result = agent.run("What is Koog?")
 ```
 <!--- KNIT example-prompts-02.kt -->
 
-The agent automatically converts the text prompt to the Prompt object and sends it to the prompt executor:
+In the example, the agent automatically converts the text prompt to the Prompt object and sends it to the prompt executor:
 
 ```mermaid
 flowchart TB
@@ -158,14 +159,18 @@ flowchart TB
     B -->|"result to"| A
 ```
 
+For more [advanced configurations](../complex-workflow-agents.md#4-configure-the-agent), you can also use 
+[AIAgentConfig](https://api.koog.ai/agents/agents-core/ai.koog.agents.core.agent.config/-a-i-agent-config/index.html)
+to define the agent's initial prompt.
+
 ### Automatic prompt updates
 
 As the agent runs its strategy, [predefined nodes](../nodes-and-components.md) automatically update the prompt.
 For example:
 
-- [`nodeLLMRequest`](../nodes-and-components/#nodellmrequest): Appends the user message and captures the LLM response.
-- [`nodeExecuteTool`](../nodes-and-components/#nodeexecutetool): Adds tool execution results to the conversation history.
-- [`nodeAppendPrompt`](../nodes-and-components/#nodeappendprompt): Inserts specific messages or instructions into the prompt at any point in the workflow.
+- [`nodeLLMRequest`](../nodes-and-components/#nodellmrequest): Appends a user message to the prompt and captures the LLM response.
+- [`nodeLLMSendToolResult`](../nodes-and-components/#nodellmsendtoolresult): Appends tool execution results to the conversation.
+- [`nodeAppendPrompt`](../nodes-and-components/#nodeappendprompt): Inserts specific messages into the prompt at any point in the workflow.
 
 ### Context window management
 

docs/docs/prompts/prompt-creation/multimodal-content.md

@@ -102,7 +102,7 @@ All `ContentPart.Attachment` types accept the following parameters:
 
 #### Attachment content
 
-The AttachmentContent interface defines the type and source of content that is provided as input to the LLM:
+Implementations of the AttachmentContent interface define the type and source of content that is provided as input to the LLM:
 
 - [`AttachmentContent.URL`](https://api.koog.ai/prompt/prompt-model/ai.koog.prompt.message/-attachment-content/-u-r-l/index.html) defines the URL of the provided content:
     ```kotlin