update akri overviews

Author: yujinkim-msft

articles/iot-operations/discover-manage-assets/overview-akri.md

@@ -1,6 +1,6 @@
 ---
-title: Discover assets (preview)
-description: Understand how the Akri services enable you to discover devices and assets at the edge, and expose them as resources on your cluster.
+title: Configure assets (preview)
+description: Understand how the Akri services enable you to detect and discover devices and assets at the edge, and expose them as resources on your cluster.
 author: dominicbetts
 ms.author: dobett
 ms.subservice: azure-akri
@@ -12,11 +12,11 @@ ms.date: 07/08/2025
 # CustomerIntent: As an industrial edge IT or operations user, I want to to understand how the Akri services enable me to discover devices and assets at the edge, and expose them as resources on a Kubernetes cluster.
 ---
 
-# What is asset and device discovery (preview)?
+# What are Akri services (preview)?
 
 Azure IoT Operations discovers devices and assets by using the included Akri services (preview). The Akri services enable protocol connections and configurations by using Azure Device Registry. The Akri services simplify the process of projecting leaf devices such as OPC UA servers, cameras, IoT sensors, and other assets into the Azure Device Registry. The Akri services use the devices' own protocols to project leaf devices as Azure Resource Manager resources in the Azure Device Registry. For administrators who attach or remove devices from a cluster, this capability reduces the amount of coordination and manual configuration required.
 
-The Akri services are an extensible framework for all device protocols. You can use them with out-of-the-box and partner-built connectors, or you can add custom discovery and provisioning capabilities by adding protocol handlers, connectors, and behaviors. Adding custom logic is made easy with the [Azure IoT Operations SDK](https://github.com/azure/iot-operations-sdks) (preview).
+The Akri services are an extensible framework for all device protocols. You can use them with out-of-the-box and partner-built connectors, or you can add custom protocol capabilities by creating connectors. Adding custom logic is made easy with the [Azure IoT Operations SDK](https://github.com/azure/iot-operations-sdks) (preview). Akri services handles the dynamic deployment and lifecycle management of these connectors and the SDK provides clients which make it easy for your connector to interface with other Azure IoT Operations components, so that you can solely focus on the business logic of your connector. 
 
 The Akri services are a Microsoft-managed commercial version of [Akri](https://docs.akri.sh/), an open-source Cloud Native Computing Foundation (CNCF) project.
 
@@ -35,23 +35,20 @@ IoT leaf devices present the following challenges, They:
 
 To address the challenge of integrating non-Kubernetes IoT leaf devices, the Akri services have several core capabilities:
 
-### Device discovery
-
-Akri services deployments can include fixed-network discovery handlers. Discovery handlers enable assets from known network endpoints to find leaf devices as they appear on device interfaces or local subnets. Examples of network endpoints include OPC UA servers at a fixed IP address, and network scanning discovery handlers.
+### Connector deployment and lifecycle management
+Akri services include the Akri operator which allows connector workloads to be deployed dynamically when certain types of devices or assets are discovered/configured, provides automatic access to Azure IoT Operations resources and endpoints (like Devices and Assets), deploys connector workloads to the right nodes based on discovery information like node affinity, and more. 
 
-### Dynamic provisioning
+### Asset detection 
+Akri services also include the Azure Device Registry (ADR) service component, which work with the connectors that have asset detection capabilities. These connectors enable the metadata and preconfigured datasets, events, etc. to be onboarded with ease through known device endpoints. Akri ADR service creates the detected Assets as custom resources which are picked up by the operations experience UI so that as an OT, you can seamlessly view and onboard the detected assets into the Azure Device Registry. 
 
-Another capability of the Akri services is dynamic device provisioning.  
+### Device discovery
 
-With the Akri services, you can dynamically provision devices such as:
+Akri services deployments can include fixed-network discovery handlers. Discovery handlers enable assets from known network endpoints to find leaf devices as they appear on device interfaces or local subnets. Examples of network endpoints include OPC UA servers at a fixed IP address, and network scanning discovery handlers. This is not yet supported in this release.
 
-- USB cameras to use in your cluster.
-- IP cameras that you don't want to look up IP addresses for.
-- OPC UA server simulations running on your host machine that you use to test Kubernetes workloads.
 
 ### Compatibility with Kubernetes
 
-The Akri services use standard Kubernetes primitives that let you apply your existing expertise and knowledge. Small devices connected to an Akri-configured cluster can appear as Kubernetes resources, just like memory or CPUs. The Akri services controller enables the cluster operator to start brokers, jobs, or other workloads for individual connected devices or groups of devices. These device configurations and properties remain in the cluster so that if there's node failure, other nodes can pick up any lost work.
+The Akri services use standard Kubernetes primitives that let you apply your existing expertise and knowledge. Small devices connected to an Akri-configured cluster can appear as Kubernetes resources, just like memory or CPUs. The Akri services controller enables the cluster operator to start brokers, jobs, or other workloads for individual connected devices or groups of devices. These device configurations and properties remain in the cluster so that if there's node failure, other nodes can pick up any lost work. Security and authentication is also standardized on Kubernetes secrets and TLS practices, making it easy to secure your device connections, no matter the protocol. 
 
 ## Connectors supported
 
@@ -62,7 +59,11 @@ The following table shows the connectors currently available in Azure IoT Operat
 | Connector for OPC UA   |       Yes        |      Yes        |
 | Connector for ONVIF    |        No        |      Yes        |
 | Media connector        |       Yes        |       No        |
+<<<<<<< Updated upstream
 | Connector for REST/HTTP        |        No        |       No        |
+=======
+| REST/HTTP connector         |        No        |       No        |
+>>>>>>> Stashed changes
 
 The media connector supports discovery of cameras and other media devices that use the ONVIF protocol.
 
@@ -92,11 +93,18 @@ The Akri services support the following features:
 | View the Akri services metrics and logs through Azure Monitor |   Yes     |
 | The Akri services discover and create assets that can be ingested into the Azure Device Registry  |   Yes     |
 | Akri services configuration by using the operations experience web UI |   Yes     |
-| Deployment and management features for integrating non-Microsoft or custom protocol connectors and discovery handlers |   No     |
+| Deployment and management features for integrating non-Microsoft or custom protocol connectors |   Yes     |
+| Deployment and management features for integrating non-Microsoft or custom protocol discovery handlers |   No     |
 
 ## Related content
 
-To learn more about the Akri services, see [Discover OPC UA data sources using the Akri services](howto-autodetect-opc-ua-assets-use-akri.md)
+To learn more about OPC UA automatic asset discovery with Akri services, see [Discover OPC UA data sources using the Akri services](howto-autodetect-opc-ua-assets-use-akri.md)
+
+To learn more about using Akri with ONVIF, Media, or REST/HTTP, see:
+- [Understand the connector for media](/articles/iot-operations/discover-manage-assets/overview-media-connector.md)
+- [Understand the connector for ONVIF](/articles/iot-operations/discover-manage-assets/overview-onvif-connector.md)
+- [Understand the connector for REST/HTTP](/articles/iot-operations/discover-manage-assets/overview-http-connector.md)
+
 
 To learn more about the open-source CNCF Akri, see the following resources:
 

articles/iot-operations/discover-manage-assets/overview-manage-assets.md

@@ -99,7 +99,9 @@ Azure IoT Operations includes several services that help you manage devices and
 - The **connector for ONVIF (preview)** is a service that discovers and registers ONVIF assets such as cameras. The connector enables you to manage and control ONVIF assets such as cameras connected to your cluster.
 - The **connector for REST/HTTP** is a service that lets you connect to REST/HTTP endpoints and publish data to the MQTT broker.
 - **Custom connectors** are services that you can create to connect to other data sources and publish data to the MQTT broker. Use the Azure IoT Operations SDKS to create custom connectors that meet your specific requirements.
-- **Akri services** are a set of services that enable the automatic discovery of physical assets and devices in your environment. Akri services can help you create and configure assets and devices in operations experience. To learn more, see [What is asset discovery (preview)?](overview-akri.md).
+- **Akri services** are a set of services that enable protocol and edge-focused data processing stack connectivity for customers with a simple all-in-one deployment + an elegant, no-code UI for on-site technicians in manufacturing/healthcare, store employees in retail, etc. It enables a seamless modeling of different device and protocol connections through the concept of Assets. 
+
+
 
 ## Create and manage assets
 
@@ -187,8 +189,14 @@ Events:                   <none>
 
 ### Automatic asset discovery
 
+<<<<<<< Updated upstream
 Akri services let you deploy and configure connectivity protocols, such as OPC UA and ONVIF, at the edge. Akri services use the asset and device resources in Azure Device Registry to model the different device and protocol connections in your environment.
 
 Akri services simplify the process of creating assets by automatically onboarding assets with pre-configured datasets and device endpoints generated by the connectors to represent capabilities and devices on the network.
 
 To learn more, see [What is asset and device discovery (preview)?](overview-akri.md).
+=======
+Akri services let you deploy and configure connectivity protocols at the edge. Akri services use the asset and device resources in Azure Device Registry to model the different device and protocol connections in your environment. It enables you to easily onboard and provision assets with open standards. It provides an extensible framework for all device protocols and a single pane of glass view for all assets.
+
+Akri services simplify the process of creating assets by automatically onboarding assets with pre-configured datasets and endpoints generated by the connectors to represent capabilities and devices on the network.
+>>>>>>> Stashed changes