Merge latest into MS2026-02-17-ACB, resolve conflicts

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: Crispy-Salesforce

modules/ROOT/assets/images/agent-fabric-architecture.png

@@ -50,7 +50,7 @@
 ** xref:af-define-your-agent-network-specification.adoc[]
 ** xref:af-publish-agent-network-assets.adoc[]
 ** xref:af-deploy-agent-network-targets.adoc[]
-** xref:af-troubleshoot-anypoint-code-builder.adoc[]
+** xref:af-troubleshoot-agent-networks.adoc[]
 ** xref:af-build-agent-networks-in-a-ci-cd-environment.adoc[]
 ** xref:af-project-files.adoc[]
 * xref:ai-enabling-api-project-topic-center.adoc[]

modules/ROOT/nav.adoc

@@ -86,7 +86,7 @@ If an Anypoint Platform session is active in any of your browsers when you insta
 [[update-pack]]
 === Update Anypoint Extension Pack 
 
-If Anypoint Extension Pack is installed on your desktop IDE, update to the latest version of the extension pack by following VS Code instructions in https://code.visualstudio.com/docs/editor/extension-marketplace#_update-an-extension-manually[Update an extension manually^].
+If Anypoint Extension Pack is installed on your desktop IDE, update to the latest version of the extension pack by following VS Code instructions in https://code.visualstudio.com/docs/configure/extensions/extension-marketplace#_update-an-extension-manually[Update an extension manually^].
 
 [[uninstall-pack]]
 === Uninstall Anypoint Extension Pack
@@ -103,6 +103,6 @@ To uninstall:
 . In the Anypoint Extension Pack tab that opens, click *Uninstall*. 
 . To remove the Anypoint Code Builder extensions from the Extensions panel, click *Reload* on one of the extensions. 
 
-For additional guidance, see the VS Code documentation, https://code.visualstudio.com/docs/editor/extension-marketplace#_manage-extensions[Manage extensions^].
+For additional guidance, see the VS Code documentation, https://code.visualstudio.com/docs/configure/extensions/extension-marketplace#_manage-extensions[Manage extensions^].
 
-You can reinstall at any time.
+You can reinstall at any time.

modules/ROOT/pages/_partials/acb-start-desktop.adoc

@@ -74,7 +74,7 @@ Allowlist Anypoint Code Builder URLs. For more information, see xref:anypoint-co
 
 If you're using the Anypoint CLI to create agent network projects, ensure you meet these requirements.
 
-* Node 20 (v20.19.4) or later. See http://Nodejs.org[Nodejs.org].
+* Node 20 (v20.19.4) or later. See https://nodejs.org/en[Nodejs.org].
 * Java 17 or later. Set the `JAVA_HOME` environment variable.
 * xref:anypoint-code-builder::af-build-agent-networks-in-a-ci-cd-environment.adoc[Anypoint CLI Fabric Plugin]
 
@@ -127,4 +127,4 @@ Deploy your agent network instance to a deployment target. You can deploy to a C
 * xref:anypoint-code-builder::af-deploy-agent-network-targets.adoc#deploy-acb[Deploy Your Network Using Anypoint Code Builder]
 * xref:anypoint-code-builder::af-build-agent-networks-in-a-ci-cd-environment.adoc#agent-network-project-deploy[Deploy Your Network Using the Anypoint CLI]
 // end::get-started[]
-//
+//

modules/ROOT/pages/_partials/af-shared.adoc

@@ -1,21 +1,67 @@
 = Building Agent Networks for Agent Fabric
 
-Agent Fabric manages and coordinates the execution of agents across your enterprise, regardless of where they're deployed. Agent Fabric solves the problem of integrating and automating complex processes that involve multiple agents and tools.
+An agent network is a coordinated group of agents, brokers, LLMs, and MCP servers that acts as a central hub for defining, validating, and executing agentic processes across your enterprise.
 
-Complex tasks often require a series of steps, with each step handled by a different agent or tool. Managing this process manually is difficult and error-prone. Agent networks (networks of agents in a domain) act as central hubs for defining, validating, and executing these multi-step processes.
+An agent network provides the building blocks of your agentic deployment while MuleSoft Agent Fabric helps you maximize the potential of every AI agent with centralized discovery, orchestration across agents and tools, cross-ecosystem governance, and full transparency into agentic interactions. 
 
-Define your agent network in a simple, human-readable YAML file in Anypoint Code Builder. This approach abstracts away the underlying technical complexities so you focus on the business constraints and context of your process without needing to understand the inner workings of the orchestration engine.
+You define your agent network in a simple, human-readable YAML file in Anypoint Code Builder. This approach abstracts away the underlying technical complexities, allowing you to focus on the business constraints and context of your process without needing to understand the inner workings of the orchestration engine. 
 
-Don't worry, we give you a head start by providing you with a YAML template in your agent network project. MuleSoft Vibes can help you configure it for your business environment, publish agent network assets to Anypoint Exchange, and deploy your agent network instance.
+At the start of a new agent network project, we provide a YAML template to give you a head start. You can use MuleSoft Vibes to configure your network, publish the assets to Anypoint Exchange, and deploy your agent network instance.
 
-For more information about Agent Fabric, see xref:agent-fabric::index.adoc[].
+[[key-benefits]]
+== Key Benefits of Agent Networks
 
+Create robust, automated agent networks with these key benefits.
+
+* Simplified Development
++
+Define your agent processes in an intentional way using a simple YAML file, which is easier and faster than writing complex code.
+* Safety and Governance
++
+Ensure control and compliance across every agent and tool interaction with enterprise-grade governance. 
+* Observability
++
+Gain insight into agent actions with a visual trace of their decision-making. 
+* Flexibility
++
+Coordinate any type of agent and tool, regardless of where it’s built and deployed so you can build a diverse network of agents.
+* Tool and Agent Invocation
++
+Manage the invocation of both deterministic (tool-based) and probabilistic (LLM-based) actions.
+
+[[example-use-case]]
+== Example Use Case: Employee Onboarding
+
+In this example, the goal is to seamlessly activate a new hire across HR, IT, Security, and Facilities with a single, policy‑governed experience.
+
+Here’s how it works:
+
+* Discover
++
+Publish existing agents and tools (HRIS, Identity, ITSM, Payroll, Facilities, LMS) in Anypoint Exchange for reuse.
+* Orchestrate
++
+An agent broker decomposes the task of onboarding the new hire (create HR record, provision identity, assign hardware, grant app access, enroll in benefits and training), calling MCP and A2A agents as needed, with human‑in‑the‑loop approvals where required.
+* Govern
++
+Flex Gateway enforces authentication, least‑privilege access, and guardrails. API Manager policies ensure consistent controls across all calls and data exchanges.
+* Observe
++
+Monitoring and traces (beta) give end‑to‑end visibility into progress, failures, and latency. Visualization shows which agents interacted and where bottlenecks occurred.
+Reuse
++
+The onboarding definition (YAML) is versioned and shareable, enabling rapid adaptation for roles, regions, or subsidiaries without rebuilding flows.
+* Trust and Compliance
++
+Centralized credentials, audit trails, and policy inheritance support security, privacy, and regulatory requirements (PII handling, approvals, and separation of duties).
+
+With this experience, you get faster time‑to‑productivity, fewer handoffs, lower error rates, and a consistent new‑hire experience across the enterprise.
+
+[[agent-network-components]]
 == Agent Network Components
 
-Agent networks support brokers, A2A-compliant agents, and Model Context Protocol (MCP) servers.
+An agent network is a collection of agents, brokers, LLMs, and MCP servers that are connected to each other. Agent networks use LLMs for reasoning and planning capabilities and integrate with Anypoint Connector for MCP (Model Context Protocol) and Anypoint Connector for Agent2Agent (A2A) communication.
 
-Agent network::
-A collection of agents, brokers, LLMs, and MCP servers that are connected to each other.
 Broker::
 An intelligent routing service that coordinates task delegation across specialized A2A-compliant agents in your enterprise.
 A broker is defined by the agents and MCP servers it can leverage to accomplish tasks.
@@ -36,6 +82,11 @@ A service that implements the Model Context Protocol (MCP) to expose tools and d
 MCP servers can be defined either locally in the agent network or externally in a different agent network or elsewhere in your company.
 Your agent network can use both locally defined and externally defined MCP servers to complete tasks.
 
+[[agent-networks-code-builder]]
+=== Agent Networks in Anypoint Code Builder
+
+When you create agent networks, the Anypoint Code Builder canvas shows the brokers, agent, and MCP servers you've configured. 
+
 image::af-agent-network-canvas.png["Anypoint Code Builder canvas showing brokers, agents, and MCP servers"]
 
 [calloutlist]
@@ -60,6 +111,20 @@ These servers will be published to Exchange.
 The asset might also be published to Exchange.
 . An asset that has been added to this agent network project from Exchange.
 
+[[agent-network-architecture]]
+== Agent Network Architecture
+
+This diagram shows an agent network with agents and MCP servers, traffic through Flex Gateway, governed by API Manager, and observed in Anypoint Monitoring and Agent Visualizer.
+
+image::agent-fabric-architecture.png[Agent Fabric showing agents and MCP servers defined in YAML and published to Exchange, with traffic through Flex Gateway, governed by API Manager, and observed in Anypoint Monitoring and Agent Visualizer]
+
+[calloutlist]
+. Publish the agentic assets to Anypoint Exchange for discovery and reuse after you define the agent network (brokers, agents, MCP servers) in the agent network YAML in Anypoint Code Builder.
+. Deploy the agentic assets to CloudHub 2.0 (managed in Runtime Manager).
+. Enforce policies on incoming traffic to the network with an ingress Flex Gateway, which sits in front of broker and API endpoints.
+. Enforce policies, manage connections, and emit telemetry data with an egress Flex Gateway, which sits on outbound paths from brokers and agents to external agents and services.
+. Collect logs, metrics, and traces from Flex Gateway and runtimes in Anypoint Monitoring.
+
 [[llm-support]]
 == Large Language Models
 
@@ -82,7 +147,7 @@ Agent network brokers support the latest Gemini and OpenAI models.
 ** Gemini 3 Flash 
 ** Gemini 3 Pro
 
-For more information about these models, see the https://platform.openai.com/docs/models[OpenAI] and https://ai.google.dev/gemini-api/docs/models[Gemini] documentation. 
+For more information about these models, see the https://developers.openai.com/api/docs/models[OpenAI] and https://ai.google.dev/gemini-api/docs/models[Gemini] documentation. 
 
 The following table details the requirements and recommended models. 
 
@@ -108,6 +173,7 @@ a|
 
 Agent network supports text-based prompts and responses. Image and binary message types aren't supported.
 
+[[a2a-protocol]]
 == A2A Protocol 
 
 The Agent2Agent (A2A) Protocol governs agent-to-agent communication. This protocol powers orchestration, observability, and governance features in agent networks. MuleSoft supports v0.3.0 of the A2A Protocol Specification.