Dev & Engineering ✓ Microsoft · Official azure-bot-servicepython-sdkbot-managementbot-channelsoauth-connectionsazure-identity

Azure Bot Service Python Manager

Create, manage, and configure Azure Bot Service resources and channels from Python.

FollowSkills review · FSRS-2.0
Not recommended
52/ 100 5-point scale 2.6 / 5
Trust17 / 25 · 3.4/5

The documentation recommends DefaultAzureCredential, constrains production credential chains, favors managed identity, advises Key Vault for secrets, and limits enabled channels, showing partial least-privilege and sensitive-data awareness. However, the main example prints a Direct Line key, the main OAuth example still passes a secret placeholder directly, deletion lacks confirmation, rollback, or recovery guidance, and required RBAC permissions and end-to-end data flow are not disclosed, so points are deducted.

Reliability7 / 20 · 1.8/5

Installation, authentication, client lifecycle, and core CRUD/channel flows are organized coherently, while the references identify paging, long-running operations, and error handling as items to verify. Those controls are not implemented or demonstrated, the SDK version is unpinned, abnormal-input and diagnostic behavior are absent, and require_envvar=True may conflict with the claim that local DefaultAzureCredential works as-is; therefore the static score remains conservative.

Adaptability9 / 15 · 3.0/5

The audience, SDK scope, trigger terms, and primary scenarios are reasonably clear, covering bots, channels, and OAuth connections. Boundaries, input/output constraints, and false-trigger conditions are not explicit; asynchronous use is mentioned only as guidance without examples, and Chinese-language usage or mainland-China network reachability is not addressed, so points are deducted.

Convention9 / 15 · 3.0/5

The skill uses layered sections for installation, authentication, scenarios, operation tables, best practices, and references, and includes MIT, author, and version metadata. Repository README, LICENSE, SECURITY.md, CI, and maintenance statements provide governance and update context. The skill nevertheless lacks an SDK compatibility matrix, changelog, FAQ, troubleshooting guidance, named maintenance responsibility, and a clear update path; the references also repeat material.

Effectiveness6 / 15 · 2.0/5

The skill supplies directly adaptable examples for bot creation, retrieval, listing, updating, deletion, channel configuration, and connection settings, covering the core management tasks. It lacks complete production error handling, long-running-operation and paging patterns, idempotency guidance, deletion recovery, and async implementations, and no file-level execution evidence covers this skill’s key paths; substantial manual review remains necessary, so the score is conservatively bounded.

Verifiability4 / 10 · 2.0/5

The skill, reference files, and repository governance files are auditable, and the repository contains CI, evaluation workflows, and test infrastructure. However, the supplied tests do not cover the key Azure Bot Service paths, and there are no skill-specific acceptance criteria, committed execution results, or independent third-party corroboration, leaving static evidence limited.

Evidence confidence:Low Reviewed Jul 20, 2026 Reviewed revision 9ccaf7c3704a
Before you use it
  • Do not print Direct Line keys to logs, terminals, or persistent files; use secure storage and document rotation and revocation.
  • Require explicit confirmation before create, update, or delete operations, and document target scope, required RBAC permissions, and recovery after failure.
  • Verify model names, method signatures, long-running-operation behavior, paging, and SDK compatibility against current azure-mgmt-botservice documentation; this review did not execute the code.
  • For mainland-China users, separately validate network reachability for Azure endpoints, identity sign-in, and dependency installation.
See the full review method →

What it does & when to use it

This skill supports developers using the Azure Bot Service Management SDK for Python. It covers bot creation, retrieval, listing, updates, and deletion, along with channel configuration for Teams, Direct Line, and Web Chat. It also documents Bot Service OAuth connection settings and channel-key operations. The guidance favors DefaultAzureCredential and deterministic client cleanup through context managers.

It shows how to install azure-mgmt-botservice and azure-identity, configure subscription and resource-group environment variables, and call AzureBotService from Python. The examples create, retrieve, list, update, and delete bots; configure Teams, Direct Line, and Web Chat channels; retrieve channel details and keys; and create or list OAuth connection settings. It also covers synchronous clients, DefaultAzureCredential, managed identity, SKU selection, and client lifecycle management.

  1. A Python backend developer provisioning a new Azure Bot Service resource in an Azure subscription.
  2. An Azure engineer inventorying, reading, updating, or removing bots at resource-group or subscription scope.
  3. An application team connecting a bot to Microsoft Teams, Direct Line, or an embeddable Web Chat experience.
  4. A development team configuring OAuth connection settings for a bot, such as access to Microsoft Graph.
  5. A team standardizing identity authentication between local development and production workloads in Azure.

Pros & cons

Pros
  • Covers the core management surface for bots, channels, and OAuth connection settings.
  • Provides copyable Python SDK examples rather than only conceptual guidance.
  • Clearly recommends DefaultAzureCredential, managed identity, and context-managed clients.
  • Includes concrete configuration examples for Teams, Direct Line, and Web Chat.
Limitations
  • It focuses on Azure Bot Service management, not the bot's conversational logic or message-handling application.
  • Examples require an Azure subscription, resource group, and appropriate permissions; specific RBAC roles are not documented.
  • The source does not provide test coverage or a troubleshooting guide for this individual skill.
  • Async usage is described at a principles level but lacks a complete asynchronous business example.

How to install

Install the dependencies:

pip install azure-mgmt-botservice
pip install azure-identity

Place the skill folder in the directory used by your agent. The README documents npx skills add microsoft/skills for installing the collection and selecting skills through a wizard; a standalone installation command for this specific skill is not documented in the source.

How to use

Prompt a coding agent with trigger terms such as azure-mgmt-botservice, AzureBotService, bot management, conversational AI, or bot channels. Before use, set AZURE_SUBSCRIPTION_ID and AZURE_RESOURCE_GROUP; for production use of DefaultAzureCredential, also set AZURE_TOKEN_CREDENTIALS=prod. Then ask the agent to generate or modify Python code, for example: “Create an F0 Azure Bot and enable a Teams channel.”

FAQ

Does this skill build the bot's conversational logic?
No. It primarily manages Azure Bot Service resources, channels, and OAuth connections. The examples reference an application endpoint but do not implement message handling.
Which authentication approach is recommended for production?
Prefer DefaultAzureCredential with `AZURE_TOKEN_CREDENTIALS=prod`, or use a production-appropriate specific credential such as ManagedIdentityCredential.
What Azure configuration is required?
All authentication methods require `AZURE_SUBSCRIPTION_ID` and `AZURE_RESOURCE_GROUP`. The caller also needs sufficient permissions on the target Azure resources, although the source does not name specific roles.
Which channels can it manage?
The source provides examples for Microsoft Teams, Direct Line, and Web Chat, and lists Slack, Facebook, and Email channel types.

More skills from this repository

All from microsoft/agent-skills

Dev & Engineering ✓ Microsoft · Official

Azure Identity for Python

A practical skill for securing Python Azure applications with Microsoft Entra ID credentials.

Dev & Engineering ✓ Microsoft · Official

Azure Event Hubs Java Skill

Build production-oriented Java event streaming applications on Azure Event Hubs.

Dev & Engineering ✓ Microsoft · Official

Azure Tables for Python

A practical guide to building authenticated Azure Tables applications with Python entity CRUD, queries, and partition-scoped batch operations.

Dev & Engineering ✓ Microsoft · Official

Azure Identity for TypeScript

Configure secure, flexible Microsoft Entra ID authentication for TypeScript Azure applications.

Automation & Ops ✓ Microsoft · Official

Azure Reliability Advisor

Assess and improve reliability for Azure Functions and App Service.

Dev & Engineering ✓ Microsoft · Official

Azure Cloud Architect

Guides coding agents through production-grade Azure architecture design and review using Azure Architecture Center practices.

Dev & Engineering ✓ Microsoft · Official

Azure AI Text Analytics for Python

Guides Python developers through Azure-powered text analysis and NLP workflows.

Automation & Ops ✓ Microsoft · Official

Azure Resource Architecture Visualizer

Analyze Azure resource groups and turn their dependencies into detailed Mermaid architecture diagrams.

Dev & Engineering ✓ Microsoft · Official

Azure Maps for .NET

Build .NET location features for search, routing, maps, geolocation, and weather.

Dev & Engineering ✓ Microsoft · Official

Azure AI Vision Image Analysis

Guides Python coding agents in implementing Azure AI Vision image understanding.

Dev & Engineering ✓ Microsoft · Official

Azure Blob Storage for Python

Guides secure, production-minded Blob Storage operations in Python.

Dev & Engineering ✓ Microsoft · Official

Azure Queue Storage for Python

Gives coding agents reliable Python patterns for secure Azure Queue Storage messaging and asynchronous task processing.

Automation & Ops ✓ Microsoft · Official

Azure AI Gateway Governance

Use Azure API Management to govern traffic across AI models, MCP tools, and agents.

Automation & Ops ✓ Microsoft · Official

AKS Automatic Readiness

Assess Kubernetes workloads for AKS Automatic compatibility and identify migration blockers before you switch.

Dev & Engineering ✓ Microsoft · Official

Azure Cosmos DB ARM for .NET

Provision and manage Azure Cosmos DB resources from .NET through ARM.

Dev & Engineering ✓ Microsoft · Official

Azure Playwright Workspace Manager

Provision and manage Microsoft Playwright Testing workspaces with .NET and Azure Resource Manager.

Dev & Engineering ✓ Microsoft · Official

Azure Cosmos DB for Python

A practical guide for building reliable Python applications on Azure Cosmos DB’s NoSQL API.

Dev & Engineering ✓ Microsoft · Official

Azure Key Vault SDK for Python

Gives Python coding agents practical guidance for securely managing Azure Key Vault secrets, keys, and certificates.

Dev & Engineering ✓ Microsoft · Official

Azure API Management for Python

Gives coding agents practical Python SDK patterns for managing Azure API Management services, APIs, products, subscriptions, and policies.

Dev & Engineering ✓ Microsoft · Official

Azure Monitor Query for Python

Generate Python code for querying Azure Monitor logs and metrics.

Related skills