From b89b185a4bb8eb6c239cbef56939921dfd2e99a6 Mon Sep 17 00:00:00 2001 From: KB Bot Date: Thu, 13 Nov 2025 10:34:44 +0000 Subject: [PATCH 1/3] Added new kb article ai-client-integration-telerik-reporting --- ...ai-client-integration-telerik-reporting.md | 81 +++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 knowledge-base/ai-client-integration-telerik-reporting.md diff --git a/knowledge-base/ai-client-integration-telerik-reporting.md b/knowledge-base/ai-client-integration-telerik-reporting.md new file mode 100644 index 000000000..4aa0e6e1f --- /dev/null +++ b/knowledge-base/ai-client-integration-telerik-reporting.md @@ -0,0 +1,81 @@ +--- +title: Resolving Issues with AI-Powered Insights Integration in Telerik Reporting +description: Troubleshoot problems with integrating the built-in AI Client for AI-Powered Insights in Telerik Reporting, including handling assembly binding redirects and first-chance exceptions. +type: troubleshooting +page_title: AI Client Integration Troubleshooting in Telerik Reporting +meta_title: AI Client Integration Troubleshooting in Telerik Reporting +slug: ai-client-integration-telerik-reporting +tags: reporting, ai-client, integration, binding-redirects, system, troubleshooting +res_type: kb +ticketid: 1703027 +--- + +## Environment + + + + + + + + + + + +
ProductTelerik Reporting
target framework.NET Framework 4.6.2+
+ +## Description + +I want to use the built-in AI Client in Telerik Reporting. After configuring the `` element in the `web.config` file, the AI client is not functioning as expected. + +## Cause + +The issue may be related to assembly binding conflicts in the .NET Framework project. First-chance exceptions occur due to mismatched assembly versions or missing assemblies in the Global Assembly Cache (GAC). Visual Studio may fail to add the required binding redirects automatically, causing runtime errors. + +## Solution + +To resolve the issue, follow these steps: + +1. Ensure the `` element includes the `Telerik.Reporting` section at the top of the `web.config` file: + + ````xml + + +
+ + + ```` + +1. Verify that the NuGet package `Telerik.Reporting.AI.Microsoft.Extensions.OpenAI` is referenced in your project. This package includes dependencies for the built-in AI Client. + +1. Add or update binding redirects for conflicting assemblies in the `web.config`: + + ````xml + + + + + + + + + + + + + ```` + +1. Enable first-chance exceptions in Visual Studio to identify specific assembly loading issues during runtime. Refer to [Understanding Exceptions while debugging with Visual Studio](https://devblogs.microsoft.com/devops/understanding-exceptions-while-debugging-with-visual-studio/) for instructions. + +1. Check the versions of the required assemblies installed in the GAC. Ensure that the binding redirects match the versions loaded in your project. If a redirected version does not exist in the GAC, either update the binding redirect or remove it. + +1. Debug the project, and observe the first-chance exceptions. Continue adjusting the binding redirects or removing them until the exceptions are resolved. + +1. Compare your project with a working example. Use the linked muted video and reference project shared by the support team for troubleshooting. + +## See Also + +- [Using AI-Powered Insights with a REST Service](https://docs.telerik.com/reporting/interactivity/built-in-client-integration-ai-insights#using-ai-powered-insights-with-a-rest-service) +- [Understanding Exceptions while debugging with Visual Studio](https://devblogs.microsoft.com/devops/understanding-exceptions-while-debugging-with-visual-studio/) From 9a2f524dd717e3f2832fc2ff917b0d8d1aa427aa Mon Sep 17 00:00:00 2001 From: Todor Arabadzhiev Date: Thu, 13 Nov 2025 13:16:06 +0200 Subject: [PATCH 2/3] Update ai-client-integration-telerik-reporting.md --- ...ai-client-integration-telerik-reporting.md | 106 +++++++++++------- 1 file changed, 64 insertions(+), 42 deletions(-) diff --git a/knowledge-base/ai-client-integration-telerik-reporting.md b/knowledge-base/ai-client-integration-telerik-reporting.md index 4aa0e6e1f..1c11bf1bd 100644 --- a/knowledge-base/ai-client-integration-telerik-reporting.md +++ b/knowledge-base/ai-client-integration-telerik-reporting.md @@ -1,16 +1,17 @@ --- -title: Resolving Issues with AI-Powered Insights Integration in Telerik Reporting -description: Troubleshoot problems with integrating the built-in AI Client for AI-Powered Insights in Telerik Reporting, including handling assembly binding redirects and first-chance exceptions. +title: Resolving Issues with AI-Powered Insights Integration in .NET Framework +description: Troubleshoot problems with integrating the built-in AI Client for AI-Powered Insights in Telerik Reporting for .NET Framework, including handling assembly binding redirects and first-chance exceptions. type: troubleshooting -page_title: AI Client Integration Troubleshooting in Telerik Reporting -meta_title: AI Client Integration Troubleshooting in Telerik Reporting -slug: ai-client-integration-telerik-reporting +page_title: AI Client Integration Troubleshooting in .NET Framework +meta_title: AI Client Integration Troubleshooting in .NET Framework +slug: troubleshoot-ai-client-integration-net-framework tags: reporting, ai-client, integration, binding-redirects, system, troubleshooting res_type: kb ticketid: 1703027 --- ## Environment + @@ -26,56 +27,77 @@ ticketid: 1703027 ## Description -I want to use the built-in AI Client in Telerik Reporting. After configuring the `` element in the `web.config` file, the AI client is not functioning as expected. +I want to use the built-in _MicrosoftExtensionsOpenAI_ AI Client in Telerik Reporting as explained in the article [Using AI-Powered Insights with a REST Service]({%slug telerikreporting/designing-reports/adding-interactivity-to-reports/ai-powered-insights-builtin-client%}). -## Cause +After configuring the `` element in the `web.config` file and adding the required dependencies as NuGet packages, the AI client is not functioning as expected. -The issue may be related to assembly binding conflicts in the .NET Framework project. First-chance exceptions occur due to mismatched assembly versions or missing assemblies in the Global Assembly Cache (GAC). Visual Studio may fail to add the required binding redirects automatically, causing runtime errors. +* I ensured the `` element includes the `Telerik.Reporting` section at the top of the `web.config` file: -## Solution + ````XML + + +
+ + + + + + +```` + + +* I ensured the following packages are referenced in my Reporting project: -To resolve the issue, follow these steps: + - Telerik.Reporting.AI.Microsoft.Extensions.OpenAI + - Telerik.Reporting.AI.Microsoft.Extensions.Abstractions + - Microsoft.Extensions.AI.OpenAI + - Microsoft.Extensions.AI.Abstractions + - OpenAI -1. Ensure the `` element includes the `Telerik.Reporting` section at the top of the `web.config` file: +## Cause + +The issue may be related to assembly binding conflicts in the .NET Framework project. The NuGet Package Manager of Visual Studio may fail to add the required binding redirects automatically when you use NuGet packages in the .NET Framework projects, causing runtime errors. + +## Solution - ````xml - - -
- - - ```` +Here are the suggested approaches for troubleshooting: -1. Verify that the NuGet package `Telerik.Reporting.AI.Microsoft.Extensions.OpenAI` is referenced in your project. This package includes dependencies for the built-in AI Client. +*. Attach a [Trace Listener](https://learn.microsoft.com/en-us/dotnet/framework/debug-trace-profile/how-to-create-and-initialize-trace-listeners) to the project hosting the Reporting Engine. Fix the AI-related errors if any. -1. Add or update binding redirects for conflicting assemblies in the `web.config`: +The Telerik Reporting code handles some of the errors, and they may not appear in the trace log. The errors handled in the code appear as First-chance exceptions in the Visual Studio output. Such errors may occur due to mismatched assembly versions or missing assemblies in the Global Assembly Cache (GAC). - ````xml - - - - - - - - - - - - - ```` +* Enable first-chance exceptions in Visual Studio to identify specific assembly loading issues during runtime. Refer to [Understanding Exceptions while debugging with Visual Studio](https://devblogs.microsoft.com/devops/understanding-exceptions-while-debugging-with-visual-studio/) for instructions. -1. Enable first-chance exceptions in Visual Studio to identify specific assembly loading issues during runtime. Refer to [Understanding Exceptions while debugging with Visual Studio](https://devblogs.microsoft.com/devops/understanding-exceptions-while-debugging-with-visual-studio/) for instructions. + If you see errors related to Visual Studio not being able to load specific assembly versions: + - Find out which version is installed in your project or in the GAC. It must be equal or greater than the required one. + - Add or update binding-redirects for conflicting assemblies in the `web.config`. Here is an example with assemblies binding-redirects I had to add to my ASP.NET MVC project to get the _MicrosoftExtensionsOpenAI_ AI Client work. In the general case, they may be different for your project: -1. Check the versions of the required assemblies installed in the GAC. Ensure that the binding redirects match the versions loaded in your project. If a redirected version does not exist in the GAC, either update the binding redirect or remove it. + ````XML + + + + + + + + + + + + +```` -1. Debug the project, and observe the first-chance exceptions. Continue adjusting the binding redirects or removing them until the exceptions are resolved. -1. Compare your project with a working example. Use the linked muted video and reference project shared by the support team for troubleshooting. + Continue adjusting the binding-redirects or removing them until the exceptions are resolved. ## See Also -- [Using AI-Powered Insights with a REST Service](https://docs.telerik.com/reporting/interactivity/built-in-client-integration-ai-insights#using-ai-powered-insights-with-a-rest-service) -- [Understanding Exceptions while debugging with Visual Studio](https://devblogs.microsoft.com/devops/understanding-exceptions-while-debugging-with-visual-studio/) +* [Using AI-Powered Insights with a REST Service]({%slug telerikreporting/designing-reports/adding-interactivity-to-reports/ai-powered-insights-builtin-client%}) +* [Understanding Exceptions while debugging with Visual Studio](https://devblogs.microsoft.com/devops/understanding-exceptions-while-debugging-with-visual-studio/) From d358916429672629727a25294b69e2aec22d7a72 Mon Sep 17 00:00:00 2001 From: Todor Arabadzhiev Date: Thu, 13 Nov 2025 13:22:50 +0200 Subject: [PATCH 3/3] Update ai-client-integration-telerik-reporting.md --- knowledge-base/ai-client-integration-telerik-reporting.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/knowledge-base/ai-client-integration-telerik-reporting.md b/knowledge-base/ai-client-integration-telerik-reporting.md index 1c11bf1bd..776f2df25 100644 --- a/knowledge-base/ai-client-integration-telerik-reporting.md +++ b/knowledge-base/ai-client-integration-telerik-reporting.md @@ -53,7 +53,7 @@ After configuring the `` element in the `web.config` file and adding t ```` -* I ensured the following packages are referenced in my Reporting project: +* I ensured the following packages are referenced in my Reporting project with the correct versions: - Telerik.Reporting.AI.Microsoft.Extensions.OpenAI - Telerik.Reporting.AI.Microsoft.Extensions.Abstractions @@ -63,13 +63,13 @@ After configuring the `` element in the `web.config` file and adding t ## Cause -The issue may be related to assembly binding conflicts in the .NET Framework project. The NuGet Package Manager of Visual Studio may fail to add the required binding redirects automatically when you use NuGet packages in the .NET Framework projects, causing runtime errors. +The issue may be related to assembly binding conflicts in the .NET Framework project. The above packages have inner dependencies that would be added by the NuGet Package Manager of Visual Studio automatically to the project. The package manager may fail to add the required binding-redirects when you use NuGet packages in the .NET Framework projects, causing runtime errors. ## Solution Here are the suggested approaches for troubleshooting: -*. Attach a [Trace Listener](https://learn.microsoft.com/en-us/dotnet/framework/debug-trace-profile/how-to-create-and-initialize-trace-listeners) to the project hosting the Reporting Engine. Fix the AI-related errors if any. +* Attach a [Trace Listener](https://learn.microsoft.com/en-us/dotnet/framework/debug-trace-profile/how-to-create-and-initialize-trace-listeners) to the project hosting the Reporting Engine. Fix the AI-related errors if any. The Telerik Reporting code handles some of the errors, and they may not appear in the trace log. The errors handled in the code appear as First-chance exceptions in the Visual Studio output. Such errors may occur due to mismatched assembly versions or missing assemblies in the Global Assembly Cache (GAC).