Update agent builder docs

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

@@ -7,9 +7,9 @@ applies_to:
 ---
 
 :::{warning}
-WIP
+These pages are currently hidden from the docs TOC and have `noindexed` meta headers.
 
-These pages are hidden from the docs TOC and have `noindexed` meta headers.
+**Go to the docs [landing page](/solutions/search/elastic-agent-builder.md).**
 :::
 
 # Agent-to-Agent (A2A) server
@@ -33,5 +33,5 @@ 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).
+Both A2A endpoints require API key authentication. For more information about the A2A protocol, refer to the [A2A protocol specification](https://a2aprotocol.ai/docs/guide/a2a-protocol-specification-python#protocol-flow-diagram).
 :::

solutions/search/agent-builder/agent-builder-agents.md

@@ -7,21 +7,20 @@ applies_to:
 ---
 
 :::{warning}
-WIP
+These pages are currently hidden from the docs TOC and have `noindexed` meta headers.
 
-These pages are hidden from the docs TOC and have `noindexed` meta headers.
+**Go to the docs [landing page](/solutions/search/elastic-agent-builder.md).**
 :::
 
 # {{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.
+Agents are AI models (LLMs) defined with custom instructions and a set of assigned [tools](tools.md). Users [chat](chat.md) with agents using natural language, in the Agent Builder UI or programmatically.
 
-Each agent manages the conversation flow, interprets user requests, and provides responses based on its configured tools, instructions, and behavior settings.
+An agent parses user requests to define a goal and then runs tools in a loop to achieve that goal. The agent 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.
+When you ask a question to an agent, it analyzes your request to define a specific goal. It selects the most appropriate tool(s), and determines the right arguments to use. The agent evaluates the information returned after each action 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.
 
@@ -45,7 +44,7 @@ The **Agents** page provides a centralized view of all your agents. From this pa
       :width: 130px
       :::
 
-## How to create a new agent
+## Create a new agent in the GUI
 
 Follow these steps to create a new agent:
 
@@ -110,4 +109,16 @@ Click **Save** to create your agent, or **Save and chat** to create the agent an
 :::
 
 ::::
-:::::
+:::::
+
+## Agents API
+
+The Agents API enables programmatic access to agent creation and management actions.
+
+### Quick overview
+
+For a quick overview of refer to [Agents API](kibana-api.md#agents).
+
+### Serverless API reference
+
+For the complete API reference, refer to the [Kibana serverless API reference](https://www.elastic.co/docs/api/doc/serverless/).

solutions/search/agent-builder/chat.md

@@ -7,13 +7,77 @@ applies_to:
 ---
 
 :::{warning}
-WIP
+These pages are currently hidden from the docs TOC and have `noindexed` meta headers.
 
-These pages are hidden from the docs TOC and have `noindexed` meta headers.
+**Go to the docs [landing page](/solutions/search/elastic-agent-builder.md).**
 :::
 
-# {{agent-builder}}: Agent Chat UI
+# {{agent-builder}}: Agent Chat
+
+**Agent Chat** is the synchronous chat interface for natural language conversations with your agents.
+
+The chat GUI and programmatic interfaces enable real-time communication where you can ask questions, request data analysis, and receive immediate responses from your configured agents.
+
+## Get started
+
+:::{tip}
+Refer to the [getting started](get-started.md) guide to enable the feature and ingest some data.
+:::
+
+Once the feature is enabled, find **Agents** in the navigation menu to start chatting.
+You can also search for **Agent Builder** in the [global search bar](/explore-analyze/find-and-organize/find-apps-and-objects.md).
+
+This will take you to the chat GUI:
+
+:::{image} images/agent-builder-chat-UI-get-started.png
+:::
+:alt: The main Agent Chat GUI showing the chat window, message input box, and agent selection panel
+
+## Agent Chat GUI
+
+### Chat and select agent
+
+Use the text input area to chat with an agent in real time. By default, you'll be chatting with the built-in Elastic AI Agent.
+
+:::{image} images/agent-builder-chat-input.png
+:alt: Text input area for chatting with agents
+:width: 850px
+:::
+
+#### Agent selector
+
+Use the agent selector to switch agents, to navigate to the agent management section, or to create a new agent.
+
+:::{image} images/agent-builder-agent-selector.png
+:alt: Agent selector dropdown and message input field
+:width: 850px
+:::
+
+### Find conversation history
+
+The left sidebar shows your conversation history, so you can easily access all your conversations.
+
+:::{image} images/agent-builder-chat-history.png
+:alt: Chat history panel showing conversation list
+:width: 250px
+:::
+
+## Agent Chat API
+
+The Agent Chat API provides programmatic access to chat functionality through REST endpoints.
+
+### Quick overview
+
+For a quick overview of the REST API for conversations, refer to [Chat and conversations API](kibana-api.md#chat-and-conversations).
+
+### Serverless API reference
+
+For the complete API reference, refer to the [Kibana serverless API reference](https://www.elastic.co/docs/api/doc/serverless/). 
+
+
+
+
+
 
 
-The **Agent Chat** UI is the synchronous chat interface for interacting with agents through natural language. The chat UI enables real-time communication where you can ask questions, request data analysis, and receive immediate responses from your configured agents.
 

solutions/search/agent-builder/get-started.md

@@ -7,15 +7,15 @@ applies_to:
 ---
 
 :::{warning}
-WIP
+These pages are currently hidden from the docs TOC and have `noindexed` meta headers.
 
-These pages are hidden from the docs TOC and have `noindexed` meta headers.
+**Go to the docs [landing page](/solutions/search/elastic-agent-builder.md).**
 :::
 
 # Get started with {{agent-builder}}
 
 :::{tip}
-See the [overview page](../elastic-agent-builder.md) for full list of docs pages.
+refer to the [overview page](../elastic-agent-builder.md) for full list of docs pages.
 :::
 % TODO: Delete this tip when unhide pages
 
@@ -70,7 +70,6 @@ The **Agent Chat** UI provides a conversational interface where you can interact
 
 Learn more in [Agent Chat](chat.md).
 
-
 ::::
 
 ::::{step} Start building agents and tools