More search-ai-platform.md edits

Author: lcawl

get-started/search-ai-platform.md

@@ -18,25 +18,20 @@ It is the foundation for Elastic's [solutions](/get-started/introduction.md) and
 
 The {{search-platform}} is a fast and highly scalable set of components — {{es}}, {{kib}}, {{beats}}, {{ls}}, and others — that together enable you to securely take data from any source, in any format, and then store, search, analyze, and visualize it.
 
+$$$stack-components$$$
 ![Components of the {{search-platform}}](/get-started/images/platform-components-diagram.svg)
 
 :::{tip}
 The components that share the same versioning scheme are often referred to as the _{{stack}}_. Learn more in [](/get-started/versioning-availability.md).
 :::
 
-You have many options for deploying the {{search-platform}} to suit your needs, which are summarized in [](/get-started/deployment-options.md).
-<!--
-TBD: Is this necessary to cover here? How can we make this easier to understand and navigation?
-To learn how to deploy {{es}}, {{kib}}, and supporting orchestration technologies, refer to [](/deploy-manage/index.md).
-To learn how to deploy additional ingest and consume components, refer to the documentation for the component.
--->
+You have many options for deploying the {{search-platform}}, which are summarized in [](/get-started/deployment-options.md).
+All deployments include [{{es}}](#stack-components-elasticsearch).
+Although [{{kib}}](#stack-components-kibana) is not required to use {{es}}, it is included by default when you use deployment methods such as {{serverless-full}}.
 
 Continue reading to learn how these components work together.
 
-% TO-DO: Update SVG
-% ![Components of the {{search-platform}}](/get-started/images/stack-components-diagram.svg)
-
-## Ingestion
+## Ingest [_ingest]
 
 Elastic provides a number of components that ingest data.
 Collect and ship logs, metrics, and other types of data with {{agent}} or {{beats}}.
@@ -88,12 +83,11 @@ It can dynamically unify data from disparate sources and normalize the data into
 
 [Learn more about {{ls}}](logstash://reference/index.md).
 
-## Storage, search, and AI analysis
+## Store, search, and analyze [_store]
 
 {{es}} is the distributed search, storage, and analytics engine at the heart of the {{search-platform}}.
-You can use the {{es}} clients to access data directly by using common programming languages.
 
-### {{es}} [components-elasticsearch]
+### {{es}} [stack-components-elasticsearch]
 
 {{es}} provides near real-time search and analytics for all types of data.
 Whether you have structured or unstructured text, numerical data, vectors, or geospatial data, {{es}} can efficiently store and index it in a way that supports fast searches.
@@ -103,62 +97,35 @@ It runs as a cluster of one or more servers, called nodes.
 When you add data to an index, it's divided into pieces called shards, which are spread across the various nodes in the cluster.
 This architecture allows {{es}} to handle large volumes of data and ensures that your data remains available even if a node fails.
 
-{{es}} provides a REST API that enables you to store data in {{es}} and retrieve it.
-The REST API also provides access to search and analytics capabilities.
-
-Learn more about [the {{es}} data store](/manage-data/data-store.md), its [distributed architecture](/deploy-manage/distributed-architecture.md), and [search approaches](/solutions/search/search-approaches.md). 
-
-### {{es}} clients [stack-components-elasticsearch-clients]
-
-The clients provide a convenient mechanism to manage API requests and responses to and from {{es}} from popular languages such as Java, Ruby, Go, Python, and others.
-Both official and community contributed clients are available.
+Nearly every aspect of {{es}} can be configured and managed programmatically through its REST APIs.
+This allows you to automate repetitive tasks and integrate Elastic management into your existing operational workflows.
+For example, you can use the APIs to manage indices, update cluster settings, run complex queries, and configure security.
+This API-first approach is fundamental to enabling infrastructure-as-code practices and managing deployments at scale.
 
-[Learn more about the {{es}} clients](/reference/elasticsearch-clients/index.md).
+Learn more about [the {{es}} data store](/manage-data/data-store.md), its [distributed architecture](/deploy-manage/distributed-architecture.md), and [APIs](elasticsearch://reference/elasticsearch/rest-apis/index.md).
 
-## Exploration and visualization
+## Explore [_consume]
 
-Use {{kib}} to query and visualize the data that's stored in {{es}}.
+Use {{kib}} to explore and visualize the data that's stored in {{es}} and to manage the {{search-platform}}.
+You can use the {{es}} clients to access data directly by using common programming languages.
 
 ### {{kib}} [stack-components-kibana]
 
-{{kib}} is the tool to harness your {{es}} data and to manage the {{search-platform}}.
-Use it to analyze and visualize the data that's stored in {{es}}.
-{{kib}} is also the home for two out-of-the-box [solutions](/get-started/introduction.md).
-
-[Learn more about {{kib}}](/explore-analyze/index.md).
-
-
-
-<!--
-
-
-### Visualize and query your data [kibana-navigation-search]
-
-While {{es}} stores your data, **Kibana** is the user interface where you can explore, visualize, and manage it. It provides a window into your data, allowing you to quickly gain insights and understand trends.
-
-With Kibana, you can:
+With {{kib}}, you can:
 
 * Use **Discover** to interactively search and filter your raw data.  
-* Build custom **visualizations** like charts, graphs, and metrics with tools like **Lens**, which offers a drag-and-drop experience.  
-* Assemble your visualizations into interactive **dashboards** to get a comprehensive overview of your information.  
+* Build custom visualizations like charts, graphs, and metrics with tools like **Lens**, which offers a drag-and-drop experience.  
+* Assemble your visualizations into interactive dashboards to get a comprehensive overview of your information.  
 * Analyze geospatial data using the powerful **Maps** application.
 
-At the same time, Kibana works as the user interface of all Elastic solutions, like Elastic Security and Elastic Observability, providing ways of configuring Elastic to suit your needs and offering interactive guidance.
-
-A **query** is a question you ask about your data, and Elastic provides several powerful languages to do so. You can query data directly through the API or through the user interface in Kibana.
-
-* **Query DSL** is a full-featured JSON-style query language that enables complex searching, filtering, and aggregations. It is the original and most powerful query language for Elasticsearch today.
-* **Elasticsearch Query Language (ES|QL)** is a powerful, modern query language that uses a familiar pipe-based syntax to transform and aggregate your data at search time.  
-* **Event Query Language (EQL)** is a specialized language designed to query sequences of events, which is particularly useful for security analytics and threat hunting.
-* **Kibana Query Language (KQL)** is the text-based language used in the **Discover** search bar, perfect for interactive filtering and exploration.  
+It also has [query tools](/explore-analyze/query-filter/tools.md) such as **Console**, which provides an interactive way to send requests directly to the {{es}} API and view the responses.
+For secure, automated access, you can create and manage API keys to authenticate your scripts and applications.
 
-Learn more in [](/explore-analyze/index.md).
-
-### Use the APIs to automate operations and management
+[Learn more about {{kib}}](/explore-analyze/index.md).
 
-Nearly every aspect of Elasticsearch can be configured and managed programmatically through its extensive REST APIs. This allows you to automate repetitive tasks and integrate Elastic management into your existing operational workflows. You can use the APIs to manage indices, update cluster settings, run complex queries, and configure security. 
+### {{es}} clients [stack-components-elasticsearch-clients]
 
-The **Console** tool in Kibana provides an interactive way to send requests directly to the Elasticsearch API and view the responses. For secure, automated access, you can create and manage **API keys** to authenticate your scripts and applications. This API-first approach is fundamental to enabling infrastructure-as-code practices and managing your deployments at scale.
+The clients provide a convenient mechanism to manage API requests and responses to and from {{es}} from popular languages such as Java, Ruby, Go, Python, and others.
+Both official and community contributed clients are available.
 
-Learn more in [Elastic APIs](https://www.elastic.co/docs/api).
--->
+[Learn more about the {{es}} clients](/reference/elasticsearch-clients/index.md).