Container apps deployment now allows scaling to zero

To lower costs for developers experimenting, we've adjusted the scaling rules for the container apps deployment. See the productionizing guide for tips of what to change if you're preparing code based on this repository for production:
https://github.com/Azure-Samples/azure-search-openai-demo/blob/main/docs/productionizing.md#azure-container-apps

What's Changed

• Adjust container apps to scale to zero by @pamelafox in #2440
• Bump dompurify from 3.2.0 to 3.2.4 in /app/frontend by @dependabot in #2363
• Bump react-i18next from 15.1.1 to 15.4.1 in /app/frontend by @dependabot in #2376

Full Changelog: 2025-03-19...2025-03-21

2025-03-19: Query rewriting from Azure AI Search

This release adds a new optional feature, the query rewriting option from Azure AI Search. This is distinct from the already existing query rewriting step in our RAG flows, which incorporates conversation history. The query rewriting from Azure AI Search focuses on expanding the query to semantically similar queries that can improve retrieval.

Learn more from the search team in this blog post:
https://techcommunity.microsoft.com/blog/azure-ai-services-blog/raising-the-bar-for-rag-excellence-query-rewriting-and-new-semantic-ranker/4302729

Enable the feature following the documentation:
https://github.com/Azure-Samples/azure-search-openai-demo/blob/main/docs/deploy_features.md#enabling-query-rewriting

What's Changed

• Add auth-related azd env variable checks and improve docs by @pamelafox in #2386
• Upgrade to latest GA API Version by @pamelafox in #2334
• Upgrade Ubuntu runner for tests in Github Workflow to latest by @egor-yudkin in #2428
• Bump jinja2 from 3.1.5 to 3.1.6 in /app/backend by @dependabot in #2435
• Add query rewriting option by @mattgotteiner in #2437

New Contributors

• @egor-yudkin made their first contribution in #2428

Full Changelog: 2025-02-20...2025-03-19

2025-02-20: Safety evaluations

This project now includes optional AI Safety evaluations, using an Azure AI Project and the Azure Azure AI evaluation SDK.
See documentation for instructons on running the evaluations.

What's Changed

• Upgrading openai and removing numpy dependency by @pamelafox in #2362
• Bump Azure/setup-azd from 2.0.0 to 2.1.0 in the github-actions group by @dependabot in #2366
• AI Safety evaluations (with AI Project provisioning) by @pamelafox in #2370

Full Changelog: 2025-02-13...2025-02-20

2025-02-13: Italian localization

The UI is now available in Italian, so the text will display in Italian if the user's browser is configured accordingly, or if the app has the language picker enabled and the user picks italian.

What's Changed

• Bump cryptography from 44.0.0 to 44.0.1 in /app/backend by @dependabot in #2354
• Improve locust test script by @tonybaloney in #2357
• Fix screenshot for Monitoring doc by @pamelafox in #2355
• Added support for italian language by @ivanvaccarics in #2356

New Contributors

• @ivanvaccarics made their first contribution in #2356

Full Changelog: 2025-02-11...2025-02-13

2025-02-11: Evaluation scripts and workflow

For a long time, we've directed developers to follow the steps in ai-rag-chat-evaluator to run evaluations on this app. To make it easier, we've now integrated evaluation directly into the repository, both as CLI scripts and GitHub Actions workflow.

Learn more from the evaluation guide or watch this video about evaluation.

What's Changed

• Make it easy to run evaluation directly from this repo by @pamelafox in #2233
• Use uv managed python in GHA workflows by @eifinger in #2342
• Evaluation workflow for GitHub Actions by @pamelafox in #2350

New Contributors

• @eifinger made their first contribution in #2342

Full Changelog: 2025-02-07...2025-02-11

2025-02-07: Upgrade gpt-35-turbo to 0125

Due to the impending deprecation of old gpt-35-turbo models, we upgraded our default version to 0125, the only remaining supported version. We will likely soon change the gpt-35-turbo to gpt-4o-mini, pending some evaluations.

What's Changed

• Default gpt-35-turbo to 0125 by @pamelafox in #2329

Full Changelog: 2025-01-29b...2025-02-07

2025-01-29b: New database schema for Cosmos DB

This release improves the database schema for the Cosmos DB chat history feature, based on discussions with the Cosmos DB team about avoiding excessively large document sizes. This is a breaking change, so if you already have the feature deployed, you'll need to do a full azd up to create the new container and deploy the new code, and users will not see past chat history.

If you want to migrate the past chat history to the new schema before deploying the change, please file an issue in the tracker, and we will write a migration script from the new container to the older container.

 ## What's Changed

• Improve schema of CosmosDB chat history to handle long conversations by @pamelafox in #2312

Full Changelog: 2025-01-29a...2025-01-29b

2025-01-29a: More options to customize OpenAI deployments

This release contains various bug fixes, plus two new environment variables for controlling Azure OpenAI deployments:

• AZURE_OPENAI_DISABLE_KEYS (which defaults to true, since this repository uses keyless authentication)
• AZURE_OPENAI_LOCATION for programmatically setting the OpenAI resource location, helpful for those of you using an existing Azure OpenAI resource.

See docs for more details.

What's Changed

• Fix ask prompts to allow prompt override/injection by @pamelafox in #2277
• Add environment variable to disable/enable keys by @pamelafox in #2280
• Fix cosmos Bicep configuration by @pamelafox in #2226
• Add content understanding to private endpoint by @pamelafox in #2225
• Adding a variable for OpenAI resource location by @pamelafox in #2292
• Clearer variables for image cropping code by @pamelafox in #2298
• Replace sparkle with app logo that's easier to replace by @pamelafox in #2299
• Note about ACA and app insights by @pamelafox in #2300
• Bump vite from 5.4.11 to 5.4.14 in /app/frontend by @dependabot in #2293
• Bump aiohappyeyeballs from 2.4.0 to 2.4.4 by @dependabot in #2288
• Bump pyjwt[crypto] from 2.9.0 to 2.10.1 by @dependabot in #2287
• Bump Azure/setup-azd from 2.0.0 to 2.1.0 in the github-actions group by @dependabot in #2310
• Bump i18next-browser-languagedetector from 8.0.0 to 8.0.2 in /app/frontend by @dependabot in #2271

Full Changelog: 2025-01-14...2025-01-29a

2025-01-14: Use Prompty for prompt management

This release uses Prompty (https://prompty.ai/) to store prompts, instead of storing them in Python strings.

All prompts are inside prompty files, stored in app/backend/approaches/prompts. The prompty file format has good support in the Microsoft ecosystem: you can use the VS Code Prompty extension to experiment with the prompts, and you can even upload the prompty files to the Chat playground in Azure AI Foundry.

This is a significant code change, so merge carefully. You will want to change your prompty files to match any customizations you made to your app's prompts.

Join us for tomorrow's live stream to learn more:
https://www.youtube.com/watch?v=D3slfMqydHc

What's Changed

• Use prompty to store prompts by @pamelafox in #2178

Full Changelog: 2025-01-13...2025-01-14

2025-01-13: Python 3.13 support

This release includes a number of dependency upgrades. Those upgrades mean you should now be able to use Python 3.13 for the local development environment on Mac, Windows, or Linux.

What's Changed

• Security Update with Bug Fixes by @john0isaac in #2232
• Update the docs and dev container based off recent feedback by @pamelafox in #2224
• Bump msgraph-sdk from 1.1.0 to 1.16.0 by @dependabot in #2254
• Bump the github-actions group with 2 updates by @dependabot in #2248
• Bump msgraph-core from 1.1.2 to 1.1.8 by @dependabot in #2245
• Bump cryptography from 43.0.1 to 44.0.0 by @dependabot in #2207
• Bump jinja2 from 3.1.4 to 3.1.5 in /app/backend by @dependabot in #2255
• Bump i18next from 23.16.5 to 24.2.0 in /app/frontend by @dependabot in #2247
• Update packages for better 3.13 support by @dependabot in #2238
• Bump azure-monitor-opentelemetry-exporter from 1.0.0b28 to 1.0.0b32 by @dependabot in #2169
• Bump @react-spring/web from 9.7.3 to 9.7.5 in /app/frontend by @dependabot in #2190
• Update README.md Resources with Learn article by @ms-johnalex in #2256
• Bump i18next-http-backend from 2.6.1 to 3.0.1 in /app/frontend by @dependabot in #2189
• Revert upgrade of msgraph-core SDK by @pamelafox in #2257
• Handle lack of support for docx/pptx/xlsx for media description by @pamelafox in #2260
• Bump mypy from 1.13.0 to 1.14.1 by @dependabot in #2267
• Bump regex from 2024.7.24 to 2024.11.6 by @dependabot in #2266
• Bump zipp from 3.20.0 to 3.21.0 by @dependabot in #2270

New Contributors

• @ms-johnalex made their first contribution in #2256

Full Changelog: 2024-12-09...2025-01-13