Merge branch 'main' into chunking-examples

Author: kosabogi

.gitignore

@@ -2,6 +2,10 @@
 .artifacts
 .DS_store
 
+# Jetbrains files
+.idea
+*.iml
+
 # Add LLM/AI related files
 AGENTS.md
 .github/copilot-instructions.md

deploy-manage/toc.yml

@@ -609,7 +609,8 @@ toc:
                   - file: users-roles/cluster-or-deployment-auth/granting-privileges-for-data-streams-aliases.md
                   - file: users-roles/cluster-or-deployment-auth/kibana-role-management.md
                   - file: users-roles/cluster-or-deployment-auth/role-restriction.md
-              - file: users-roles/cluster-or-deployment-auth/elasticsearch-privileges.md                  
+              - title: "Elasticsearch privileges"
+                crosslink: elasticsearch://reference/elasticsearch/security-privileges.md              
               - file: users-roles/cluster-or-deployment-auth/kibana-privileges.md
               - file: users-roles/cluster-or-deployment-auth/mapping-users-groups-to-roles.md
                 children:

deploy-manage/users-roles/cluster-or-deployment-auth/elasticsearch-privileges.md

@@ -294,4 +294,6 @@ subs:
   ece-apis: https://www.elastic.co/docs/api/doc/cloud-enterprise/
   intake-apis: https://www.elastic.co/docs/api/doc/observability-serverless/
   models-app: "Trained Models"
-  kube-stack-version: 0.6.3
+  agent-builder: "Elastic Agent Builder"
+  kube-stack-version: 0.6.3
+

docset.yml

@@ -18,8 +18,8 @@ A _time series_ is a sequence of data points collected at regular time intervals
 * Access to [{{dev-tools-app}} Console](/explore-analyze/query-filter/tools/console.md) in {{kib}}, or another way to make {{es}} API requests
 
 * Cluster and index permissions: 
-    * [Cluster privilege](/deploy-manage/users-roles/cluster-or-deployment-auth/elasticsearch-privileges.md#privileges-list-cluster):  `manage_index_templates`
-    * [Index privileges](/deploy-manage/users-roles/cluster-or-deployment-auth/elasticsearch-privileges.md#privileges-list-indices): `create_doc` and `create_index`
+    * [Cluster privilege](elasticsearch://reference/elasticsearch/security-privileges.md#privileges-list-cluster):  `manage_index_templates`
+    * [Index privileges](elasticsearch://reference/elasticsearch/security-privileges.md#privileges-list-indices): `create_doc` and `create_index`
 
 * Familiarity with [time series data stream concepts](time-series-data-stream-tsds.md) and [{{es}} index and search basics](/solutions/search/get-started.md) 
 

manage-data/data-store/data-streams/quickstart-tsds.md

@@ -21,6 +21,13 @@ To check for security updates, go to [Security announcements for the Elastic sta
 % ### Fixes [elastic-observability-next-fixes]
 % *
 
+## 9.1.4 [elastic-observability-9.1.4-release-notes]
+
+### Enhancements [elastic-observability-9.1.4-enhancements]
+
+* Save button is disabled in user-specific system prompt flyout when there's no input [#231562]({{kib-pull}}2301562).
+
+
 ## 9.1.3 [elastic-observability-9.1.3-release-notes]
 
 ### Fixes [elastic-observability-9.1.3-fixes]

release-notes/elastic-observability/index.md

@@ -27,6 +27,16 @@ To check for security updates, go to [Security announcements for the Elastic sta
 
 % *
 
+## 9.1.4 [elastic-security-9.1.4-release-notes]
+
+### Features and enhancements [elastic-security-9.1.4-features-enhancements]
+* Adds more Linux diagnostic process `ptrace` events.
+
+### Fixes [elastic-security-9.1.4-fixes]
+* Fixes a bug where the toggle column functionality only functioned on the **Alerts** page [#234278]({{kib-pull}}234278).
+* Fixes a bug where Linux capabilities were included in {{elastic-endpoint}} network events despite being disabled.
+* Makes the delivery of {{elastic-endpoint}} command line commands more robust. In rare cases, commands could previously fail due to interprocess communication issues.
+
 ## 9.1.3 [elastic-security-9.1.3-release-notes]
 
 ### Fixes [elastic-security-9.1.3-fixes]

release-notes/elastic-security/index.md

@@ -12,7 +12,7 @@ navigation_title: Release notes
 
 Stay up to date with the latest changes, fixes, known issues, and deprecations in Elastic products. 
 
-Release notes cover the all the latest Elastic product changes, including the following:
+Release notes cover all the latest Elastic product changes, including the following:
 * {{stack}} {{version.stack.base}} and later, including the most recent {{version.stack}} release
 * {{serverless-full}}, including updates to {{es}}, and {{observability}} and {{elastic-sec}} solutions
 

release-notes/intro/index.md

@@ -0,0 +1,37 @@
+---
+navigation_title: "A2A server"
+applies_to:
+  stack: preview 9.2
+  serverless:
+    elasticsearch: preview
+---
+
+:::{warning}
+WIP
+
+These pages are hidden from the docs TOC and have `noindexed` meta headers.
+:::
+
+# Agent-to-Agent (A2A) server
+
+The [**Agent-to-Agent (A2A) server**](https://github.com/a2aproject/A2A) enables external A2A clients to communicate with {{agent-builder}} agents.
+
+## Agent cards endpoint
+
+Returns metadata for a specific agent. The `agentId` is a path parameter that corresponds to your agent IDs:
+
+```
+GET /api/agent_builder/a2a/{agentId}.json
+```
+
+## A2A protocol endpoint
+
+Interact with agents following the A2A protocol specification:
+
+```
+POST /api/agent_builder/a2a/{agentId}
+```
+
+:::{important}
+Both A2A endpoints require API key authentication. For more information about the A2A protocol, see the [A2A protocol specification](https://a2aprotocol.ai/docs/guide/a2a-protocol-specification-python#protocol-flow-diagram).
+:::

solutions/search/agent-builder/a2a-server.md

@@ -0,0 +1,113 @@
+---
+navigation_title: "Agents"
+applies_to:
+  stack: preview 9.2
+  serverless:
+    elasticsearch: preview
+---
+
+:::{warning}
+WIP
+
+These pages are hidden from the docs TOC and have `noindexed` meta headers.
+:::
+
+# {{agent-builder}}: Agents
+
+Agents engage in natural language conversations with users and interact with your {{es}} data through tools.
+Fundamentally, an agent is defined by its custom instructions and the set of tools it's assigned.
+
+Each agent manages the conversation flow, interprets user requests, and provides responses based on its configured tools, instructions, and behavior settings.
+
+## How agents work
+
+When you ask a question to an agent, it analyzes your request, selects the most appropriate tool, and determines the right arguments to use. After receiving results, the agent evaluates the information and decides whether to use additional tools or formulate a response. This iterative process of tool selection, execution, and analysis continues until the agent can provide a complete answer.
+
+{{agent-builder}} includes a default agent (named `Elastic AI Agent`) with access to all built-in tools. You can create specialized agents with custom instructions and selected tools to address specific use cases or workflows.
+
+## Manage your agents
+
+The **Agents** page provides a centralized view of all your agents. From this page you can:
+
+- View all your agents with their names and labels
+- Search for specific agents using the search bar
+- Filter agents by labels using the **Labels** dropdown
+- Create new agents using the **+ New agent** button
+- Start chatting with an agent or perform other actions
+    - **Elastic AI Agent**: you can **chat** or **clone** the default agent using the chat or clone buttons.
+      :::{image} images/chat-and-clone-buttons.png
+      :alt: Chat with agent and clone agent buttons
+      :width: 120px
+      :::
+    - **Custom agents**: You can **chat**, **edit**, **clone**, or **delete** an agent from the management overview.
+      :::{image} images/chat-edit-clone-delete.png
+      :alt: Agent context menu showing Chat, Edit, Clone, and Delete options
+      :width: 130px
+      :::
+
+## How to create a new agent
+
+Follow these steps to create a new agent:
+
+:::::{stepper}
+::::{step} Navigate to the Agents page
+
+Navigate to the **Agents** page to access the agent management interface.
+
+::::
+
+::::{step} Create a new agent
+
+Click the **New agent** button to start creating a new agent.
+
+:::{image} images/new-agent-button.png
+:alt: Click the New agent button to create a new agent
+:width: 150px
+:::
+
+
+::::
+
+::::{step} Configure essential settings
+
+Configure the essential agent settings in the **settings** tab:
+
+1. Enter an **Agent ID**, a unique identifier for reference in code.
+1. Add **Custom instructions**.<br><br>Custom instructions define the agent's personality and determine how it will interact with users and perform tasks.
+
+    :::{note}
+    Your custom instructions are added to the system prompt to define the agent's behavior. The system prompt enables core features like visualization and citations.
+    :::
+1. Set the **Display name** that users will see.
+1. Add a **Display description** to explain the agent's purpose
+
+::::
+
+::::{step} Assign tools
+
+Switch to the **Tools** tab to assign [tools](tools.md) to your agent.
+
+Select the combination of built-in and custom tools available to the agent, based on your use case.
+
+::::
+
+::::{step} Customize appearance (optional)
+
+Optionally customize the agent's appearance and organization:
+
+- Add **Labels** to organize your agents
+- Choose an **Avatar color** and **Avatar symbol** to help visually distinguish the agent
+
+::::
+
+::::{step} Save your changes
+
+Click **Save** to create your agent, or **Save and chat** to create the agent and immediately start a conversation with it.
+
+:::{image} images/save-and-chat-buttons.png
+:alt: Save and Save and chat buttons
+:width: 270px
+:::
+
+::::
+:::::