Publish agent builder docs

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

@@ -6,12 +6,6 @@ applies_to:
     elasticsearch: preview
 ---
 
-:::{warning}
-These pages are currently 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
 
 The [**Agent-to-Agent (A2A) server**](https://github.com/a2aproject/A2A) enables external A2A clients to communicate with {{agent-builder}} agents.

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

@@ -6,12 +6,6 @@ applies_to:
     elasticsearch: preview
 ---
 
-:::{warning}
-These pages are currently 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 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.

solutions/search/agent-builder/chat.md

@@ -1,20 +1,14 @@
 ---
-navigation_title: "Agent Chat UI"
+navigation_title: "Agent Chat"
 applies_to:
   stack: preview 9.2
   serverless:
     elasticsearch: preview
 ---
 
-:::{warning}
-These pages are currently 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
 
-**Agent Chat** is the synchronous chat interface for natural language conversations with your [agents](agent-builder-agents.md).
+**Agent Chat** is the chat interface for natural language conversations with your [agents](agent-builder-agents.md).
 
 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.
 

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

@@ -6,19 +6,8 @@ applies_to:
     elasticsearch: preview
 ---
 
-:::{warning}
-These pages are currently 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}
-Refer to the [overview page](../elastic-agent-builder.md) for the full list of Agent Builder docs.
-:::
-% TODO: Remove this tip when unhide pages
-
 Learn how to get started by enabling the {{agent-builder}} features and begin chatting with your data.
 
 :::::{stepper}
@@ -74,6 +63,12 @@ Learn more in [Agent Chat](chat.md).
 
 ::::
 
+::::{step} Configure model (optional)
+
+By default, {{agent-builder}} uses the Elastic Managed LLM. To use a different model, refer to [model selection and configuration](models.md).
+
+::::
+
 ::::{step} Begin building agents and tools
 
 Once you've tested the default **Elastic AI Agent** with the [built-in Elastic tools](tools.md), you can begin [building your own agents](agent-builder-agents.md#create-a-new-agent) with custom instructions and [creating your own tools](tools.md#create-custom-tools) to assign them.

solutions/search/agent-builder/kibana-api.md

@@ -6,12 +6,6 @@ applies_to:
     elasticsearch: preview
 ---
 
-:::{warning}
-These pages are currently hidden from the docs TOC and have `noindexed` meta headers.
-
-**Go to the docs [landing page](/solutions/search/elastic-agent-builder.md).**
-:::
-
 # Work with {{agent-builder}} using the APIs
 
 This page provides a quick overview of the main Kibana API endpoints for {{agent-builder}}. For complete details including all available parameters, request/response schemas, and error handling, refer to the [Kibana serverless API reference](https://www.elastic.co/docs/api/doc/serverless/group/endpoint-agent-builder).

solutions/search/agent-builder/limitations-known-issues.md

@@ -6,12 +6,6 @@ applies_to:
     elasticsearch: preview
 ---
 
-:::{warning}
-These pages are currently hidden from the docs TOC and have `noindexed` meta headers.
-
-**Go to the docs [landing page](/solutions/search/elastic-agent-builder.md).**
-:::
-
 # Limitations and known issues in {{agent-builder}}
 
 ## Limitations
@@ -22,9 +16,9 @@ While in private technical preview, {{agent-builder}} is not enabled by default.
 
 ### Model selection
 
-Initially, {{agent-builder}} only supports working with the [Elastic Managed LLM](kibana://reference/connectors-kibana/elastic-managed-llm.md) running on the [Elastic Inference Service](/explore-analyze/elastic-inference/eis.md) {applies_to}`serverless: preview` {applies_to}`ess: preview 9.2`.
+Initially, {{agent-builder}} defaults to working with the [Elastic Managed LLM](kibana://reference/connectors-kibana/elastic-managed-llm.md) running on the [Elastic Inference Service](/explore-analyze/elastic-inference/eis.md) {applies_to}`serverless: preview` {applies_to}`ess: preview 9.2`.
 
-Learn about [pricing](https://www.elastic.co/pricing/serverless-search) for the Elastic Managed LLM.
+Learn more on the [models page](models.md).
 
 ## Known issues
 

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

@@ -8,12 +8,6 @@ applies_to:
 
 # Model Context Protocol (MCP) server
 
-:::{warning}
-These pages are currently hidden from the docs TOC and have `noindexed` meta headers.
-
-**Go to the docs [landing page](/solutions/search/elastic-agent-builder.md).**
-:::
-
 The [**Model Context Protocol (MCP) server**](https://modelcontextprotocol.io/docs/getting-started/intro) provides a standardized interface for external clients to access {{agent-builder}} tools.
 
 ## MCP server endpoint

solutions/search/agent-builder/models.md

@@ -1,15 +1,94 @@
 ---
-navigation_title: "Use different models"
+navigation_title: "Models"
 applies_to:
   stack: preview 9.2
   serverless:
     elasticsearch: preview
 ---
 
-:::{warning}
-These pages are currently hidden from the docs TOC and have `noindexed` meta headers.
+# Using different models in {{agent-builder}}
 
-**Go to the docs [landing page](/solutions/search/elastic-agent-builder.md).**
+{{agent-builder}} uses large language models (LLMs) to power agent reasoning and decision-making. By default, agents use the Elastic Managed LLM, but you can configure other models through Kibana connectors.
+
+## Default model configuration
+
+By default, {{agent-builder}} uses the Elastic Managed LLM connector running on the [Elastic Inference Service](/explore-analyze/elastic-inference/eis.md) {applies_to}`serverless: preview` {applies_to}`ess: preview 9.2`. 
+
+This managed service requires zero setup and no additional API key management.
+
+Learn more about the [Elastic Managed LLM connector](kibana://reference/connectors-kibana/elastic-managed-llm.md) and [pricing](https://www.elastic.co/pricing).
+
+## Change the default model
+
+By default, {{agent-builder}} uses the Elastic Managed LLM. To use a different model, select a configured connector and set it as the default.
+
+### Use a pre-configured connector
+
+1. Search for **GenAI Settings** in the global search field
+2. Select your preferred connector from the **Default AI Connector** dropdown
+3. Save your changes
+
+### Create a new connector in the UI
+
+1. Find connectors under **Alerts and Insights / Connectors** in the [global search bar](/explore-analyze/find-and-organize/find-apps-and-objects.md)
+2. Select **Create Connector** and select your model provider
+3. Configure the connector with your API credentials and preferred model
+4. Search for **GenAI Settings** in the global search field
+5. Select your new connector from the **Default AI Connector** dropdown under **Custom connectors**
+6. Save your changes
+
+For detailed instructions on creating connectors, refer to [Connectors](https://www.elastic.co/docs/deploy-manage/manage-connectors).
+
+Learn more about [preconfigured connectors](https://www.elastic.co/docs/reference/kibana/connectors-kibana/pre-configured-connectors).
+
+#### Connect a local LLM
+
+You can connect a locally hosted LLM to Elastic using the OpenAI connector. This requires your local LLM to be compatible with the OpenAI API format.
+
+Refer to the [OpenAI connector documentation](kibana://reference/connectors-kibana/openai-action-type.md) for detailed setup instructions.
+
+## Connectors API
+
+For programmatic access to connector management, refer to the [Connectors API documentation]({{kib-serverless-apis}}group/endpoint-connectors).
+
+## Recommended models
+
+{{agent-builder}} requires models with strong reasoning and tool-calling capabilities. State-of-the-art models perform significantly better than smaller or older models.
+
+### Recommended model families
+
+The following models are known to work well with {{agent-builder}}:
+
+- **OpenAI**: GPT-4.1, GPT-4o
+- **Anthropic**: Claude Sonnet 4.5, Claude Sonnet 4, Claude Sonnet 3.7
+- **Google**: Gemini 2.5 Pro
+
+### Why model quality matters
+
+Agent Builder relies on advanced LLM capabilities including:
+
+- **Function calling**: Models must accurately select appropriate tools and construct valid parameters from natural language requests
+- **Multi-step reasoning**: Agents need to plan, execute, and adapt based on tool results across multiple iterations
+- **Structured output**: Models must produce properly formatted responses that the agent framework can parse
+
+Smaller or less capable models may produce errors like:
+
+```console-response
+Error: Invalid function call syntax
+```
+
+```console-response
+Error executing agent: No tool calls found in the response.
+```
+
+While any chat-completion-compatible connector can technically be configured, we strongly recommend using state-of-the-art models for reliable agent performance.
+
+:::{note}
+GPT-4o-mini and similar smaller models are not recommended for {{agent-builder}} as they lack the necessary capabilities for reliable agent workflows.
 :::
 
-# Using different models in {{agent-builder}}
+## Related pages
+
+- [Limitations and known issues](limitations-known-issues.md): Current limitations around model selection
+- [Get started](get-started.md): Initial setup and configuration
+- [Connectors](/deploy-manage/manage-connectors.md): Detailed connector configuration guide

solutions/search/agent-builder/programmatic-access.md

@@ -6,12 +6,6 @@ applies_to:
     elasticsearch: preview
 ---
 
-:::{warning}
-These pages are currently hidden from the docs TOC and have `noindexed` meta headers.
-
-**Go to the docs [landing page](/solutions/search/elastic-agent-builder.md).**
-:::
-
 # Work programmatically with {{agent-builder}}
 
 {{agent-builder}} provides comprehensive integration options for programmatic access and automation.

solutions/search/agent-builder/tools.md

@@ -6,12 +6,6 @@ applies_to:
     elasticsearch: preview
 ---
 
-:::{warning}
-These pages are currently hidden from the docs TOC and have `noindexed` meta headers.
-
-**Go to the docs [landing page](/solutions/search/elastic-agent-builder.md).**
-:::
-
 # Tools in {{agent-builder}}
 
 [Agents](agent-builder-agents.md) use tools to search, retrieve, and take meaningful steps on your behalf.

solutions/search/agent-builder/tools/esql-tools.md

@@ -6,11 +6,7 @@ applies_to:
     elasticsearch: preview
 ---
 
-:::{warning}
-These pages are currently hidden from the docs TOC and have `noindexed` meta headers.
 
-**Go to the docs [landing page](/solutions/search/elastic-agent-builder.md).**
-:::
 
 # {{esql}} tools
 

solutions/search/agent-builder/tools/index-search-tools.md

@@ -6,11 +6,7 @@ applies_to:
     elasticsearch: preview
 ---
 
-:::{warning}
-These pages are currently hidden from the docs TOC and have `noindexed` meta headers.
 
-**Go to the docs [landing page](/solutions/search/elastic-agent-builder.md).**
-:::
 
 # Index search tools
 

solutions/search/elastic-agent-builder.md

@@ -6,10 +6,6 @@ applies_to:
     elasticsearch: preview
 ---
 
-:::{warning}
-These pages are currently hidden from the docs TOC and have `noindexed` meta headers.
-:::
-
 # {{agent-builder}} 
 
 {{agent-builder}} is a set of AI-powered capabilities for developing and interacting with agents that work with your {{es}} data. Agent Builder simplifies building data-driven agents with intuitive UI and programmatic interfaces, so you don't have to compose the different pieces separately.
@@ -54,6 +50,13 @@ To get started you need an Elastic deployment and you must enable the feature.
 
 [**Get started with {{agent-builder}}**](agent-builder/get-started.md)
 
+## Model selection
+
+By default, agents use the Elastic Managed LLM, but you can configure other model providers using connectors, including local LLMs deployed on your infrastructure.
+
+[**Learn more about model selection**](agent-builder/models.md)
+
+
 ## Programmatic interfaces
 
 {{agent-builder}} provides APIs and LLM integration options for programmatic access and automation.

solutions/toc.yml

@@ -44,19 +44,22 @@ toc:
               - file: search/semantic-search/semantic-search-elser-ingest-pipelines.md
               - file: search/semantic-search/cohere-es.md
           - file: search/using-openai-compatible-models.md
-      - hidden: search/elastic-agent-builder.md
-      - hidden: search/agent-builder/get-started.md
-      - hidden: search/agent-builder/models.md
-      - hidden: search/agent-builder/chat.md
-      - hidden: search/agent-builder/agent-builder-agents.md
-      - hidden: search/agent-builder/tools.md
-      - hidden: search/agent-builder/tools/esql-tools.md
-      - hidden: search/agent-builder/tools/index-search-tools.md
-      - hidden: search/agent-builder/programmatic-access.md
-      - hidden: search/agent-builder/kibana-api.md
-      - hidden: search/agent-builder/mcp-server.md
-      - hidden: search/agent-builder/a2a-server.md
-      - hidden: search/agent-builder/limitations-known-issues.md
+      - file: search/elastic-agent-builder.md
+        children:
+          - file: search/agent-builder/get-started.md
+          - file: search/agent-builder/models.md
+          - file: search/agent-builder/chat.md
+          - file: search/agent-builder/agent-builder-agents.md
+          - file: search/agent-builder/tools.md
+            children:
+              - file: search/agent-builder/tools/esql-tools.md
+              - file: search/agent-builder/tools/index-search-tools.md
+          - file: search/agent-builder/programmatic-access.md
+            children:
+              - file: search/agent-builder/kibana-api.md
+              - file: search/agent-builder/a2a-server.md
+              - file: search/agent-builder/mcp-server.md
+          - file: search/agent-builder/limitations-known-issues.md
       - file: search/rag.md
         children:
           - file: search/rag/playground.md