Update microsoft-discovery docs: fix index.yml links, fix REST API URL, fix broken tool concept links in service architecture overview

Author: Mukesh Dua

articles/microsoft-discovery/index.yml

@@ -56,6 +56,8 @@ landingContent:
             url: how-to-select-models-for-agents.md
           - text: Write effective prompts for agents
             url: how-to-prompt-engineering.md
+          - text: Data handling with tools and agents
+            url: how-to-data-handling-with-tools-agents.md
 
   - title: Discovery Engine
     linkLists:
@@ -84,10 +86,10 @@ landingContent:
             url: concept-storage-containers-assets.md
       - linkListType: how-to-guide
         links:
-          - text: Data handling with tools and agents
-            url: how-to-data-handling-with-tools-agents.md
           - text: Manage storage containers
             url: how-to-manage-storage-containers.md
+          - text: Create and index a Bookshelf Knowledge Base
+            url: how-to-create-index-bookshelf-knowledgebase.md
 
   - title: Security and compliance
     linkLists:

articles/microsoft-discovery/overview-service-architecture.md

@@ -84,7 +84,7 @@ Tools allow agents to perform specific, repeatable operations such as running si
 - **Code-environment based tools** - enable agents to dynamically generate and execute code
 - **Hybrid tools** - combine both approaches for flexible, AI-generated execution within structured environments
 
-Tool definitions are scoped to a subscription and can be shared across projects. For details, see [Discovery Tool concepts](concept-discovery-tools.md).
+Tool definitions are scoped to a subscription and can be shared across projects. For details, see [Discovery Tool concepts](concept-tools-model-integration.md).
 
 ### Chat Model
 
@@ -129,5 +129,5 @@ For details, see [Bookshelf & Knowledge Bases](concept-bookshelf-knowledge-bases
 - [What is Microsoft Discovery?](overview-what-is-microsoft-discovery.md)
 - [Quickstart: Deploy infrastructure using Azure portal](quickstart-infrastructure-portal.md)
 - [Projects and investigations](concept-projects-investigations.md)
-- [Discovery Tool concepts](concept-discovery-tools.md)
+- [Discovery Tool concepts](concept-tools-model-integration.md)
 - [Bookshelf & Knowledge Bases](concept-bookshelf-knowledge-bases.md)

articles/microsoft-discovery/toc.yml

@@ -163,16 +163,14 @@ items:
           - name: Data handling with tools and agents
             href: how-to-data-handling-with-tools-agents.md
             displayName: Microsoft Discovery, data handling, tools, agents, virtual paths, data assets, mounts, promotion
-
       - name: Data & Knowledge
         items:
-          - name: Create Bookshelf and index a Knowledgebase
-            href: how-to-create-index-bookshelf-knowledgebase.md
-            displayName: Microsoft Discovery, bookshelf, knowledgebase, indexing, LazyGraphRAG, storage, blob, managed identity
           - name: Manage storage containers
             href: how-to-manage-storage-containers.md
             displayName: Microsoft Discovery, storage containers, storage assets, blob storage, data ingestion
-
+          - name: Create Bookshelf and index a Knowledgebase
+            href: how-to-create-index-bookshelf-knowledgebase.md
+            displayName: Microsoft Discovery, bookshelf, knowledgebase, indexing, LazyGraphRAG, storage, blob, managed identity
       - name: Network Security & Data Protection
         items:
           - name: Configure network security
@@ -184,7 +182,6 @@ items:
           - name: Configure customer-managed keys
             href: howto-data-encryption-at-rest.md
             displayName: Microsoft Discovery, customer-managed keys, CMK, encryption at rest, Key Vault
-
       - name: Investigations & Discovery Mode
         items:
           - name: Build investigations with cognition