mcpField
A
azure-health-bot

azure-health-bot

github.com/microsoftdocsDevelopment796165 installsUpdated 3d ago
Repository

About azure-health-bot

azure-health-bot is an agent skill for people configuring and integrating Azure Health Bot. It combines local reference material with remotely fetched documentation on security, conversation behavior, channels, and APIs.

Key features

  1. 01Healthcare conversation error handling
  2. 02Authentication and privacy guidance
  3. 03Bot scenarios and conversation settings
  4. 04Human and Teams handoff
  5. 05Channel and web chat integrations
  6. 06API and telemetry integrations

Use cases

  1. 01Designing recovery paths for bot errors
  2. 02Managing user consent and data access
  3. 03Setting up human handoff
  4. 04Connecting a bot to messaging channels

MCP support

The skill can fetch Microsoft documentation through the mcp_microsoftdocs microsoft_docs_fetch tool; it also describes 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-health-bot

After installing, type/azure-health-botin Claude Code to confirm it loaded.

Details

From the project README

Azure Health Bot Skill

This skill provides expert guidance for Azure Health Bot. Covers best practices, 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), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools 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_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

CategoryLinesDescription
Best PracticesL32-L36Guidance on designing robust error-handling flows in Azure Health Bot scenarios, including detecting failures, user-friendly recovery paths, and safe handling of clinical conversation errors.
SecurityL37-L50Security, compliance, and privacy for Health Bot: auth providers, end-user auth/consent, data access/deletion, encryption keys, secrets/keys, abuse monitoring, safeguards, and portal permissions
ConfigurationL51-L68Configuring bot behavior and conversations: welcome/help messages, feedback, interruptions, human/Teams handoff, terms links, and managing scenarios, variables, cards, and versions.
Integrations & Coding PatternsL69-L89Integrating Azure Health Bot/Agent with channels (Teams, SMS, WhatsApp, Facebook), embedding web chat, calling/triggering scenarios via APIs/JS, telemetry with App Insights, and enabling voice and clinical safeguards.
Best Practices
TopicURL
Design error handling flows in healthcare bot scenarioshttps://learn.microsoft.com/en-us/azure/health-bot/errorhandling
Security
TopicURL
Set up authentication providers for healthcare agent integrationshttps://learn.microsoft.com/en-us/azure/health-bot/authentication_providers
Configure end-user consent and compliance in healthcare botshttps://learn.microsoft.com/en-us/azure/health-bot/bot_docs/consent
Enable end-user deletion of personal data in healthcare botshttps://learn.microsoft.com/en-us/azure/health-bot/bot_docs/deleting_data
Allow users to view and export personal data from healthcare botshttps://learn.microsoft.com/en-us/azure/health-bot/bot_docs/viewing_data
Configure customer-managed encryption keys for healthcare botshttps://learn.microsoft.com/en-us/azure/health-bot/cmk
Monitor and manage abuse in generative healthcare scenarioshttps://learn.microsoft.com/en-us/azure/health-bot/copilot/abuse-monitoring
Configure health safeguards for generative healthcare agentshttps://learn.microsoft.com/en-us/azure/health-bot/copilot/safeguards
Configure end-user authentication for Healthcare agent servicehttps://learn.microsoft.com/en-us/azure/health-bot/end-user-authentication
Manage secrets, keys, and endpoints in Healthcare agent servicehttps://learn.microsoft.com/en-us/azure/health-bot/keys
Manage portal user permissions with Microsoft Entra IDhttps://learn.microsoft.com/en-us/azure/health-bot/portal-users
Configuration
TopicURL
Configure automatic welcome messages in healthcare botshttps://learn.microsoft.com/en-us/azure/health-bot/automatic_welcome_howto
Configure scenario cancellation behavior in healthcare agentshttps://learn.microsoft.com/en-us/azure/health-bot/bot_docs/cancelling
Configure end-user feedback collection in healthcare botshttps://learn.microsoft.com/en-us/azure/health-bot/bot_docs/feedback
Configure help command behavior in healthcare agentshttps://learn.microsoft.com/en-us/azure/health-bot/bot_docs/help
Configure interruptible scenarios in healthcare conversationshttps://learn.microsoft.com/en-us/azure/health-bot/bot_docs/interruptions
Configure terms and privacy links for healthcare agentshttps://learn.microsoft.com/en-us/azure/health-bot/bot_docs/terms
Configure interrupting scenarios for healthcare conversationshttps://learn.microsoft.com/en-us/azure/health-bot/configuring_interruptions
Configure human handoff in healthcare agent servicehttps://learn.microsoft.com/en-us/azure/health-bot/handoff
Configure Microsoft Teams handoff for healthcare botshttps://learn.microsoft.com/en-us/azure/health-bot/handoff-teams
Configure and use conversation cards in healthcare botshttps://learn.microsoft.com/en-us/azure/health-bot/scenario-authoring/adding-cards
Use and manage instance variables in healthcare scenarioshttps://learn.microsoft.com/en-us/azure/health-bot/scenario-authoring/instance-variables
Manage and organize healthcare bot scenarios in the portalhttps://learn.microsoft.com/en-us/azure/health-bot/scenario-authoring/scenario_management
Use scenario snapshots to manage healthcare bot versionshttps://learn.microsoft.com/en-us/azure/health-bot/scenario-authoring/snapshots
Use resources and static variables in healthcare bot scenarioshttps://learn.microsoft.com/en-us/azure/health-bot/tenant-resources
Integrations & Coding Patterns
TopicURL
Configure Direct Line channel for healthcare agent servicehttps://learn.microsoft.com/en-us/azure/health-bot/channels/directline
Connect healthcare bot to Facebook Messenger and Workplacehttps://learn.microsoft.com/en-us/azure/health-bot/channels/facebook
Integrate healthcare agent service with Dynamics Omnichannelhttps://learn.microsoft.com/en-us/azure/health-bot/channels/oc_channel
Connect healthcare agent service to Microsoft Teamshttps://learn.microsoft.com/en-us/azure/health-bot/channels/teams
Connect healthcare bot to Twilio SMS channelhttps://learn.microsoft.com/en-us/azure/health-bot/channels/twilio
Embed healthcare agent web chat into web applicationshttps://learn.microsoft.com/en-us/azure/health-bot/channels/webchat
Configure WhatsApp via Twilio for healthcare agent servicehttps://learn.microsoft.com/en-us/azure/health-bot/channels/whatsapp
Integrate healthcare bot telemetry with Application Insightshttps://learn.microsoft.com/en-us/azure/health-bot/custom_telemetry
Configure healthcare agent data connections to external APIshttps://learn.microsoft.com/en-us/azure/health-bot/data_connection
Use Clinical Safeguards API with Azure Health Agent Servicehttps://learn.microsoft.com/en-us/azure/health-bot/integrations/clinicalsafeguardsapi
Use healthcare agent service management API for automationhttps://learn.microsoft.com/en-us/azure/health-bot/integrations/managementapi
Invoke healthcare bot scenarios proactively across channelshttps://learn.microsoft.com/en-us/azure/health-bot/integrations/proactive
Invoke healthcare bot scenarios from client-side JavaScripthttps://learn.microsoft.com/en-us/azure/health-bot/integrations/programmatic_invocation
Enable voice interactions in healthcare web chat and appshttps://learn.microsoft.com/en-us/azure/health-bot/integrations/voice
Extend healthcare scenarios with advanced integration elementshttps://learn.microsoft.com/en-us/azure/health-bot/scenario-authoring/advanced_functionality
Extend healthcare scenarios with advanced integration elementshttps://learn.microsoft.com/en-us/azure/health-bot/scenario-authoring/advanced_functionality
Extend healthcare scenarios with advanced integration elementshttps://learn.microsoft.com/en-us/azure/health-bot/scenario-authoring/advanced_functionality
Extend healthcare scenarios with advanced integration elementshttps://learn.microsoft.com/en-us/azure/health-bot/scenario-authoring/advanced_functionality

Comments

Markdown supported