[
{
"path": ".config/dotnet-tools.json",
"content": "{\n \"version\": 1,\n \"isRoot\": true,\n \"tools\": {\n \"microsoft.extensions.ai.evaluation.console\": {\n \"version\": \"9.3.0-preview.1.25126.9\",\n \"commands\": [\n \"aieval\"\n ],\n \"rollForward\": false\n }\n }\n}"
},
{
"path": ".editorconfig",
"content": "###############################\n# Core EditorConfig Options #\n###############################\nroot = true\n# All files\n[*]\nindent_style = space\n\n# XML project files\n[*.{csproj,vbproj,vcxproj,vcxproj.filters,proj,projitems,shproj}]\nindent_size = 2\n\n# XML config files\n[*.{props,targets,ruleset,config,nuspec,resx,vsixmanifest,vsct}]\nindent_size = 2\n\n# Code files\n[*.{cs,csx,vb,vbx}]\nindent_size = 4\ninsert_final_newline = true\ncharset = utf-8-bom\n###############################\n# .NET Coding Conventions #\n###############################\n[*.{cs,vb}]\n# Organize usings\ndotnet_sort_system_directives_first = true\n# this. preferences\ndotnet_style_qualification_for_field = false:silent\ndotnet_style_qualification_for_property = false:silent\ndotnet_style_qualification_for_method = false:silent\ndotnet_style_qualification_for_event = false:silent\n# Language keywords vs BCL types preferences\ndotnet_style_predefined_type_for_locals_parameters_members = true:silent\ndotnet_style_predefined_type_for_member_access = true:silent\n# Parentheses preferences\ndotnet_style_parentheses_in_arithmetic_binary_operators = always_for_clarity:silent\ndotnet_style_parentheses_in_relational_binary_operators = always_for_clarity:silent\ndotnet_style_parentheses_in_other_binary_operators = always_for_clarity:silent\ndotnet_style_parentheses_in_other_operators = never_if_unnecessary:silent\n# Modifier preferences\ndotnet_style_require_accessibility_modifiers = for_non_interface_members:silent\ndotnet_style_readonly_field = true:suggestion\n# Expression-level preferences\ndotnet_style_object_initializer = true:suggestion\ndotnet_style_collection_initializer = true:suggestion\ndotnet_style_explicit_tuple_names = true:suggestion\ndotnet_style_null_propagation = true:suggestion\ndotnet_style_coalesce_expression = true:suggestion\ndotnet_style_prefer_is_null_check_over_reference_equality_method = true:silent\ndotnet_style_prefer_inferred_tuple_names = true:suggestion\ndotnet_style_prefer_inferred_anonymous_type_member_names = true:suggestion\ndotnet_style_prefer_auto_properties = true:silent\ndotnet_style_prefer_conditional_expression_over_assignment = true:silent\ndotnet_style_prefer_conditional_expression_over_return = true:silent\n###############################\n# Naming Conventions #\n###############################\n# Style Definitions\ndotnet_naming_style.pascal_case_style.capitalization = pascal_case\n# Use PascalCase for constant fields\ndotnet_naming_rule.constant_fields_should_be_pascal_case.severity = suggestion\ndotnet_naming_rule.constant_fields_should_be_pascal_case.symbols = constant_fields\ndotnet_naming_rule.constant_fields_should_be_pascal_case.style = pascal_case_style\ndotnet_naming_symbols.constant_fields.applicable_kinds = field\ndotnet_naming_symbols.constant_fields.applicable_accessibilities = *\ndotnet_naming_symbols.constant_fields.required_modifiers = const\n###############################\n# C# Coding Conventions #\n###############################\n[*.cs]\n# var preferences\ncsharp_style_var_for_built_in_types = true:silent\ncsharp_style_var_when_type_is_apparent = true:silent\ncsharp_style_var_elsewhere = true:silent\n# Expression-bodied members\ncsharp_style_expression_bodied_methods = false:silent\ncsharp_style_expression_bodied_constructors = false:silent\ncsharp_style_expression_bodied_operators = false:silent\ncsharp_style_expression_bodied_properties = true:silent\ncsharp_style_expression_bodied_indexers = true:silent\ncsharp_style_expression_bodied_accessors = true:silent\n# Pattern matching preferences\ncsharp_style_pattern_matching_over_is_with_cast_check = true:suggestion\ncsharp_style_pattern_matching_over_as_with_null_check = true:suggestion\n# Null-checking preferences\ncsharp_style_throw_expression = true:suggestion\ncsharp_style_conditional_delegate_call = true:suggestion\n# Modifier preferences\ncsharp_preferred_modifier_order = public,private,protected,internal,static,extern,new,virtual,abstract,sealed,override,readonly,unsafe,volatile,async:suggestion\n# Expression-level preferences\ncsharp_prefer_braces = true:silent\ncsharp_style_deconstructed_variable_declaration = true:suggestion\ncsharp_prefer_simple_default_expression = true:suggestion\ncsharp_style_prefer_local_over_anonymous_function = true:suggestion\ncsharp_style_inlined_variable_declaration = true:suggestion\n###############################\n# C# Formatting Rules #\n###############################\n# New line preferences\ncsharp_new_line_before_open_brace = all\ncsharp_new_line_before_else = true\ncsharp_new_line_before_catch = true\ncsharp_new_line_before_finally = true\ncsharp_new_line_before_members_in_object_initializers = true\ncsharp_new_line_before_members_in_anonymous_types = true\ncsharp_new_line_between_query_expression_clauses = true\n# Indentation preferences\ncsharp_indent_case_contents = true\ncsharp_indent_switch_labels = true\ncsharp_indent_labels = flush_left\n# Space preferences\ncsharp_space_after_cast = false\ncsharp_space_after_keywords_in_control_flow_statements = true\ncsharp_space_between_method_call_parameter_list_parentheses = false\ncsharp_space_between_method_declaration_parameter_list_parentheses = false\ncsharp_space_between_parentheses = false\ncsharp_space_before_colon_in_inheritance_clause = true\ncsharp_space_after_colon_in_inheritance_clause = true\ncsharp_space_around_binary_operators = before_and_after\ncsharp_space_between_method_declaration_empty_parameter_list_parentheses = false\ncsharp_space_between_method_call_name_and_opening_parenthesis = false\ncsharp_space_between_method_call_empty_parameter_list_parentheses = false\n# Wrapping preferences\ncsharp_preserve_single_line_statements = true\ncsharp_preserve_single_line_blocks = true\n###############################\n# VB Coding Conventions #\n###############################\n[*.vb]\n# Modifier preferences\nvisual_basic_preferred_modifier_order = Partial,Default,Private,Protected,Public,Friend,NotOverridable,Overridable,MustOverride,Overloads,Overrides,MustInherit,NotInheritable,Static,Shared,Shadows,ReadOnly,WriteOnly,Dim,Const,WithEvents,Widening,Narrowing,Custom,Async:suggestion"
},
{
"path": ".gitignore",
"content": "## Ignore Visual Studio temporary files, build results, and\n## files generated by popular Visual Studio add-ons.\n##\n## Get latest from https://github.com/github/gitignore/blob/main/VisualStudio.gitignore\n\n# User-specific files\n*.rsuser\n*.suo\n*.user\n*.userosscache\n*.sln.docstates\n\n# User-specific files (MonoDevelop/Xamarin Studio)\n*.userprefs\n\n# Mono auto generated files\nmono_crash.*\n\n# Build results\n[Dd]ebug/\n[Dd]ebugPublic/\n[Rr]elease/\n[Rr]eleases/\nx64/\nx86/\n[Ww][Ii][Nn]32/\n[Aa][Rr][Mm]/\n[Aa][Rr][Mm]64/\nbld/\n[Bb]in/\n[Oo]bj/\n[Ll]og/\n[Ll]ogs/\n\n# Visual Studio 2015/2017 cache/options directory\n.vs/\n# Uncomment if you have tasks that create the project's static files in wwwroot\n#wwwroot/\n\n# Visual Studio 2017 auto generated files\nGenerated\\ Files/\n\n# MSTest test Results\n[Tt]est[Rr]esult*/\n[Bb]uild[Ll]og.*\n\n# NUnit\n*.VisualState.xml\nTestResult.xml\nnunit-*.xml\n\n# Build Results of an ATL Project\n[Dd]ebugPS/\n[Rr]eleasePS/\ndlldata.c\n\n# Benchmark Results\nBenchmarkDotNet.Artifacts/\n\n# .NET Core\nproject.lock.json\nproject.fragment.lock.json\nartifacts/\n\n# ASP.NET Scaffolding\nScaffoldingReadMe.txt\n\n# StyleCop\nStyleCopReport.xml\n\n# Files built by Visual Studio\n*_i.c\n*_p.c\n*_h.h\n*.ilk\n*.meta\n*.obj\n*.iobj\n*.pch\n*.pdb\n*.ipdb\n*.pgc\n*.pgd\n*.rsp\n*.sbr\n*.tlb\n*.tli\n*.tlh\n*.tmp\n*.tmp_proj\n*_wpftmp.csproj\n*.log\n*.tlog\n*.vspscc\n*.vssscc\n.builds\n*.pidb\n*.svclog\n*.scc\n\n# Chutzpah Test files\n_Chutzpah*\n\n# Visual C++ cache files\nipch/\n*.aps\n*.ncb\n*.opendb\n*.opensdf\n*.sdf\n*.cachefile\n*.VC.db\n*.VC.VC.opendb\n\n# Visual Studio profiler\n*.psess\n*.vsp\n*.vspx\n*.sap\n\n# Visual Studio Trace Files\n*.e2e\n\n# TFS 2012 Local Workspace\n$tf/\n\n# Guidance Automation Toolkit\n*.gpState\n\n# ReSharper is a .NET coding add-in\n_ReSharper*/\n*.[Rr]e[Ss]harper\n*.DotSettings.user\n\n# TeamCity is a build add-in\n_TeamCity*\n\n# DotCover is a Code Coverage Tool\n*.dotCover\n\n# AxoCover is a Code Coverage Tool\n.axoCover/*\n!.axoCover/settings.json\n\n# Coverlet is a free, cross platform Code Coverage Tool\ncoverage*.json\ncoverage*.xml\ncoverage*.info\n\n# Visual Studio code coverage results\n*.coverage\n*.coveragexml\n\n# NCrunch\n_NCrunch_*\n.*crunch*.local.xml\nnCrunchTemp_*\n\n# MightyMoose\n*.mm.*\nAutoTest.Net/\n\n# Web workbench (sass)\n.sass-cache/\n\n# Installshield output folder\n[Ee]xpress/\n\n# DocProject is a documentation generator add-in\nDocProject/buildhelp/\nDocProject/Help/*.HxT\nDocProject/Help/*.HxC\nDocProject/Help/*.hhc\nDocProject/Help/*.hhk\nDocProject/Help/*.hhp\nDocProject/Help/Html2\nDocProject/Help/html\n\n# Click-Once directory\npublish/\n\n# Publish Web Output\n*.[Pp]ublish.xml\n*.azurePubxml\n# Note: Comment the next line if you want to checkin your web deploy settings,\n# but database connection strings (with potential passwords) will be unencrypted\n*.pubxml\n*.publishproj\n\n# Microsoft Azure Web App publish settings. Comment the next line if you want to\n# checkin your Azure Web App publish settings, but sensitive information contained\n# in these scripts will be unencrypted\nPublishScripts/\n\n# NuGet Packages\n*.nupkg\n# NuGet Symbol Packages\n*.snupkg\n# The packages folder can be ignored because of Package Restore\n**/[Pp]ackages/*\n# except build/, which is used as an MSBuild target.\n!**/[Pp]ackages/build/\n# Uncomment if necessary however generally it will be regenerated when needed\n#!**/[Pp]ackages/repositories.config\n# NuGet v3's project.json files produces more ignorable files\n*.nuget.props\n*.nuget.targets\n\n# Microsoft Azure Build Output\ncsx/\n*.build.csdef\n\n# Microsoft Azure Emulator\necf/\nrcf/\n\n# Windows Store app package directories and files\nAppPackages/\nBundleArtifacts/\nPackage.StoreAssociation.xml\n_pkginfo.txt\n*.appx\n*.appxbundle\n*.appxupload\n\n# Visual Studio cache files\n# files ending in .cache can be ignored\n*.[Cc]ache\n# but keep track of directories ending in .cache\n!?*.[Cc]ache/\n\n# Others\nClientBin/\n~$*\n*~\n*.dbmdl\n*.dbproj.schemaview\n*.jfm\n*.pfx\n*.publishsettings\norleans.codegen.cs\n\n# Including strong name files can present a security risk\n# (https://github.com/github/gitignore/pull/2483#issue-259490424)\n#*.snk\n\n# Since there are multiple workflows, uncomment next line to ignore bower_components\n# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)\n#bower_components/\n\n# RIA/Silverlight projects\nGenerated_Code/\n\n# Backup & report files from converting an old project file\n# to a newer Visual Studio version. Backup files are not needed,\n# because we have git ;-)\n_UpgradeReport_Files/\nBackup*/\nUpgradeLog*.XML\nUpgradeLog*.htm\nServiceFabricBackup/\n*.rptproj.bak\n\n# SQL Server files\n*.mdf\n*.ldf\n*.ndf\n\n# Business Intelligence projects\n*.rdl.data\n*.bim.layout\n*.bim_*.settings\n*.rptproj.rsuser\n*- [Bb]ackup.rdl\n*- [Bb]ackup ([0-9]).rdl\n*- [Bb]ackup ([0-9][0-9]).rdl\n\n# Microsoft Fakes\nFakesAssemblies/\n\n# GhostDoc plugin setting file\n*.GhostDoc.xml\n\n# Node.js Tools for Visual Studio\n.ntvs_analysis.dat\nnode_modules/\n\n# Visual Studio 6 build log\n*.plg\n\n# Visual Studio 6 workspace options file\n*.opt\n\n# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)\n*.vbw\n\n# Visual Studio 6 auto-generated project file (contains which files were open etc.)\n*.vbp\n\n# Visual Studio 6 workspace and project file (working project files containing files to include in project)\n*.dsw\n*.dsp\n\n# Visual Studio 6 technical files\n*.ncb\n*.aps\n\n# Visual Studio LightSwitch build output\n**/*.HTMLClient/GeneratedArtifacts\n**/*.DesktopClient/GeneratedArtifacts\n**/*.DesktopClient/ModelManifest.xml\n**/*.Server/GeneratedArtifacts\n**/*.Server/ModelManifest.xml\n_Pvt_Extensions\n\n# Paket dependency manager\n.paket/paket.exe\npaket-files/\n\n# FAKE - F# Make\n.fake/\n\n# CodeRush personal settings\n.cr/personal\n\n# Python Tools for Visual Studio (PTVS)\n__pycache__/\n*.pyc\n\n# Cake - Uncomment if you are using it\n# tools/**\n# !tools/packages.config\n\n# Tabs Studio\n*.tss\n\n# Telerik's JustMock configuration file\n*.jmconfig\n\n# BizTalk build output\n*.btp.cs\n*.btm.cs\n*.odx.cs\n*.xsd.cs\n\n# OpenCover UI analysis results\nOpenCover/\n\n# Azure Stream Analytics local run output\nASALocalRun/\n\n# MSBuild Binary and Structured Log\n*.binlog\n\n# NVidia Nsight GPU debugger configuration file\n*.nvuser\n\n# MFractors (Xamarin productivity tool) working folder\n.mfractor/\n\n# Local History for Visual Studio\n.localhistory/\n\n# Visual Studio History (VSHistory) files\n.vshistory/\n\n# BeatPulse healthcheck temp database\nhealthchecksdb\n\n# Backup folder for Package Reference Convert tool in Visual Studio 2017\nMigrationBackup/\n\n# Ionide (cross platform F# VS Code tools) working folder\n.ionide/\n\n# Fody - auto-generated XML schema\nFodyWeavers.xsd\n\n# VS Code files for those working on multiple tools\n.vscode/*\n!.vscode/settings.json\n!.vscode/tasks.json\n!.vscode/launch.json\n!.vscode/extensions.json\n*.code-workspace\n\n# Local History for Visual Studio Code\n.history/\n\n# Windows Installer files from build outputs\n*.cab\n*.msi\n*.msix\n*.msm\n*.msp\n\n# JetBrains Rider\n*.sln.iml\n"
},
{
"path": "CODE_OF_CONDUCT.md",
"content": "# Microsoft Open Source Code of Conduct\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\n\nResources:\n\n- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)\n- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)\n- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns\n"
},
{
"path": "Directory.Build.props",
"content": "\n\n \n true\n enable\n \n\n\n"
},
{
"path": "Directory.Packages.props",
"content": "\n \n true\n true\n 8.6.0\n 8.2.2\n 9.4.4-preview.1.25259.16\n 9.4.4-preview.1.25259.16\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "LICENSE",
"content": " MIT License\n\n Copyright (c) .NET Foundation. All rights reserved.\n\n Permission is hereby granted, free of charge, to any person obtaining a copy\n of this software and associated documentation files (the \"Software\"), to deal\n in the Software without restriction, including without limitation the rights\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n copies of the Software, and to permit persons to whom the Software is\n furnished to do so, subject to the following conditions:\n\n The above copyright notice and this permission notice shall be included in all\n copies or substantial portions of the Software.\n\n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n SOFTWARE\n"
},
{
"path": "README.md",
"content": "# eShopSupport \n\nA sample .NET application showcasing common use cases and development practices for build AI solutions in .NET (Generative AI, specifically). This sample demonstrates a customer support application for an e-commerce website using a services-based architecture with .NET Aspire. It includes support for the following AI use cases:\n\n* Text classification, applying labels based on content\n* Sentiment analysis based on message content\n* Summarization of large sets of text\n* Synthetic data generation, creating test content for the sample\n* Chat bot interactions with chat history and suggested responses\n\n\n\n\n\nThis sample also demonstrates the following development practices:\n\n* Developing a solution locally, using small local models\n* Evaluating the quality of AI responses using grounded Q&A data\n* Leveraging Python projects as part of a .NET Aspire solution\n* Deploying the application, including small local models, to the Cloud (coming soon)\n\n## Architecture\n\n\n\n## Getting Started\n\n### Prerequisites\n\n- A device with an Nvidia GPU (see [workaround for running on the CPU](https://github.com/dotnet/eShopSupport/issues/19))\n- Clone the eShopSupport repository: https://github.com/dotnet/eshopsupport\n- [Install & start Docker Desktop](https://docs.docker.com/engine/install/)\n- [Install Python 3.12.5](https://www.python.org/downloads/release/python-3125/)\n\n#### Windows with Visual Studio\n- Install [Visual Studio 2022 version 17.10 or newer](https://visualstudio.microsoft.com/vs/)\n - Select the following workloads:\n - `ASP.NET and web development` workload.\n - `Python Development` workload.\n - `.NET Aspire SDK` component in `Individual components`.\n\n#### Mac, Linux, & Windows without Visual Studio\n- Install the latest [.NET 8 SDK](https://dot.net/download?cid=eshop)\n- Install the [.NET Aspire workload](https://learn.microsoft.com/dotnet/aspire/fundamentals/setup-tooling?tabs=dotnet-cli%2Cunix#install-net-aspire) with the following commands:\n\n ```powershell\n dotnet workload update\n dotnet workload install aspire\n dotnet restore eShopSupport.sln\n ```\n- (Optionally) Install [Visual Studio Code](https://code.visualstudio.com) with the [C# Dev Kit extension](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit)\n\n#### Install Python requirements\n\nFrom the Terminal, at the root of the cloned repo, run:\n\n```powershell\npip install -r src/PythonInference/requirements.txt\n```\n\n**Note:** If the above command doesn't work on Windows, use the following command:\n\n```powershell\npy -m pip install -r src/PythonInference/requirements.txt\n```\n\n### Running the solution\n\n> [!WARNING]\n> Remember to ensure that Docker is started.\n\n* (Windows only) Run the application from Visual Studio:\n - Open the `eShopSupport.sln` file in Visual Studio\n - Ensure that `AppHost` is your startup project\n - Hit Ctrl-F5 to launch .NET Aspire\n\n* Or run the application from your terminal:\n\n ```powershell\n dotnet run --project src/AppHost\n ```\n\n then look for lines like this in the console output in order to find the URL to open the Aspire dashboard:\n\n ```sh\n Login to the dashboard at: http://localhost:17191/login?t=uniquelogincodeforyou\n ```\n\n> You may need to install ASP.NET Core HTTPS development certificates first, and then close all browser tabs. Learn more at https://aka.ms/aspnet/https-trust-dev-cert\n\n# Contributing\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n# Sample data\n\nThe sample data is defined in [seeddata](https://github.com/dotnet/eShopSupport/tree/main/seeddata). All products/descriptions/brands, manuals, customers, and support tickets names are fictional and were generated using [GPT-35-Turbo](https://learn.microsoft.com/en-us/azure/ai-services/openai/how-to/chatgpt) using the included [DataGenerator](https://github.com/dotnet/eShopSupport/tree/main/seeddata/DataGenerator) project.\n"
},
{
"path": "SECURITY.md",
"content": "\n\n## Security\n\nMicrosoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet) and [Xamarin](https://github.com/xamarin).\n\nIf you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/security.md/definition), please report it to us as described below.\n\n## Reporting Security Issues\n\n**Please do not report security vulnerabilities through public GitHub issues.**\n\nInstead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/security.md/msrc/create-report).\n\nIf you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com). If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/security.md/msrc/pgp).\n\nYou should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://www.microsoft.com/msrc). \n\nPlease include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:\n\n * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)\n * Full paths of source file(s) related to the manifestation of the issue\n * The location of the affected source code (tag/branch/commit or direct URL)\n * Any special configuration required to reproduce the issue\n * Step-by-step instructions to reproduce the issue\n * Proof-of-concept or exploit code (if possible)\n * Impact of the issue, including how an attacker might exploit the issue\n\nThis information will help us triage your report more quickly.\n\nIf you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/security.md/msrc/bounty) page for more details about our active programs.\n\n## Preferred Languages\n\nWe prefer all communications to be in English.\n\n## Policy\n\nMicrosoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/security.md/cvd).\n\n\n"
},
{
"path": "eShopSupport.sln",
"content": "\nMicrosoft Visual Studio Solution File, Format Version 12.00\n# Visual Studio Version 17\nVisualStudioVersion = 17.0.31903.59\nMinimumVisualStudioVersion = 10.0.40219.1\nProject(\"{2150E333-8FDC-42A3-9474-1A3956D46DE8}\") = \"src\", \"src\", \"{7306A281-C46A-4EE3-948D-513D56B1BD34}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Backend\", \"src\\Backend\\Backend.csproj\", \"{96F30B32-9DE5-450F-B54F-CFDFACC91AFF}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"StaffWebUI\", \"src\\StaffWebUI\\StaffWebUI.csproj\", \"{D77F3443-68A2-4F6A-ABB8-0E7CA32643FA}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"AppHost\", \"src\\AppHost\\AppHost.csproj\", \"{BEE4A236-2112-44BF-8013-00542A07E4FE}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"ServiceDefaults\", \"src\\ServiceDefaults\\ServiceDefaults.csproj\", \"{D69799F9-BE09-4303-A67D-323A60AA8C0A}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"DataIngestor\", \"src\\DataIngestor\\DataIngestor.csproj\", \"{E0886BA7-F33C-4FB4-80D1-93FCC1C4A513}\"\nEndProject\nProject(\"{2150E333-8FDC-42A3-9474-1A3956D46DE8}\") = \"seeddata\", \"seeddata\", \"{2B17496A-5870-4676-927B-6B45871C7BBA}\"\nEndProject\nProject(\"{2150E333-8FDC-42A3-9474-1A3956D46DE8}\") = \"dev\", \"dev\", \"{B3CDC49A-D71A-4C0D-945F-8DD69FC1B066}\"\n\tProjectSection(SolutionItems) = preProject\n\t\tseeddata\\dev\\categories.json = seeddata\\dev\\categories.json\n\t\tseeddata\\dev\\customers.json = seeddata\\dev\\customers.json\n\t\tseeddata\\dev\\evalquestions.json = seeddata\\dev\\evalquestions.json\n\t\tseeddata\\dev\\manual-chunks.json = seeddata\\dev\\manual-chunks.json\n\t\tseeddata\\dev\\manuals.zip = seeddata\\dev\\manuals.zip\n\t\tseeddata\\dev\\products.json = seeddata\\dev\\products.json\n\t\tseeddata\\dev\\tickets.json = seeddata\\dev\\tickets.json\n\tEndProjectSection\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"CustomerWebUI\", \"src\\CustomerWebUI\\CustomerWebUI.csproj\", \"{AAA2257C-D227-404A-8EDF-7BF6C5592D51}\"\nEndProject\nProject(\"{888888A0-9F3D-457C-B088-3A5042F75D52}\") = \"PythonInference\", \"src\\PythonInference\\PythonInference.pyproj\", \"{BAA14585-1716-40FB-A04E-F986F1038638}\"\nEndProject\nProject(\"{2150E333-8FDC-42A3-9474-1A3956D46DE8}\") = \"Solution Items\", \"Solution Items\", \"{218618B1-A99C-4174-A13C-0C2CFD065D78}\"\n\tProjectSection(SolutionItems) = preProject\n\t\tDirectory.Packages.props = Directory.Packages.props\n\tEndProjectSection\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"DataGenerator\", \"seeddata\\DataGenerator\\DataGenerator.csproj\", \"{E2871C52-FBBF-44A4-A3CD-185E5F6AA7EB}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Evaluator\", \"src\\Evaluator\\Evaluator.csproj\", \"{A634C7D8-FD7D-49F5-A98E-626F0AEE145F}\"\nEndProject\nProject(\"{2150E333-8FDC-42A3-9474-1A3956D46DE8}\") = \"test\", \"test\", \"{9E677D76-414B-492C-AF74-1B091F940D00}\"\n\tProjectSection(SolutionItems) = preProject\n\t\tseeddata\\test\\categories.json = seeddata\\test\\categories.json\n\t\tseeddata\\test\\customers.json = seeddata\\test\\customers.json\n\t\tseeddata\\test\\evalquestions.json = seeddata\\test\\evalquestions.json\n\t\tseeddata\\test\\manual-chunks.json = seeddata\\test\\manual-chunks.json\n\t\tseeddata\\test\\manuals.zip = seeddata\\test\\manuals.zip\n\t\tseeddata\\test\\products.json = seeddata\\test\\products.json\n\t\tseeddata\\test\\tickets.json = seeddata\\test\\tickets.json\n\tEndProjectSection\nEndProject\nProject(\"{2150E333-8FDC-42A3-9474-1A3956D46DE8}\") = \"test\", \"test\", \"{51031120-B48D-4680-8808-26B64F235CB9}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"E2ETest\", \"test\\E2ETest\\E2ETest.csproj\", \"{F30843C3-AFB5-435E-8A7D-9B4C86A75E18}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"IdentityServer\", \"src\\IdentityServer\\IdentityServer.csproj\", \"{89404F66-90BC-4D45-9061-050334772CDC}\"\nEndProject\nProject(\"{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}\") = \"EvaluationTests\", \"test\\EvaluationTests\\EvaluationTests.csproj\", \"{6BE0D6D5-F251-4628-9FB9-B19C565FC5EB}\"\nEndProject\nGlobal\n\tGlobalSection(SolutionConfigurationPlatforms) = preSolution\n\t\tDebug|Any CPU = Debug|Any CPU\n\t\tRelease|Any CPU = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(ProjectConfigurationPlatforms) = postSolution\n\t\t{96F30B32-9DE5-450F-B54F-CFDFACC91AFF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{96F30B32-9DE5-450F-B54F-CFDFACC91AFF}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{96F30B32-9DE5-450F-B54F-CFDFACC91AFF}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{96F30B32-9DE5-450F-B54F-CFDFACC91AFF}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{D77F3443-68A2-4F6A-ABB8-0E7CA32643FA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{D77F3443-68A2-4F6A-ABB8-0E7CA32643FA}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{D77F3443-68A2-4F6A-ABB8-0E7CA32643FA}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{D77F3443-68A2-4F6A-ABB8-0E7CA32643FA}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{BEE4A236-2112-44BF-8013-00542A07E4FE}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{BEE4A236-2112-44BF-8013-00542A07E4FE}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{BEE4A236-2112-44BF-8013-00542A07E4FE}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{BEE4A236-2112-44BF-8013-00542A07E4FE}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{D69799F9-BE09-4303-A67D-323A60AA8C0A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{D69799F9-BE09-4303-A67D-323A60AA8C0A}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{D69799F9-BE09-4303-A67D-323A60AA8C0A}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{D69799F9-BE09-4303-A67D-323A60AA8C0A}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{E0886BA7-F33C-4FB4-80D1-93FCC1C4A513}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{E0886BA7-F33C-4FB4-80D1-93FCC1C4A513}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{E0886BA7-F33C-4FB4-80D1-93FCC1C4A513}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{E0886BA7-F33C-4FB4-80D1-93FCC1C4A513}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{AAA2257C-D227-404A-8EDF-7BF6C5592D51}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{AAA2257C-D227-404A-8EDF-7BF6C5592D51}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{AAA2257C-D227-404A-8EDF-7BF6C5592D51}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{AAA2257C-D227-404A-8EDF-7BF6C5592D51}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{BAA14585-1716-40FB-A04E-F986F1038638}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{BAA14585-1716-40FB-A04E-F986F1038638}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{E2871C52-FBBF-44A4-A3CD-185E5F6AA7EB}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{E2871C52-FBBF-44A4-A3CD-185E5F6AA7EB}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{E2871C52-FBBF-44A4-A3CD-185E5F6AA7EB}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{E2871C52-FBBF-44A4-A3CD-185E5F6AA7EB}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{A634C7D8-FD7D-49F5-A98E-626F0AEE145F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{A634C7D8-FD7D-49F5-A98E-626F0AEE145F}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{A634C7D8-FD7D-49F5-A98E-626F0AEE145F}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{A634C7D8-FD7D-49F5-A98E-626F0AEE145F}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{F30843C3-AFB5-435E-8A7D-9B4C86A75E18}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{F30843C3-AFB5-435E-8A7D-9B4C86A75E18}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{F30843C3-AFB5-435E-8A7D-9B4C86A75E18}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{F30843C3-AFB5-435E-8A7D-9B4C86A75E18}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{89404F66-90BC-4D45-9061-050334772CDC}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{89404F66-90BC-4D45-9061-050334772CDC}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{89404F66-90BC-4D45-9061-050334772CDC}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{89404F66-90BC-4D45-9061-050334772CDC}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{6BE0D6D5-F251-4628-9FB9-B19C565FC5EB}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{6BE0D6D5-F251-4628-9FB9-B19C565FC5EB}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{6BE0D6D5-F251-4628-9FB9-B19C565FC5EB}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{6BE0D6D5-F251-4628-9FB9-B19C565FC5EB}.Release|Any CPU.Build.0 = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(SolutionProperties) = preSolution\n\t\tHideSolutionNode = FALSE\n\tEndGlobalSection\n\tGlobalSection(NestedProjects) = preSolution\n\t\t{96F30B32-9DE5-450F-B54F-CFDFACC91AFF} = {7306A281-C46A-4EE3-948D-513D56B1BD34}\n\t\t{D77F3443-68A2-4F6A-ABB8-0E7CA32643FA} = {7306A281-C46A-4EE3-948D-513D56B1BD34}\n\t\t{BEE4A236-2112-44BF-8013-00542A07E4FE} = {7306A281-C46A-4EE3-948D-513D56B1BD34}\n\t\t{D69799F9-BE09-4303-A67D-323A60AA8C0A} = {7306A281-C46A-4EE3-948D-513D56B1BD34}\n\t\t{E0886BA7-F33C-4FB4-80D1-93FCC1C4A513} = {7306A281-C46A-4EE3-948D-513D56B1BD34}\n\t\t{B3CDC49A-D71A-4C0D-945F-8DD69FC1B066} = {2B17496A-5870-4676-927B-6B45871C7BBA}\n\t\t{AAA2257C-D227-404A-8EDF-7BF6C5592D51} = {7306A281-C46A-4EE3-948D-513D56B1BD34}\n\t\t{BAA14585-1716-40FB-A04E-F986F1038638} = {7306A281-C46A-4EE3-948D-513D56B1BD34}\n\t\t{E2871C52-FBBF-44A4-A3CD-185E5F6AA7EB} = {2B17496A-5870-4676-927B-6B45871C7BBA}\n\t\t{A634C7D8-FD7D-49F5-A98E-626F0AEE145F} = {7306A281-C46A-4EE3-948D-513D56B1BD34}\n\t\t{9E677D76-414B-492C-AF74-1B091F940D00} = {2B17496A-5870-4676-927B-6B45871C7BBA}\n\t\t{F30843C3-AFB5-435E-8A7D-9B4C86A75E18} = {51031120-B48D-4680-8808-26B64F235CB9}\n\t\t{89404F66-90BC-4D45-9061-050334772CDC} = {7306A281-C46A-4EE3-948D-513D56B1BD34}\n\t\t{6BE0D6D5-F251-4628-9FB9-B19C565FC5EB} = {51031120-B48D-4680-8808-26B64F235CB9}\n\tEndGlobalSection\n\tGlobalSection(ExtensibilityGlobals) = postSolution\n\t\tSolutionGuid = {B2E71FD9-E3D5-450C-A9E0-318DAA986F31}\n\tEndGlobalSection\nEndGlobal\n"
},
{
"path": "nuget.config",
"content": "\n\n \n \n \n \n \n\n \n \n \n \n \n \n \n\n"
},
{
"path": "seeddata/DataGenerator/.gitignore",
"content": "appsettings.Local.json\noutput/\noutput-demo/\n"
},
{
"path": "seeddata/DataGenerator/ChatCompletionServiceExtensions.cs",
"content": "using Microsoft.Extensions.DependencyInjection;\nusing System.Data.Common;\nusing Microsoft.Extensions.Hosting;\nusing Microsoft.Extensions.Configuration;\nusing Microsoft.Extensions.AI;\nusing Azure.AI.OpenAI;\nusing System.ClientModel;\nusing OpenAI;\n\nnamespace eShopSupport.DataGenerator;\n\npublic static class ChatCompletionServiceExtensions\n{\n public static void AddOpenAIChatCompletion(this HostApplicationBuilder builder, string connectionStringName)\n {\n var connectionStringBuilder = new DbConnectionStringBuilder();\n var connectionString = builder.Configuration.GetConnectionString(connectionStringName);\n if (string.IsNullOrEmpty(connectionString))\n {\n throw new InvalidOperationException($\"Missing connection string {connectionStringName}\");\n }\n\n connectionStringBuilder.ConnectionString = connectionString;\n\n var deployment = connectionStringBuilder.TryGetValue(\"Deployment\", out var deploymentValue) ? (string)deploymentValue : throw new InvalidOperationException($\"Connection string {connectionStringName} is missing 'Deployment'\");\n var endpoint = connectionStringBuilder.TryGetValue(\"Endpoint\", out var endpointValue) ? (string)endpointValue : throw new InvalidOperationException($\"Connection string {connectionStringName} is missing 'Endpoint'\");\n var key = connectionStringBuilder.TryGetValue(\"Key\", out var keyValue) ? (string)keyValue : throw new InvalidOperationException($\"Connection string {connectionStringName} is missing 'Key'\");\n\n builder.Services.AddSingleton(_ => new AzureOpenAIClient(\n new Uri(endpoint), new ApiKeyCredential(key)));\n\n builder.Services.AddChatClient(builder => builder.GetRequiredService().GetChatClient(deployment).AsIChatClient())\n .UseFunctionInvocation();\n }\n}\n"
},
{
"path": "seeddata/DataGenerator/DataGenerator.csproj",
"content": "\n\n \n Exe\n net8.0\n enable\n enable\n eShopSupport.DataGenerator\n \n\n \n \n \n \n \n \n \n \n \n\n \n \n PreserveNewest\n \n \n PreserveNewest\n \n \n\n\n"
},
{
"path": "seeddata/DataGenerator/Generators/CategoryGenerator.cs",
"content": "using eShopSupport.DataGenerator.Model;\nusing System.Text.RegularExpressions;\n\nnamespace eShopSupport.DataGenerator.Generators;\n\npublic class CategoryGenerator(IServiceProvider services) : GeneratorBase(services)\n{\n protected override string DirectoryName => \"categories\";\n\n protected override object GetId(Category item) => item.CategoryId;\n\n protected override async IAsyncEnumerable GenerateCoreAsync()\n {\n // If there are any categories already, assume this covers everything we need\n if (Directory.GetFiles(OutputDirPath).Any())\n {\n yield break;\n }\n\n var numCategories = 50;\n var batchSize = 25;\n var categoryNames = new HashSet();\n\n while (categoryNames.Count < numCategories)\n {\n Console.WriteLine($\"Generating {batchSize} categories...\");\n\n var prompt = @$\"Generate {batchSize} product category names for an online retailer\n of high-tech outdoor adventure goods and related clothing/electronics/etc.\n Each category name is a single descriptive term, so it does not use the word 'and'.\n Category names should be interesting and novel, e.g., \"\"Mountain Unicycles\"\", \"\"AI Boots\"\",\n or \"\"High-volume Water Filtration Plants\"\", not simply \"\"Tents\"\".\n This retailer sells relatively technical products.\n\n Each category has a list of up to 8 brand names that make products in that category. All brand names are\n purely fictional. Brand names are usually multiple words with spaces and/or special characters, e.g.\n \"\"Orange Gear\"\", \"\"Aqua Tech US\"\", \"\"Livewell\"\", \"\"E & K\"\", \"\"JAXⓇ\"\".\n Many brand names are used in multiple categories. Some categories have only 2 brands.\n \n The response should be a JSON object of the form {{ \"\"categories\"\": [{{\"\"name\"\":\"\"Tents\"\", \"\"brands\"\":[\"\"Rosewood\"\", \"\"Summit Kings\"\"]}}, ...] }}.\";\n\n var response = await GetAndParseJsonChatCompletion(prompt, maxTokens: 70 * batchSize);\n foreach (var c in response.Categories)\n {\n if (categoryNames.Add(c.Name))\n {\n c.CategoryId = categoryNames.Count;\n c.Brands = c.Brands.Select(ImproveBrandName).ToArray();\n yield return c;\n }\n }\n }\n }\n\n private static string ImproveBrandName(string name)\n {\n // Almost invariably, the name is a PascalCase word like AquaTech, even though we told it to use spaces.\n // For variety, convert to \"Aqua Tech\" or \"Aquatech\" sometimes.\n return Regex.Replace(name, @\"([a-z])([A-Z])\", m => Random.Shared.Next(3) switch\n {\n 0 => $\"{m.Groups[1].Value} {m.Groups[2].Value}\",\n 1 => $\"{m.Groups[1].Value}{m.Groups[2].Value.ToLower()}\",\n _ => m.Value\n });\n }\n\n private class Response\n {\n public required List Categories { get; set; }\n }\n}\n"
},
{
"path": "seeddata/DataGenerator/Generators/EvalQuestionGenerator.cs",
"content": "using System.Text;\nusing System.Threading.Channels;\nusing eShopSupport.DataGenerator.Model;\n\nnamespace eShopSupport.DataGenerator.Generators;\n\npublic class EvalQuestionGenerator(IReadOnlyList products, IReadOnlyList categories, IReadOnlyList manuals, IServiceProvider services)\n : GeneratorBase(services)\n{\n protected override string DirectoryName => \"evalquestions\";\n\n protected override object GetId(EvalQuestion item)\n => item.QuestionId;\n\n protected override async IAsyncEnumerable GenerateCoreAsync()\n {\n // If there are any questions already, assume this covers everything we need\n if (Directory.GetFiles(OutputDirPath).Any())\n {\n yield break;\n }\n\n var numQuestions = 500;\n var questionId = 0;\n var outputChannel = Channel.CreateUnbounded();\n var parallelOptions = new ParallelOptions { MaxDegreeOfParallelism = 10 };\n CompleteOutputAfterTask(outputChannel.Writer, Parallel.ForAsync(0, numQuestions, parallelOptions, async (_, _) =>\n {\n var item = await GenerateSingle();\n if (!string.IsNullOrWhiteSpace(item.Question) && !string.IsNullOrEmpty(item.Answer))\n {\n item.QuestionId = Interlocked.Increment(ref questionId);\n await outputChannel.Writer.WriteAsync(item);\n }\n }));\n\n await foreach (var item in outputChannel.Reader.ReadAllAsync())\n {\n yield return item;\n }\n }\n\n private static void CompleteOutputAfterTask(ChannelWriter writer, Task task)\n {\n Task.Run(async () =>\n {\n try\n {\n await task;\n writer.Complete();\n }\n catch (Exception ex)\n {\n writer.Complete(ex);\n }\n });\n }\n\n private async Task GenerateSingle()\n {\n var product = products[Random.Shared.Next(products.Count)];\n var category = categories.Single(c => c.CategoryId == product.CategoryId);\n var manual = manuals.Single(m => m.ProductId == product.ProductId);\n var manualExtract = ManualGenerator.ExtractFromManual(manual);\n var isQuestionWrittenByAgent = Random.Shared.NextDouble() < 0.75;\n var questionPrompt = isQuestionWrittenByAgent\n ? \"\"\"\n Questions are short, typically 3-6 words, and are not always full sentences. They may look\n like search queries or things typed in a hurry by a support agent. They are not polite or\n verbose, since they are addressed to a machine.\n Example questions might be \"weight\", \"what are the dimensions\", \"how to shut down\",\n \"can use on pets?\", \"what accessories does it come with?\"\n \"\"\"\n : \"\"\"\n The question is actually an entire email written by a customer. It usually starts with a\n greeting, some description of their situation, and then their question. The whole thing\n may be up to 100 words long. It may contain spelling and grammar errors, and may be angry\n or rude.\n \"\"\";\n\n var question = await GetAndParseJsonChatCompletion($$\"\"\"\n There is an AI system used by customer support agents working for an online retailer.\n The AI system is used to help agents answer customer questions.\n\n Your task is to write question/answer pairs that will be used to evaluate the\n performance of that AI system. All the questions you write will be about actual products\n sold by that retailer, based on information from the product catalog and manuals. The\n questions should plausibly represent what customers and support agents will ask.\n\n In this case, you are to write a question/answer pair based on the following context:\n\n {{product.Model}}\n {{product.Brand}}\n {{category.Name}}\n {{manualExtract}}\n\n Questions are one of the following types:\n - A pre-purchase question to help a customer who wants to know about the product\n features, suitability for particular use cases, or other objective facts\n - A post-purchase question to help a customer resolve an issue or understand how to\n use the product\n\n You must select an OBJECTIVE FACT from the product manual and write a question to which\n that fact is the answer. Only select facts that are distinctive about this specific product,\n not generic information about any product or warranty terms.\n\n Always follow these style guidelines:\n - {{questionPrompt}}\n - Answers are short, typically a single brief sentence of 1-10 words. Never use more than\n 20 words for an answer.\n - The \"verbatim_quote_from_manual\" is 3-6 words taken EXACTLY from the manual which are\n the factual basis for the question and asnwer.\n - If the provided context does not contain a suitable fact, set all the response properties\n to null or empty strings.\n\n Respond as JSON in the following form: {\n \"question\": \"string\",\n \"answer\": \"string\",\n \"verbatimQuoteFromManual\": \"string\"\n }\n \"\"\");\n question.ProductId = product.ProductId;\n return question;\n }\n}\n"
},
{
"path": "seeddata/DataGenerator/Generators/GeneratorBase.cs",
"content": "using Microsoft.Extensions.AI;\nusing Microsoft.Extensions.DependencyInjection;\nusing System.Diagnostics;\nusing System.Text;\nusing System.Text.Json;\nusing System.Threading.Channels;\n\nnamespace eShopSupport.DataGenerator.Generators;\n\npublic abstract class GeneratorBase\n{\n protected abstract string DirectoryName { get; }\n\n protected abstract object GetId(T item);\n\n public static string OutputDirRoot => Path.Combine(AppContext.BaseDirectory, \"..\", \"..\", \"..\", \"output\");\n\n protected string OutputDirPath => Path.Combine(OutputDirRoot, DirectoryName);\n\n protected JsonSerializerOptions SerializerOptions = new JsonSerializerOptions(JsonSerializerDefaults.Web)\n {\n WriteIndented = true\n };\n\n public GeneratorBase(IServiceProvider services)\n {\n ChatClient = services.GetRequiredService();\n }\n\n public async Task> GenerateAsync()\n {\n if (!Directory.Exists(OutputDirPath))\n {\n Directory.CreateDirectory(OutputDirPath);\n }\n\n var sw = Stopwatch.StartNew();\n await foreach (var item in GenerateCoreAsync())\n {\n sw.Stop();\n Console.WriteLine($\"Writing {item!.GetType().Name} {GetId(item)} [generated in {sw.Elapsed.TotalSeconds}s]\");\n var path = GetItemOutputPath(GetId(item).ToString()!);\n await WriteAsync(path, item);\n sw.Restart();\n }\n\n var existingFiles = Directory.GetFiles(OutputDirPath);\n return existingFiles.Select(Read).ToList();\n }\n\n protected string GetItemOutputPath(string id)\n => Path.Combine(OutputDirPath, $\"{id}{FilenameExtension}\");\n\n protected abstract IAsyncEnumerable GenerateCoreAsync();\n\n protected IChatClient ChatClient { get; }\n\n protected async Task GetCompletion(string prompt)\n {\n // Instructing it to end the content with END_OF_CONTENT is beneficial because it often tries to add a suffix like\n // \"I have done the task, hope this helps!\". We can avoid that by making it stop before that.\n var response = await ChatClient.GetResponseAsync(\n prompt,\n new ChatOptions { Temperature = 0.9f, StopSequences = [\"END_OF_CONTENT\"] });\n return response.Text ?? string.Empty;\n }\n\n protected async Task GetAndParseJsonChatCompletion(string prompt, int? maxTokens = null, IList? tools = null)\n {\n var options = new ChatOptions\n {\n // MaxOutputTokens = maxTokens, // TODO: Re-enable when https://github.com/dotnet/temp-ai-abstractions/issues/294 is fixed\n Temperature = 0.9f,\n ResponseFormat = ChatResponseFormat.Json,\n Tools = tools,\n };\n\n var response = await RunWithRetries(() => ChatClient.GetResponseAsync(prompt, options));\n var responseString = response.Text ?? string.Empty;\n\n // Due to what seems like a server-side bug, when asking for a json_object response and with tools enabled,\n // it often replies with two or more JSON objects concatenated together (duplicates or slight variations).\n // As a workaround, just read the first complete JSON object from the response.\n var parsed = ReadAndDeserializeSingleValue(responseString, SerializerOptions)!;\n return parsed;\n }\n\n private static async Task RunWithRetries(Func> operation)\n {\n var delay = TimeSpan.FromSeconds(5);\n var maxAttempts = 5;\n for (var attemptIndex = 1; ; attemptIndex++)\n {\n try\n {\n return await operation();\n }\n catch (Exception e) when (attemptIndex < maxAttempts)\n {\n Console.WriteLine($\"Exception on attempt {attemptIndex}: {e.Message}. Will retry after {delay}\");\n await Task.Delay(delay);\n delay += TimeSpan.FromSeconds(15);\n }\n }\n }\n\n private static TResponse? ReadAndDeserializeSingleValue(string json, JsonSerializerOptions options)\n {\n var reader = new Utf8JsonReader(Encoding.UTF8.GetBytes(json).AsSpan());\n return JsonSerializer.Deserialize(ref reader, options);\n }\n\n protected virtual string FilenameExtension => \".json\";\n\n protected virtual Task WriteAsync(string path, T item)\n {\n var itemJson = JsonSerializer.Serialize(item, SerializerOptions);\n return File.WriteAllTextAsync(path, itemJson);\n }\n\n protected virtual T Read(string path)\n {\n try\n {\n using var existingJson = File.OpenRead(path);\n return JsonSerializer.Deserialize(existingJson, SerializerOptions)!;\n }\n catch (Exception ex)\n {\n Console.WriteLine($\"Error reading {path}: {ex.Message}\");\n throw;\n }\n }\n\n protected IAsyncEnumerable MapParallel(IEnumerable source, Func> map)\n {\n var outputs = Channel.CreateUnbounded();\n var parallelOptions = new ParallelOptions { MaxDegreeOfParallelism = 5 };\n var mapTask = Parallel.ForEachAsync(source, parallelOptions, async (sourceItem, ct) =>\n {\n try\n {\n var mappedItem = await map(sourceItem);\n await outputs.Writer.WriteAsync(mappedItem);\n }\n catch (Exception ex)\n {\n outputs.Writer.TryComplete(ex);\n }\n });\n\n mapTask.ContinueWith(_ => outputs.Writer.TryComplete());\n\n return outputs.Reader.ReadAllAsync();\n }\n}\n"
},
{
"path": "seeddata/DataGenerator/Generators/LocalTextEmbeddingGenerator.cs",
"content": "using Microsoft.Extensions.AI;\nusing SmartComponents.LocalEmbeddings;\n\nnamespace eShopSupport.DataGenerator.Generators;\n\npublic class LocalTextEmbeddingGenerator : IEmbeddingGenerator>\n{\n private readonly LocalEmbedder _embedder = new();\n\n public EmbeddingGeneratorMetadata Metadata => new(\"local\");\n\n public void Dispose() => _embedder.Dispose();\n\n public Task>> GenerateAsync(IEnumerable values, EmbeddingGenerationOptions? options = null, CancellationToken cancellationToken = default)\n {\n var results = values.Select(v => new Embedding(_embedder.Embed(v).Values)).ToList();\n return Task.FromResult(new GeneratedEmbeddings>(results));\n }\n\n public object? GetService(Type serviceType, object? key = null) \n => serviceType == typeof(IEmbeddingGenerator>) ? this : null;\n}\n"
},
{
"path": "seeddata/DataGenerator/Generators/ManualGenerator.cs",
"content": "using eShopSupport.DataGenerator.Model;\nusing System.Text;\n\nnamespace eShopSupport.DataGenerator.Generators;\n\npublic class ManualGenerator(IReadOnlyList categories, IReadOnlyList products, IReadOnlyList manualTocs, IServiceProvider services)\n : GeneratorBase(services)\n{\n protected override string DirectoryName => $\"manuals{Path.DirectorySeparatorChar}full\";\n\n protected override object GetId(Manual item) => item.ProductId;\n\n protected override IAsyncEnumerable GenerateCoreAsync()\n {\n // Skip the ones we already have\n var manualsToGenerate = manualTocs.Where(toc => !File.Exists(GetItemOutputPath(toc.ProductId.ToString())));\n return MapParallel(manualsToGenerate, GenerateManualAsync);\n }\n\n private async Task GenerateManualAsync(ManualToc toc)\n {\n var product = products.Single(p => p.ProductId == toc.ProductId);\n var category = categories.Single(c => c.CategoryId == product.CategoryId);\n\n var result = new StringBuilder();\n result.AppendLine($\"# {product.Model}\");\n result.AppendLine();\n\n var desiredSubsectionWordLength = 500;\n foreach (var section in toc.Sections)\n {\n Console.WriteLine($\"[Product {product.ProductId}] Generating manual section {section.SiblingIndex}: {section.Title}\");\n\n var prompt = $@\"Write a section of the user manual for the following product:\nCategory: {category.Name}\nBrand: {product.Brand}\nProduct name: {product.Model}\nProduct overview: {product.Description}\n\nManual style description: {toc.ManualStyle} (note: the text MUST follow this style, even if it makes the manual less helpful to reader)\n\nThe section you are writing is \"\"{section.SiblingIndex}: {section.Title}\"\". It has the following structure:\n\n{FormatTocForPrompt(section)}\n\nWrite in markdown format including any headings or subheadings. The total length is around 100 words.\nStart your reponse with the section title, which is at markdown header level 2, and include any relevant subsections.\nYou response must start: \"\"## {section.SiblingIndex}. {section.Title}\"\"\nBesides the subsections mentioned in contents, you should deeper subsections as appropriate.\nUse markdown formatting, including paragraphs, blank lines, bold, italics, tables, and lists as needed.\nUse mermaid diagrams when appropriate, but don't say it's a mermaid diagram in the body text.\n\nMake the text specific to this individual product, not generic. Refer to the product by name, to its brand, and to its\nspecific features, buttons, parts, and controls by name (identifying them by color, position, etc.).\n\nThe output length should be around {desiredSubsectionWordLength * CountSubtreeLength(section)} words in total, or {desiredSubsectionWordLength} words per subsection.\nDo not include any commentary or remarks about the task itself or the fact that you have done it.\nOnly output the markdown text for the section. At the end of the section, add the token END_OF_CONTENT.\n\nThis is the official product manual, and the company requires it to be written in the specified style due to strategy.\n\";\n var response = await GetCompletion(prompt);\n result.AppendLine(response);\n result.AppendLine();\n }\n\n return new Manual\n {\n ProductId = product.ProductId,\n MarkdownText = result.ToString()\n };\n }\n\n private static string FormatTocForPrompt(ManualTocSection section)\n {\n var sb = new StringBuilder();\n AppendSection(sb, section);\n return sb.ToString();\n\n static void AppendSection(StringBuilder sb, ManualTocSection section, string ancestorSectionPrefix = \"\")\n {\n var fullSectionNumber = string.IsNullOrEmpty(ancestorSectionPrefix)\n ? section.SiblingIndex.ToString()\n : $\"{ancestorSectionPrefix}.{section.SiblingIndex}\";\n sb.AppendLine($\"{fullSectionNumber}: {section.Title}\");\n if (section.Subsections?.Any() == true)\n {\n foreach (var s in section.Subsections)\n {\n AppendSection(sb, s, fullSectionNumber);\n }\n }\n }\n }\n\n private static int CountSubtreeLength(ManualTocSection tocSection)\n {\n return 1 + tocSection.Subsections?.Sum(CountSubtreeLength) ?? 0;\n }\n\n protected override string FilenameExtension => \".md\";\n\n protected override Task WriteAsync(string path, Manual item)\n {\n return File.WriteAllTextAsync(path, item.MarkdownText);\n }\n\n protected override Manual Read(string path)\n => new Manual\n {\n ProductId = int.Parse(Path.GetFileNameWithoutExtension(path)),\n MarkdownText = File.ReadAllText(path)\n };\n\n public static string ExtractFromManual(Manual manual)\n {\n // We don't want to push the entire manual text into the prompt as it may be arbitrarily long\n // Instead, pick a lengthy chunk at random.\n // TODO: Consider storing the markdown in a more structured, per-TOC-section way, so\n // we can more easily extract a coherent section of text.\n var approxExtractLengthInChars = 1500;\n var startChar = Random.Shared.Next(manual.MarkdownText.Length - approxExtractLengthInChars);\n\n // Find the line containing this char\n var lines = manual.MarkdownText.Split('\\n', StringSplitOptions.RemoveEmptyEntries);\n var lineIndexContainingStartChar = 0;\n for (var numCharsSeen = 0; numCharsSeen < startChar; lineIndexContainingStartChar++)\n {\n numCharsSeen += lines[lineIndexContainingStartChar].Length;\n }\n\n // Add lines until we have enough text\n var extract = new StringBuilder();\n for (var i = lineIndexContainingStartChar; i < lines.Length; i++)\n {\n extract.AppendLine(lines[i]);\n if (extract.Length >= approxExtractLengthInChars)\n {\n break;\n }\n }\n\n return extract.ToString();\n }\n}\n"
},
{
"path": "seeddata/DataGenerator/Generators/ManualPdfConverter.cs",
"content": "using eShopSupport.DataGenerator.Model;\nusing Markdown2Pdf;\nusing Markdown2Pdf.Options;\nusing System.Text.RegularExpressions;\n\nnamespace eShopSupport.DataGenerator.Generators;\n\npublic class ManualPdfConverter(IReadOnlyList products, IReadOnlyList manuals)\n{\n Markdown2PdfConverter CreateConverter(Product product) => new(new()\n {\n DocumentTitle = product.Model,\n MarginOptions = new()\n {\n Top = \"80px\",\n Bottom = \"80px\",\n Left = \"75px\",\n Right = \"75px\",\n },\n TableOfContents = new()\n {\n ListStyle = ListStyle.None,\n MinDepthLevel = 2,\n MaxDepthLevel = 4,\n PageNumberOptions = new()\n {\n TabLeader = Leader.Dots,\n },\n },\n CustomHeadContent = @\"\",\n HeaderHtml = \"\",\n FooterHtml = $\"
(c) {product.Brand}
\",\n });\n\n public async Task> ConvertAsync()\n {\n var results = new List();\n\n foreach (var manual in manuals)\n {\n var outputDir = Path.Combine(GeneratorBase