{"id":25009569,"url":"https://github.com/kentico/xperience-module-openai-azure","last_synced_at":"2026-02-13T03:34:53.017Z","repository":{"id":226427843,"uuid":"749901478","full_name":"Kentico/xperience-module-openai-azure","owner":"Kentico","description":"Kentico Xperience integration with Azure OpenAI","archived":false,"fork":false,"pushed_at":"2025-02-20T09:27:39.000Z","size":73930,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-04-23T18:09:52.629Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kentico.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-29T16:12:59.000Z","updated_at":"2025-02-20T09:28:04.000Z","dependencies_parsed_at":"2025-03-30T02:21:14.463Z","dependency_job_id":null,"html_url":"https://github.com/Kentico/xperience-module-openai-azure","commit_stats":null,"previous_names":["kentico/xperience-module-openai-azure"],"tags_count":0,"template":false,"template_full_name":"Kentico/repo-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kentico%2Fxperience-module-openai-azure","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kentico%2Fxperience-module-openai-azure/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kentico%2Fxperience-module-openai-azure/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kentico%2Fxperience-module-openai-azure/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kentico","download_url":"https://codeload.github.com/Kentico/xperience-module-openai-azure/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250487531,"owners_count":21438612,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-05T04:40:27.071Z","updated_at":"2026-02-13T03:34:47.964Z","avatar_url":"https://github.com/Kentico.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Xperience Azure OpenAI integration\n\n[![7-day bug-fix policy](https://img.shields.io/badge/-7--days_bug--fixing_policy-grey?labelColor=orange\u0026logo=data:image/svg+xml;base64,PHN2ZyBjbGFzcz0ic3ZnLWljb24iIHN0eWxlPSJ3aWR0aDogMWVtOyBoZWlnaHQ6IDFlbTt2ZXJ0aWNhbC1hbGlnbjogbWlkZGxlO2ZpbGw6IGN1cnJlbnRDb2xvcjtvdmVyZmxvdzogaGlkZGVuOyIgdmlld0JveD0iMCAwIDEwMjQgMTAyNCIgdmVyc2lvbj0iMS4xIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjxwYXRoIGQ9Ik04ODguNDkgMjIyLjY4NnYtMzEuNTRsLTY1LjY3Mi0wLjk1NWgtMC4yMDVhNDY1LjcxNSA0NjUuNzE1IDAgMCAxLTE0NC4zMTUtMzEuMzM0Yy03Ny4wMDUtMzEuMTk4LTEyNi4yOTQtNjYuNzY1LTEyNi43MDMtNjcuMTA3bC0zOS44LTI4LjY3Mi0zOS4xODUgMjguNDY4Yy0yLjA0OCAxLjUwMS00OS45MDMgMzYuMDQ0LTEyNi45MDggNjcuMzFhNDQ3LjQyIDQ0Ny40MiAwIDAgMS0xNDQuNTIgMzEuMzM1bC02NS44NzcgMC45NTZ2Mzc4Ljg4YzAgODcuMDQgNDkuODM0IDE4NC42NjEgMTM3LjAxIDI2Ny44MSAzNy41NDcgMzUuODQgNzkuMjU4IDY2LjM1NSAxMjAuODMzIDg4LjIgNDMuMjggMjIuNzMzIDg0LjI0IDM0LjYxMiAxMTguODUyIDM0LjYxMiAzNC40MDYgMCA3NS43NzYtMTIuMTUyIDExOS42MDMtMzUuMTU4YTU0Ny45NzcgNTQ3Ljk3NyAwIDAgMCAxMjAuMDEzLTg3LjY1NCA1MTUuMjA5IDUxNS4yMDkgMCAwIDAgOTYuMTg4LTEyMi44OGMyNy4xMDItNDkuNTYyIDQwLjgyMy05OC4zMDQgNDAuODIzLTE0NC45OTlsLTAuMTM2LTM0Ny4yMDR6TTUxMC4wOSAxNDMuNDI4bDEuNzA2LTEuMzY1IDEuNzc1IDEuMzY1YzUuODAzIDQuMTY1IDU5LjUyOSA0MS44NDggMTQwLjM1NiA3NC43NTIgNzkuMTkgMzIuMDg2IDE1My42IDM1LjYzNSAxNjcuNjYzIDM2LjA0NWwyLjU5NCAwLjA2OCAwLjIwNSAzMTUuNzM0YzAuMTM3IDY5LjQ5NS00Mi41OTggMTUwLjE4Ni0xMTcuMDc3IDIyMS40NTdDNjQxLjU3IDg1NC4yODkgNTYzLjEzIDg5Ni40NzggNTEyIDg5Ni40NzhjLTIzLjY4OSAwLTU1LjU3LTkuODk5LTg5LjcwMi0yNy43ODVhNDc4LjgyMiA0NzguODIyIDAgMCAxLTEwNS42MDktNzcuMjc4QzI0Mi4yMSA3MjAuMjEzIDE5OS40NzUgNjM5LjUyMiAxOTkuNDc1IDU2OS44OVYyNTQuMjI1bDIuNzMtMC4xMzZjMy4yNzggMCA4Mi42MDQtMS41MDIgMTY3LjY2NC0zNS45NzdhNzM5Ljk0MiA3MzkuOTQyIDAgMCAwIDE0MC4yMi03NC42MTV2LTAuMDY5eiIgIC8+PHBhdGggZD0iTTcxMy4zMTggMzY4LjY0YTMyLjIyMiAzMi4yMjIgMCAwIDAtNDUuMzI5IDBMNDQ5LjE5NSA1ODcuNDM1bC05My4xODQtOTMuMTE2YTMyLjIyMiAzMi4yMjIgMCAwIDAtNDUuMzMgMCAzMi4yMjIgMzIuMjIyIDAgMCAwIDAgNDUuMjZsMTE1Ljg1IDExNS44NWEzMi4yOSAzMi4yOSAwIDAgMCA0NS4zMjggMEw3MTMuMzIgNDEzLjlhMzIuMjIyIDMyLjIyMiAwIDAgMCAwLTQ1LjMzeiIgIC8+PC9zdmc+)](https://github.com/Kentico/.github/blob/main/SUPPORT.md#full-support) [![CI: Build Validation](https://github.com/Kentico/xperience-module-openai-azure/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Kentico/xperience-module-openai-azure/actions/workflows/ci.yml) [![NuGet Package](https://img.shields.io/nuget/v/Kentico.Xperience.OpenAI.Azure.KX13.svg)](https://www.nuget.org/packages/Kentico.Xperience.OpenAI.Azure.KX13)\n\n\nThis custom module allows Kentico Xperience 13 users to [automatically select](https://docs.kentico.com/x/IgqRBg) the best fitting categories for a page based on its content using [Azure OpenAI](https://azure.microsoft.com/en-us/products/ai-services/openai-service).\n\n## Compatibility\n\nThe integration is usable with Kentico Xperience 13 **hotfix 13.0.142** or newer.\n\n## Installation\n\n1. Install the [Kentico.Xperience.OpenAI.Azure.KX13](https://www.nuget.org/packages/Kentico.Xperience.OpenAI.Azure.KX13) NuGet package in the administration project.\n2. Sign in to your [Azure portal](https://portal.azure.com/).\n3. Create and configure an [Azure OpenAI resource](https://learn.microsoft.com/en-us/azure/ai-services/openai/how-to/create-resource?pivots=web-portal).\n4. [Deploy a model](https://learn.microsoft.com/en-us/azure/ai-services/openai/how-to/create-resource?pivots=web-portal#deploy-a-model).\n5. In Xperience, go to **Settings -\u003e Content -\u003e Azure OpenAI** and configure the settings:\n    - General:\n        - **Azure OpenAI API endpoint:** – value of the **Endpoint** field from **Resource Management -\u003e Keys and Endpoints** of your Azure OpenAI resource in Azure portal.\n        - **Azure OpenAI API key:** – value of either the **KEY 1** or **KEY 2** fields (both keys will work) from **Resource Management -\u003e Keys and Endpoints** of your Azure OpenAI resource in Azure portal.\n    - Content categorization:\n        - Select the **Enable content categorization** option.\n        - **Deployment name** – the **Deployment name** you chose when deploying the model. Can be also found in **Azure OpenAI Studio -\u003e Management -\u003e Deployments**.\n\n    ![Azure OpenAI settings](images/azure_openai_settings.png)\n\n## Automatic selection of categories\n\nAfter you [set up](#installation) the integration, the next time you assign a page into categories you can simply click the **Auto-Select** button and the best fitting categories based on the page's content get automatically selected.\n\n**Important notes:**\n- The automatic selection disregards all preexisting category assignments. Consequently, using the **Auto-Select** on manually categorized pages may suggest a different set of categories for the page. You can always add any desired categories manually on top of the automatic selection.\n- The page you are assigning into categories must have at least some data stored in fields with **Text** or **LongText** data types. That is, the automatic selection doesn't work for pages that are built entirely via Page builder.\n\n![Auto-select categories](images/auto_select.png)\n\n## Contributing\n\nTo see the guidelines for Contributing to Kentico open source software, please see [Kentico's `CONTRIBUTING.md`](https://github.com/Kentico/.github/blob/main/CONTRIBUTING.md) for more information and follow the [Kentico's `CODE_OF_CONDUCT`](https://github.com/Kentico/.github/blob/main/CODE_OF_CONDUCT.md).\n\n## Development environment setup\n\n1. Download/clone this repository.\n2. Copy the `/src/CMS/ConnectionStrings.template.config` file to `/src/CMS/ConnectionStrings.config`.\n3. Add a directory junction of *src/Kentico.Xperience.OpenAI.Azure/CMSResources/Kentico.Xperience.OpenAI.Azure* into *src/CMS/CMSResources* using Command Prompt **(not PowerShell)**:\n\n    `mklink /J .\\src\\CMS\\CMSResources\\Kentico.Xperience.OpenAI.Azure .\\src\\Kentico.Xperience.OpenAI.Azure\\CMSResources\\Kentico.Xperience.OpenAI.Azure`\n4. Open `/src/WebApp.sln`.\n5. Start the *CMSApp* project in IIS Express.\n    - If you encounter a *Could not find a part of the path ... bin\\roslyn\\csc.exe* exception, open the Package Manager Console (Menu -\u003e View -\u003e Other Windows) and run:\n\n        `Update-Package Microsoft.CodeDom.Providers.DotNetCompilerPlatform -r`\n6. Create a database via a web wizard.\n7. Stop the IIS Express process.\n8. Restore database data via `/src/CMS/bin/ContinuousIntegration.exe -r`.\n9. Start the *CMSApp* project in IIS Express.\n10. Go to the *Sites* application.\n11. Start the DancingGoatCore site.\n12. Clear cookies in your browser.\n13. Optional – restart the IIS Express process.\n\n## License\n\nDistributed under the MIT License. See [`LICENSE.md`](./LICENSE.md) for more information.\n\n## Support\n\nSee [`SUPPORT.md`](https://github.com/Kentico/.github/blob/main/SUPPORT.md#full-support) for more information.\n\nFor any security issues see [`SECURITY.md`](https://github.com/Kentico/.github/blob/main/SECURITY.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkentico%2Fxperience-module-openai-azure","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkentico%2Fxperience-module-openai-azure","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkentico%2Fxperience-module-openai-azure/lists"}