Merge pull request #7357 from MicrosoftDocs/main

learn-build-service-prod[bot] · web-flow · commit eb9339696f5f · 2026-05-27T19:03:20.000Z
Auto Publish – main to live - 2026-05-27 19:00 UTC
diff --git a/dev-itpro/ai/ai-development-toolkit-landing-page.yml b/dev-itpro/ai/ai-development-toolkit-landing-page.yml
@@ -87,6 +87,19 @@ landingContent:
         url: ai-development-toolkit-tasks-api.md
       - text: Convert an agent created in the UI to code
         url: ai-development-toolkit-export-import.md
+# Card
+  - title: Evaluate and test agents
+    linkLists:
+    - linkListType: how-to-guide
+      links:
+      - text: Evaluation overview
+        url: ../developer/ai-test-copilot-testtool.md
+      - text: Write agent tests
+        url: ../developer/ai-test-copilot-agent-tests.md
+      - text: Create datasets for evaluation
+        url: ../developer/ai-test-copilot-datasets.md
+      - text: Test the Copilot capability in AL
+        url: ../developer/ai-test-copilot.md
 # Card
   - title: Best practices
     linkLists:
diff --git a/dev-itpro/ai/ai-development-toolkit-overview.md b/dev-itpro/ai/ai-development-toolkit-overview.md
@@ -137,4 +137,6 @@ Ready to try design an agent? The process involves enabling the feature, creatin
 [Best practices for designing an agent (preview)](ai-development-toolkit-faq.md)  
 [Best practices (preview)](ai-development-toolkit-best-practices.md)  
 [Create a Sales Validation Agent (preview)](ai-development-toolkit-sales-validation.md)  
+[Evaluate agents with Evaluation](../developer/ai-test-copilot-testtool.md)  
+[Write agent tests](../developer/ai-test-copilot-agent-tests.md)  
 [Transparency note: Business Central AI development toolkit (preview)](transparency-note-ai-development-toolkit.md)
diff --git a/dev-itpro/developer/al-agent-tools/al-agent-tools-overview.md b/dev-itpro/developer/al-agent-tools/al-agent-tools-overview.md
@@ -19,14 +19,15 @@ AI agent tools enable GitHub Copilot and any Model Context Protocol (MCP)-compat
 > [!TIP]
 > These tools are specific to AI agents in Visual Studio Code and are different from the [ALTool command-line tool](../devenv-al-tool.md), which is used for compiling and packaging AL extensions in CI/CD pipelines.
 
-These tools are designed for two usage surfaces that share a consistent set of tool names and behaviors:
+These tools are designed for three usage surfaces:
 
 | Surface | Description | Best for |
 |---------|-------------|----------|
 | **Visual Studio Code Language Model Tools** | Tools registered with the Visual Studio Code Language Model Tools API, available to GitHub Copilot in Agent mode and any Copilot-compatible extension | Developers working interactively in Visual Studio Code |
 | **AL MCP Server** | A standalone Model Context Protocol server (`altool launchmcpserver`) that exposes AL tools over STDIO or HTTP | Headless environments, CI/CD pipelines, AI agents that run outside Visual Studio Code |
+| **AL LSP Server** | A Language Server Protocol server (`altool launchlspserver`) that provides semantic code intelligence over JSON-RPC on stdio | Agents and editors that need continuous code navigation—go-to-definition, find-references, completions, rename, and type hierarchy across multi-project workspaces |
 
-Because both surfaces use the same tool names, an agent trained on one surface can work with the other with no retraining.
+The MCP and Visual Studio Code tools share a consistent set of tool names, so an agent trained on one surface can work with the other with no retraining. The AL LSP Server complements them by providing deep semantic understanding of the codebase rather than discrete task execution. Learn more in [AL LSP](../devenv-al-tool.md#al-lsp).
 
 ## Available tools
 
@@ -119,6 +120,14 @@ Authentication tokens are never passed as tool parameters or returned in tool re
 
 To force re-authentication, set `noCache: true` on any tool that supports it, or call `al_auth_logout` first.
 
+## AL LSP for semantic code intelligence
+
+In addition to the task-oriented tools listed above, ALTool can launch a full Language Server Protocol (LSP) server via the `launchlspserver` command. While the MCP tools perform discrete actions (build, publish, search), the LSP server provides continuous semantic code intelligence—hover, go-to-definition, find-references, completions, rename, and type hierarchy—over JSON-RPC on stdio.
+
+The AL LSP server is the best choice when an agent needs to navigate and understand AL code structurally rather than perform predefined tasks. It correctly resolves cross-project relationships such as `internalsVisibleTo` and `propagateDependencies`, making it more reliable than text-based search for symbol resolution in multi-project workspaces.
+
+Learn more in [AL LSP](../devenv-al-tool.md#al-lsp).
+
 ## Related information
 
 [AL Language Model Tools for Visual Studio Code](al-language-model-tools-vscode.md)  
diff --git a/dev-itpro/developer/devenv-al-code-navigation.md b/dev-itpro/developer/devenv-al-code-navigation.md
@@ -42,3 +42,4 @@ Learn more about code navigation in Visual Studio Code in [Code navigation](http
 [JSON files](devenv-json-files.md)  
 [Debugging in AL](devenv-debugging.md)  
 [AL code actions](devenv-code-actions.md)  
+[AL LSP for AI agents and editors](devenv-al-tool.md#al-lsp)  
diff --git a/dev-itpro/developer/devenv-al-extension-configuration.md b/dev-itpro/developer/devenv-al-extension-configuration.md
@@ -67,3 +67,4 @@ The following table describes the user and workspace settings for the AL Languag
 [Debugging in AL](devenv-debugging.md)  
 [JSON files](devenv-json-files.md)  
 [Working with multiple projects and project references](devenv-work-workspace-projects-references.md)  
+[AL LSP for AI agents and editors](devenv-al-tool.md#al-lsp)  
diff --git a/dev-itpro/developer/devenv-al-tool-package.md b/dev-itpro/developer/devenv-al-tool-package.md
@@ -44,7 +44,8 @@ al help
 |--------------------------------|-------------------------------------------------------|
 | `compile`                      | Compile a package using `alc.exe`.  |
 | `workspace`                    | Workspace-related commands.  |
-| `launchmcpserver`              | Launches an AL Model Context Protocol (MCP) server. Learn more in [ALMCP](devenv-al-tool.md#almcp)  |
+| `launchmcpserver`              | Launches an AL Model Context Protocol (MCP) server. Learn more in [ALMCP](devenv-al-tool.md#almcp).  |
+| `launchlspserver`              | Launches an AL Language Server Protocol (LSP) server for autonomous AI agents and editors. Learn more in [AL LSP](devenv-al-tool.md#al-lsp).  |
 | `GetPackageManifest`           | Retrieve the manifest from a `.app` file.            |
 | `CreateSymbolPackage`          | Create a symbol-only package from a `.app` file.     |
 | `GetLatestSupportedRuntimeVersion` | Get the latest supported AL runtime version for a platform version. |
diff --git a/dev-itpro/developer/devenv-dev-overview.md b/dev-itpro/developer/devenv-dev-overview.md
@@ -92,3 +92,5 @@ After development and testing are done, you can submit your extension package to
 [Documenting your code with XML comments](devenv-xml-comments.md)  
 [FAQ for developing in AL](devenv-dev-faq.md)  
 [Sending extension telemetry to Azure Application Insights](devenv-application-insights-for-extensions.md)  
+[AI agent tools for AL development](al-agent-tools/al-agent-tools-overview.md)  
+[AL LSP for AI agents and editors](devenv-al-tool.md#al-lsp)  
diff --git a/dev-itpro/developer/devenv-dev-productivity-tips.md b/dev-itpro/developer/devenv-dev-productivity-tips.md
@@ -64,7 +64,12 @@ Hold <kbd>Alt</kbd> and click in multiple places to add cursors, allowing you to
 
 Check the **Problems** panel (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>M</kbd>) to see all warnings and errors in your workspace at a glance.
 
+## AI agent workflows
+
+For developers adopting AI agents to navigate, refactor, or build AL code, ALTool provides a headless Language Server Protocol (LSP) server that gives agents the same semantic code intelligence available in Visual Studio Code—go-to-definition, find-references, completions, and rename across multi-project workspaces. Learn more in [AL LSP](devenv-al-tool.md#al-lsp).
+
 ## Related information
 
 [JSON files](devenv-json-files.md)  
 [Launch JSON file](devenv-json-launch-file.md)  
+[AI agent tools for AL development](al-agent-tools/al-agent-tools-overview.md)  
diff --git a/dev-itpro/developer/devenv-multiroot-workspaces.md b/dev-itpro/developer/devenv-multiroot-workspaces.md
@@ -43,3 +43,4 @@ The `al.packageCachePath` setting allows you to specify the path to a folder tha
 [Development in AL](devenv-dev-overview.md)  
 [Best Practices for AL](../compliance/apptest-bestpracticesforalcode.md)  
 [Working with Multiple Projects and Project References](devenv-work-workspace-projects-references.md)  
+[AL LSP for cross-project semantic navigation](devenv-al-tool.md#al-lsp)  
