About azure-personalizer
azure-personalizer is a reference skill for agents working with Azure AI Personalizer. It combines local quick references and remote documentation on decision-making, configuration, security, troubleshooting, and local inference integration.
Key features
- 01Personalizer troubleshooting
- 02Single-slot and multi-slot choices
- 03Encryption and privacy settings
- 04Learning behavior and model configuration
- 05Local inference SDK integration
Use cases
- 01Diagnose API or model-training issues
- 02Choose a single-slot or multi-slot approach
- 03Configure learning behavior and explainability
- 04Build low-latency offline inference flows
MCP support
The skill can retrieve remote documentation through mcp_microsoftdocs's microsoft_docs_fetch, with fetch_webpage as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-personalizerAfter installing, type/azure-personalizerin Claude Code to confirm it loaded.
Details
From the project READMEAzure AI Personalizer Skill
This skill provides expert guidance for Azure AI Personalizer. Covers troubleshooting, decision making, security, configuration, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.
How to Use This Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,
L35-L120), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
- Preferred: Use
mcp_microsoftdocs:microsoft_docs_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L33-L37 | Diagnosing and fixing common Azure Personalizer issues: API errors, event/Reward calls, model training problems, configuration mistakes, and steps to validate and debug your setup. |
| Decision Making | L38-L42 | Guidance on when to use single-slot vs multi-slot Personalizer, comparing scenarios, behavior, and design tradeoffs for different personalization needs. |
| Security | L43-L48 | Configuring encryption at rest (including customer-managed keys) and controlling data collection, storage, and privacy settings for Azure Personalizer. |
| Configuration | L49-L55 | Configuring Personalizer’s learning behavior: policies, hyperparameters, exploration, apprentice mode, explainability, model export, and learning loop settings. |
| Integrations & Coding Patterns | L56-L59 | Using the Personalizer local inference SDK for low-latency, offline/edge scenarios, including setup, integration patterns, and best practices for calling the model locally. |
Troubleshooting
| Topic | URL |
|---|---|
| Troubleshoot common issues in Azure Personalizer | https://learn.microsoft.com/en-us/azure/ai-services/personalizer/frequently-asked-questions |
Decision Making
| Topic | URL |
|---|---|
| Choose between single-slot and multi-slot Personalizer | https://learn.microsoft.com/en-us/azure/ai-services/personalizer/concept-multi-slot-personalization |
Security
| Topic | URL |
|---|---|
| Configure data-at-rest encryption and CMK for Personalizer | https://learn.microsoft.com/en-us/azure/ai-services/personalizer/encrypt-data-at-rest |
| Manage data usage and privacy in Personalizer | https://learn.microsoft.com/en-us/azure/ai-services/personalizer/responsible-data-and-privacy |
Configuration
| Topic | URL |
|---|---|
| Enable and use inference explainability in Personalizer | https://learn.microsoft.com/en-us/azure/ai-services/personalizer/how-to-inference-explainability |
| Configure apprentice mode learning behavior in Personalizer | https://learn.microsoft.com/en-us/azure/ai-services/personalizer/how-to-learning-behavior |
| Configure Azure Personalizer learning loop settings | https://learn.microsoft.com/en-us/azure/ai-services/personalizer/how-to-settings |
Integrations & Coding Patterns
| Topic | URL |
|---|---|
| Use Personalizer local inference SDK for low latency | https://learn.microsoft.com/en-us/azure/ai-services/personalizer/how-to-thick-client |