Merge branch 'main' into gs-2795-fix

Author: jmikell821

deploy-manage/users-roles/cloud-organization/configure-saml-authentication.md

@@ -96,7 +96,9 @@ You must have authority to modify your domain’s DNS records and be a member of
 It might take some time for the DNS records to be updated and propagated in the network. If verification isn’t successful, wait a while and try again.
 ::::
 
-
+::::{note}
+After the domain has been claimed by your organization, you can safely remove the TXT record from your DNS provider settings. You must remove this record if you want to claim the same domain in additional {{ecloud}} organizations.
+::::
 
 ### Step 2: Register a SAML IdP [ec-saml-sso-register-idp]
 

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

@@ -7,8 +7,6 @@ applies_to:
 ---
 
 :::{warning}
-WIP
-
 These pages are hidden from the docs TOC and have `noindexed` meta headers.
 :::
 
@@ -18,7 +16,8 @@ These APIs allow you to programmatically work with the {{agent-builder}} abstrac
 
 ## API reference
 
-For the full API documentation, refer to the [Kibana API reference](https://www.elastic.co/docs/api/doc/kibana/).
+For the full API documentation, refer to the [Kibana serverless API reference](https://www.elastic.co/docs/api/doc/serverless/).
+% TODO: Update link once page is live
 
 ## Using the APIs
 

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

@@ -7,18 +7,20 @@ applies_to:
 ---
 
 :::{warning}
-WIP
-
 These pages are hidden from the docs TOC and have `noindexed` meta headers.
 :::
 
 # Work programmatically with {{agent-builder}}
 
-{{agent-builder}} provides comprehensive APIs and additional integration options for programmatic access and automation.
+{{agent-builder}} provides comprehensive integration options for programmatic access and automation.
 
 These interfaces enable you to build integrations with other applications and extend Agent Builder's capabilities to fit your specific requirements.
 
-- **[Kibana API](kibana-api.md)**: RESTful APIs for working with {{agent-builder}} programmatically
+:::{tip}
+Most users will probably want to integrate with Agent Builder using MCP or A2A, but you can also work programmatically with tools, agents, and conversations using the Kibana APIs.
+:::
+
 - **[MCP server](mcp-server.md)**: A standardized interface that allows external MCP clients (such as Claude Desktop or Cursor) to access {{agent-builder}} tools
 - **[A2A server](a2a-server.md)**: Agent-to-agent communication endpoints that follow the A2A protocol specification, enabling external A2A clients to interact with {{agent-builder}} agents
+- **[Kibana API](kibana-api.md)**: RESTful APIs for working with {{agent-builder}} programmatically
 

solutions/search/elastic-agent-builder.md

@@ -14,7 +14,9 @@ These pages are hidden from the docs TOC and have `noindexed` meta headers.
 
 # {{agent-builder}} 
 
-{{agent-builder}} is an AI-powered conversation framework for working with {{es}} data using natural language. It features both a chat UI for synchronous interaction and extensive programmatic access through APIs, MCP and A2A servers.
+{{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.
+
+You can use the built-in agent for natural language conversations with any {{es}} data or instance, or work programmatically with tools, agents, and conversations using Elastic APIs, MCP, and A2A.
 
 ## Key capabilities