Teams App Developer

MicrosoftOfficialPublished by Microsoft

Skill
Tool integration
Software development
MIT
Medium risk

From the author

Builds, tests, and deploys Microsoft 365 apps and agents for Teams and Copilot. Includes sub-skills for project creation, local testing, cloud deployment, troubleshooting, and Slack-to-Teams migration. USE FOR: Teams agent, bot, tab, message extension, Declarative Agents, Custom Engine Agents, local testing, Agents Playground, Azure resource provision, remote deployment, Slack to Teams migration, cross-platform bot development, Block Kit to Adaptive Cards conversion. DO NOT USE FOR: general web development, non-bot/non-Teams projects.

— the description by Microsoft

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The teams-app-developer skill provides a structured framework for managing the lifecycle of Microsoft 365 agents and Teams applications. It leverages the ATK CLI to handle project scaffolding, local testing via the Agents Playground, cloud provisioning on Azure, and troubleshooting. The skill includes specialized guidance for migrating Slack bots to Teams, including converting Block Kit UI to Adaptive Cards, and provides access to an extensive library of micro-expert documentation for cross-platform development.

What it does

Scaffolds new Microsoft 365 agents and Teams applications from templates.
Facilitates local testing using the Agents Playground or Teams-specific environments.
Automates Azure resource provisioning and cloud deployment workflows.
Provides diagnostic procedures for common authentication and configuration errors.
Supports migration of Slack bots to the Teams platform.
Manages project configuration and environment variables for ATK-based projects.

When to use it

When starting a new Teams app, bot, or Declarative Agent project.
When you need to test an agent locally before deploying to the cloud.
When migrating existing Slack bots to the Microsoft Teams ecosystem.
When troubleshooting deployment or authentication issues in a Teams project.
When you need to provision Azure infrastructure for a Teams application.

Advantages

Streamlines the development lifecycle with standardized CLI commands.
Reduces development time by offering a local testing playground.
Provides expert-level guidance for complex cross-platform migrations.
Ensures consistent configuration management across development environments.
Includes robust error-handling protocols for common platform-specific pitfalls.

Usage examples

“Create a new Teams bot project using the default template.”: The agent will initialize a new project folder, configure the necessary YAML files, and guide you through the initial setup using the ATK CLI.
“How do I migrate my Slack bot to Microsoft Teams?”: The agent will initiate the slack-to-teams workflow, providing access to cross-platform bridging experts and guidance on converting UI components.
“My Teams bot is returning a 401 error, how do I fix it?”: The agent will trigger the troubleshooting workflow, checking your environment variables, tunnel status, and authentication configuration.

Install

Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/microsoft/teams-app-developer/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip teams-app-developer.zip -d .agents/skills

Documentation by Microsoft

Microsoft 365 Agents Toolkit Skill

Build Microsoft 365 agents and Teams apps using the ATK CLI.

AI Behavior Guidelines

Testing Strategy: Recommend Agents Playground first (faster, no M365 needed). Use Teams workflow only if user explicitly requests it.
Environment Variables: NEVER hardcode secrets or make up placeholder values. Always ask users for real values.
Error Handling: Read error messages carefully. Check env/.env.local, .localConfigs, and atk auth list. Common pitfalls:
- AADSTS7000229 → aadApp/create missing generateServicePrincipal: true in YAML — add it and re-provision
- Missing TENANT_ID in .localConfigs → SDK uses wrong token authority → 401 from Bot Connector
- 401 persists after auth fix → devtunnel URL may be blacklisted — create a fresh tunnel
- See troubleshoot/troubleshoot.md for full diagnostic steps
Long-Running Commands — WAIT for completion:
- atk new, atk provision, atk deploy can take several minutes
- Always wait for completion before running the next step (timeout 120000ms+)
Local Service Startup — Hangs terminal (expected):
- npm run dev, npm start, python app.py, devtunnel host, etc. will hang — the process keeps running indefinitely
- ALWAYS run as a background process (isBackground=true) — NEVER use isBackground=false for these commands
- Do NOT wait for it to "finish" — verify startup by checking output for "listening on port" or tunnel URL
- If errors appear, read logs, diagnose, fix, restart
- Use a NEW terminal to launch Agents Playground or open Teams sideloading URL
Monitor App Logs: Periodically check background terminal output for runtime errors. If the app crashes, read the error, fix the root cause, and restart.
Telemetry Tagging: Before running any atk CLI commands, set the session environment variable so all CLI invocations are tagged as skill-initiated:
```
export ATK_CLI_SKILL=true
```
Run this once at the start of the session. All subsequent atk commands in the same terminal will inherit it.

ATK CLI Setup

atk --version  # Must be > 1.1.5-beta

If ATK is not found or version is too old:

npm i -g @microsoft/m365agentstoolkit-cli@beta

CLI Global Options

Option	Meaning	Recommendation
`-i`	Interactive mode	Always use `-i false` in automation to avoid hanging
`-f`	Project folder	Default to be current directory, used when specifying a custom folder. When scaffolding a new project, this is the parent folder where the project folder will be created under.
`-h`	Command help	Use `atk <command> -h` for quick syntax checks

Sub-Skills

Sub-Skill	When to Use	Reference
create-project	Scaffold new project from template, choose template, `atk new`	create-project/create-project.md
test-playground	Test locally with Agents Playground, `agentsplayground`, quick testing	test-playground/test-playground.md
test-teams	Run on Teams, devtunnel, sideload, Teams testing, test in Copilot	test-teams/test-teams.md
provision-deploy	Provision Azure resources, deploy to cloud, `atk provision`, `atk deploy`	provision-deploy/provision-deploy.md
troubleshoot	Fix errors, 401, port conflicts, YAML errors, stale bots	troubleshoot/troubleshoot.md
slack-to-teams	Migrate Slack bot to Teams, cross-platform bridging, Block Kit to Adaptive Cards	slack-to-teams/SKILL.md

MANDATORY: Before executing any workflow, read the corresponding sub-skill document.

Shared References

manifest-and-yaml.md — Project files, YAML config, env vars, .localConfigs flow
commands.md — ATK CLI commands: package, validate, share, collaborate
templates.md — Complete template catalog with language support
experts/ — 100+ micro-expert files: Teams SDK, Slack SDK, cross-platform bridging, deploy, AI models, security, language conversion
docs/ — Platform comparison guides: UI, messaging, identity, infrastructure, feature gaps

Workflow Chains

Match user intent to the smallest valid workflow.

User Intent	Workflow (read in order)
Build new app from scratch	create-project → test-playground
Test existing project locally	test-playground (recommended) or test-teams
Deploy to Azure	provision-deploy
Fix broken bot	troubleshoot → re-test
Migrate Slack bot to Teams	slack-to-teams

MANDATORY: Before executing any slack-to-teams workflow, read slack-to-teams/SKILL.md first. The sub-skill contains a routed expert system with 100+ micro-expert files for cross-platform bot development.

ATK Project Context Resolution

Resolve config values only when missing. If a value is already known in the session, reuse it.

Step 1: Detect ATK Project

If m365agentstoolkit*.yml exists in the current folder, treat it as an ATK project and parse configuration.

Step 2: Resolve Common Configuration

Resolve variables referenced in m365agentstoolkit*.yml. Common variables: AZURE_OPENAI_API_KEY AZURE_OPENAI_ENDPOINT AZURE_OPENAI_DEPLOYMENT_NAME

Step 3: Collect Missing Values

If required values are missing, ask the user for only the missing ones.

Refer to manifest-and-yaml.md for full config-file details.

Files

ATTRIBUTION.mdAdded by AutoGineer906 B
LICENSELicence file added by AutoGineer1.1 KiB
SKILL.md7.6 KiB
create-project/create-project.md8.1 KiB
docs/README.md2.8 KiB
docs/advanced-features.md7.0 KiB
docs/feature-gaps.md46.3 KiB
docs/files-and-links.md4.2 KiB
docs/identity-and-auth.md4.3 KiB
docs/infrastructure.md6.7 KiB
docs/interactive-responses.md4.4 KiB
docs/messaging-and-commands.md4.5 KiB
docs/middleware-and-handlers.md4.4 KiB
docs/ui-components.md6.9 KiB
docs/workflows.md14.4 KiB
experts/README.md8.6 KiB
experts/_expert-ts.md2.2 KiB
experts/analyzer.md14.0 KiB
experts/bridge/app-distribution-packaging-ts.md14.2 KiB
experts/bridge/channel-ops-graph-ts.md15.4 KiB
experts/bridge/commands-slash-text-ts.md18.5 KiB
experts/bridge/cross-platform-advisor-ts.md36.4 KiB
experts/bridge/cross-platform-architecture-ts.md8.3 KiB
experts/bridge/events-activities-ts.md22.4 KiB
experts/bridge/files-upload-download-ts.md17.2 KiB
experts/bridge/identity-oauth-bridge-ts.md19.8 KiB
experts/bridge/index.md13.0 KiB
experts/bridge/infra-compute-ts.md14.6 KiB
experts/bridge/infra-observability-ts.md14.0 KiB
experts/bridge/infra-secrets-config-ts.md13.2 KiB
experts/bridge/infra-storage-ts.md14.3 KiB
experts/bridge/interactive-responses-ts.md19.6 KiB
experts/bridge/link-unfurl-preview-ts.md17.1 KiB
experts/bridge/middleware-handlers-ts.md15.4 KiB
experts/bridge/python-cross-platform.md9.3 KiB
experts/bridge/rate-limiting-resilience-ts.md17.6 KiB
experts/bridge/rest-only-integration-ts.md8.4 KiB
experts/bridge/scheduling-deferred-send-ts.md17.8 KiB
experts/bridge/shortcuts-extensions-ts.md17.5 KiB
experts/bridge/transport-socketmode-https-ts.md14.3 KiB
experts/bridge/ui-app-home-personal-tab-ts.md14.5 KiB
experts/bridge/ui-block-kit-adaptive-cards-ts.md21.5 KiB
experts/bridge/ui-legacy-attachments-cards-ts.md11.2 KiB
experts/bridge/ui-modals-dialogs-ts.md21.4 KiB
experts/bridge/workflow.composable-platform-ts.md13.7 KiB
experts/bridge/workflows-automation-ts.md14.3 KiB
experts/builder.md11.1 KiB
experts/convert/bulk-conversion-strategy-ts.md12.8 KiB
experts/convert/dependency-mapping-ts.md8.3 KiB
experts/convert/index.md3.5 KiB
experts/convert/java-to-ts-ts.md20.6 KiB
experts/convert/js-to-ts-ts.md6.2 KiB
experts/convert/json-serialization-ts.md11.0 KiB
experts/convert/kotlin-to-ts-ts.md11.2 KiB
experts/convert/ruby-to-ts-ts.md9.7 KiB
experts/convert/type-mapping-ts.md10.1 KiB
experts/deploy/aws-bot-deploy-ts.md14.6 KiB
experts/deploy/aws-cli-reference-ts.md52.4 KiB
experts/deploy/azure-bot-deploy-ts.md15.4 KiB
experts/deploy/azure-cli-reference-ts.md16.9 KiB
experts/deploy/index.md4.6 KiB
experts/fallback.md2.1 KiB
experts/index.md18.9 KiB
experts/models/anthropic-ts.md7.8 KiB
experts/models/bedrock-ts.md9.9 KiB
experts/models/foundry-cloud-ts.md8.1 KiB
experts/models/foundry-local-ts.md10.6 KiB
experts/models/index.md5.8 KiB
experts/models/openai-azure-openai-ts.md8.3 KiB
experts/models/oss-openai-compatible-ts.md10.7 KiB
experts/models/transformers-js-ts.md11.6 KiB
experts/prompt-engineer.md14.7 KiB
experts/researcher.md2.8 KiB
experts/security/index.md1.2 KiB
experts/security/input-validation-ts.md13.8 KiB
experts/security/secrets-ts.md13.9 KiB
experts/slack/bolt-assistant-ts.md9.9 KiB
experts/slack/bolt-events-ts.md9.3 KiB
experts/slack/bolt-java.md8.9 KiB
experts/slack/bolt-oauth-distribution-ts.md10.9 KiB
experts/slack/bolt-python.md9.5 KiB
experts/slack/cli.app-management.md7.9 KiB
experts/slack/cli.datastore-env.md8.6 KiB
experts/slack/cli.getting-started.md8.0 KiB
experts/slack/cli.local-dev-deploy.md8.4 KiB
experts/slack/cli.manifest-triggers.md9.9 KiB
experts/slack/index.md8.9 KiB
experts/slack/runtime.ack-rules-ts.md9.8 KiB
experts/slack/runtime.bolt-foundations-ts.md10.7 KiB
experts/slack/runtime.shortcuts-ts.md11.0 KiB
experts/slack/runtime.slash-commands-ts.md11.6 KiB
experts/slack/runtime.socket-mode-ts.md9.5 KiB
experts/slack/ui.block-kit-ts.md11.5 KiB
experts/slack/ui.modals-lifecycle-ts.md13.3 KiB
experts/slack/web-api-proactive-ts.md11.0 KiB
experts/slack/workflow.slack-automations-ts.md10.2 KiB
experts/teams/a2a.client-basics-ts.md9.7 KiB
experts/teams/a2a.orchestrator-patterns-ts.md12.7 KiB
experts/teams/a2a.server-basics-ts.md11.4 KiB
experts/teams/ai.chatprompt-basics-ts.md8.1 KiB
experts/teams/ai.citations-feedback-ts.md6.9 KiB
experts/teams/ai.conversational-query-ts.md14.2 KiB
experts/teams/ai.function-calling-design-ts.md9.0 KiB
experts/teams/ai.function-calling-implementation-ts.md7.7 KiB
experts/teams/ai.memory-localmemory-ts.md7.3 KiB
experts/teams/ai.model-setup-ts.md6.6 KiB
experts/teams/ai.rag-retrieval-ts.md7.4 KiB
experts/teams/ai.rag-vectorstores-ts.md8.5 KiB
experts/teams/ai.streaming-ts.md6.9 KiB
experts/teams/auth.oauth-sso-ts.md10.1 KiB
experts/teams/compat.botbuilder-interop-ts.md14.6 KiB
experts/teams/dev.debug-test-ts.md14.1 KiB
experts/teams/graph.usergraph-appgraph-ts.md9.0 KiB
experts/teams/index.md9.8 KiB
experts/teams/mcp.client-basics-ts.md9.5 KiB
experts/teams/mcp.expose-chatprompt-tools-ts.md9.5 KiB
experts/teams/mcp.security-ts.md10.4 KiB
experts/teams/mcp.server-basics-ts.md9.9 KiB
experts/teams/project.scaffold-files-ts.md12.2 KiB
experts/teams/runtime.app-init-ts.md10.9 KiB
experts/teams/runtime.manifest-ts.md12.3 KiB
experts/teams/runtime.proactive-messaging-ts.md12.6 KiB
experts/teams/runtime.routing-handlers-ts.md12.3 KiB
experts/teams/state.storage-patterns-ts.md9.4 KiB
experts/teams/teams-dotnet.md8.2 KiB
experts/teams/teams-python.md8.3 KiB
experts/teams/ui.adaptive-cards-ts.md12.9 KiB
experts/teams/ui.dialogs-task-modules-ts.md15.1 KiB
experts/teams/ui.message-extensions-ts.md15.6 KiB
experts/teams/workflow.approvals-inline-ts.md12.4 KiB
experts/teams/workflow.message-native-records-ts.md10.6 KiB
experts/teams/workflow.sharepoint-lists-ts.md9.0 KiB
experts/teams/workflow.state-driven-events-ts.md12.2 KiB
experts/teams/workflow.triggers-compose-ts.md10.3 KiB
experts/update-experts.md10.0 KiB
provision-deploy/provision-deploy.md4.3 KiB
test-playground/playground-cli.md4.6 KiB
test-playground/playground.md4.5 KiB
test-playground/test-playground.md1.1 KiB
test-teams/test-teams.md4.9 KiB
toolkit/README.md4.2 KiB
toolkit/commands.md2.6 KiB
toolkit/environments.md12.6 KiB
toolkit/lifecycle-cli.md17.6 KiB
toolkit/manifest-and-yaml.md6.0 KiB
toolkit/playground.md7.6 KiB
toolkit/publish.md9.3 KiB
toolkit/templates.md6.7 KiB
troubleshoot/troubleshoot.md20.2 KiB

experts/deploy/azure-cli-reference-ts.md

azure-cli-reference-ts

purpose

Comprehensive reference of all Azure CLI (az) command groups a developer needs for creating, reading, updating, and deleting resources in a bot or AI agent project on Azure. Use as a lookup companion to azure-bot-deploy-ts.md (step-by-step deployment) — this file maps every relevant CLI surface so you know what commands exist.

rules

This is a reference, not a tutorial. For step-by-step deployment walkthroughs, see azure-bot-deploy-ts.md. This file catalogs every az command group relevant to bot/agent projects.
Always authenticate first. Every command below assumes you have run az login and az account set --subscription <id>. learn.microsoft.com/cli/azure/authenticate-azure-cli
Resource group is required for almost everything. Most commands take --resource-group <rg>. Create one with az group create before provisioning any resources.

1. Bot Service (`az bot`)

The core resource for registering and managing a bot on Azure.

Command	Purpose
`az bot create`	Register a new v4 SDK bot (requires `--app-type`, `--appid`, `--name`, `--resource-group`)
`az bot show`	Get bot details
`az bot update`	Update bot properties (endpoint, description, display name)
`az bot delete`	Delete a bot registration
`az bot download`	Download bot source code
`az bot publish`	Publish to the bot's associated App Service
`az bot prepare-deploy`	Add deployment config files

Reference: learn.microsoft.com/cli/azure/bot

Bot Channels

Connect a bot to messaging platforms. Each channel group has create, delete, show sub-commands:

Channel Group	Platform
`az bot msteams`	Microsoft Teams
`az bot slack`	Slack
`az bot directline`	DirectLine (web/custom clients)
`az bot webchat`	Web Chat embed
`az bot facebook`	Facebook Messenger
`az bot telegram`	Telegram
`az bot email`	Email
`az bot sms`	SMS
`az bot kik`	Kik
`az bot skype`	Skype

Reference: learn.microsoft.com/cli/azure/bot/msteams

Bot Auth (`az bot authsetting`)

Manage OAuth connection settings on a bot:

Command	Purpose
`az bot authsetting create`	Create an OAuth connection
`az bot authsetting show`	View a connection
`az bot authsetting list`	List all connections
`az bot authsetting delete`	Delete a connection
`az bot authsetting list-providers`	List available OAuth providers

Reference: learn.microsoft.com/cli/azure/bot/authsetting

2. AI Foundry Agents (`az cognitiveservices agent`)

For hosted AI agents via Azure AI Foundry:

Command	Purpose
`az cognitiveservices agent create`	Create hosted agent from container image or source
`az cognitiveservices agent show`	Get agent details
`az cognitiveservices agent update`	Update agent deployment
`az cognitiveservices agent delete`	Delete agent version(s)
`az cognitiveservices agent list`	List agents
`az cognitiveservices agent list-versions`	List all versions of an agent
`az cognitiveservices agent start`	Start agent deployment
`az cognitiveservices agent stop`	Stop agent deployment
`az cognitiveservices agent status`	Check deployment status
`az cognitiveservices agent delete-deployment`	Delete a deployment
`az cognitiveservices agent logs`	View container logs

Reference: learn.microsoft.com/cli/azure/cognitiveservices/agent

3. Azure OpenAI / Cognitive Services (`az cognitiveservices account`)

Manage the AI backend your bot/agent calls:

Command	Purpose
`az cognitiveservices account create`	Create an Azure OpenAI / Cognitive Services account
`az cognitiveservices account show`	View account details
`az cognitiveservices account update`	Update account settings
`az cognitiveservices account delete`	Delete account
`az cognitiveservices account list`	List all accounts in subscription
`az cognitiveservices account keys list`	Get API keys
`az cognitiveservices account keys regenerate`	Rotate keys
`az cognitiveservices account deployment create`	Deploy a model (e.g., GPT-4o)
`az cognitiveservices account deployment show`	View deployment
`az cognitiveservices account deployment list`	List deployments
`az cognitiveservices account deployment delete`	Remove deployment
`az cognitiveservices model list`	List available models

Reference: learn.microsoft.com/cli/azure/cognitiveservices/account

4. App Registration / Identity (`az ad app`, `az ad sp`, `az identity`)

Every bot needs an app registration for authentication.

App Registration (`az ad app`)

Command	Purpose
`az ad app create`	Create Entra ID app registration (gets the appId for bot)
`az ad app show`	View app details
`az ad app update`	Update app properties
`az ad app delete`	Delete app registration
`az ad app list`	List apps
`az ad app credential reset`	Reset password/certificate
`az ad app credential list`	List credentials
`az ad app credential delete`	Remove a credential
`az ad app permission`	Manage OAuth2 API permissions

Reference: learn.microsoft.com/cli/azure/ad/app

Managed Identity (`az identity`)

Command	Purpose
`az identity create`	Create a user-assigned managed identity
`az identity show`	View identity details
`az identity list`	List identities
`az identity delete`	Delete identity

Reference: learn.microsoft.com/cli/azure/identity

Role Assignments (`az role assignment`)

Command	Purpose
`az role assignment create`	Grant a role (e.g., "Cognitive Services OpenAI User")
`az role assignment list`	List current assignments
`az role assignment delete`	Revoke a role

Reference: learn.microsoft.com/cli/azure/role/assignment

5. Hosting / Compute

Web App (`az webapp`)

Traditional bot hosting on App Service:

Command	Purpose
`az webapp create`	Create App Service for bot
`az webapp show` / `list` / `delete` / `update`	Standard CRUD
`az webapp start` / `stop` / `restart`	Lifecycle management
`az webapp deploy`	Deploy artifact (zip, war, jar)
`az webapp up`	Create + deploy from local workspace
`az webapp deployment source`	Configure source control deployment
`az webapp deployment github-actions`	Configure CI/CD via GitHub Actions
`az webapp deployment slot`	Manage staging slots
`az webapp config`	App settings, connection strings, runtime
`az webapp identity`	Assign managed identity to web app
`az webapp log`	View/configure logs

Reference: learn.microsoft.com/cli/azure/webapp

App Service Plan (`az appservice plan`)

Command	Purpose
`az appservice plan create`	Create hosting plan (defines SKU/pricing tier)
`az appservice plan show` / `list` / `update` / `delete`	Standard CRUD

Reference: learn.microsoft.com/cli/azure/appservice/plan

Function App (`az functionapp`)

Serverless bot hosting:

Command	Purpose
`az functionapp create`	Create a function app
`az functionapp show` / `list` / `delete` / `update`	Standard CRUD
`az functionapp start` / `stop` / `restart`	Lifecycle
`az functionapp deploy`	Deploy artifact
`az functionapp config`	App settings, runtime config
`az functionapp identity`	Managed identity
`az functionapp keys`	Manage function keys
`az functionapp log`	View logs

Reference: learn.microsoft.com/cli/azure/functionapp

Container App (`az containerapp`)

Containerized bot hosting:

Command	Purpose
`az containerapp create`	Create container app
`az containerapp show` / `list` / `delete` / `update`	Standard CRUD
`az containerapp up`	Create + deploy (handles ACR, env, etc.)
`az containerapp env`	Manage Container Apps environments
`az containerapp secret`	Manage secrets
`az containerapp identity`	Managed identity
`az containerapp ingress`	Configure ingress / traffic
`az containerapp revision`	Manage revisions
`az containerapp logs`	View logs
`az containerapp job`	Manage background jobs

Reference: learn.microsoft.com/cli/azure/containerapp

6. Infrastructure & Resource Management

Resource Groups (`az group`)

Command	Purpose
`az group create`	Create resource group (logical container for all bot resources)
`az group show` / `list` / `delete` / `update`	Standard CRUD
`az group exists`	Check existence
`az group export`	Export as ARM template

Reference: learn.microsoft.com/cli/azure/group

Subscriptions (`az account`)

Command	Purpose
`az account list`	List subscriptions
`az account set`	Switch active subscription
`az account show`	Show current subscription

Reference: learn.microsoft.com/cli/azure/account

7. Secrets & Configuration (`az keyvault`)

Command	Purpose
`az keyvault create` / `show` / `list` / `delete`	Vault CRUD
`az keyvault secret set`	Store a secret (API keys, connection strings)
`az keyvault secret show`	Retrieve a secret
`az keyvault secret list`	List secrets
`az keyvault secret delete`	Delete a secret
`az keyvault set-policy`	Grant access to the bot's identity

Reference: learn.microsoft.com/cli/azure/keyvault

8. Storage & State

Storage Account (`az storage account`)

For bot state and blob storage:

Command	Purpose
`az storage account create`	Create storage account
`az storage account show` / `list` / `delete` / `update`	Standard CRUD
`az storage account show-connection-string`	Get connection string
`az storage account keys list`	Get access keys

Reference: learn.microsoft.com/cli/azure/storage/account

Cosmos DB (`az cosmosdb`)

For bot conversation state:

Command	Purpose
`az cosmosdb create`	Create Cosmos DB account
`az cosmosdb show` / `list` / `delete` / `update`	Standard CRUD
`az cosmosdb keys list`	Get access keys
`az cosmosdb sql database create`	Create a SQL API database
`az cosmosdb sql container create`	Create a container

Reference: learn.microsoft.com/cli/azure/cosmosdb

9. Monitoring & Diagnostics (`az monitor`)

Command	Purpose
`az monitor log-analytics workspace create`	Create Log Analytics workspace
`az monitor diagnostic-settings create`	Enable diagnostics on bot resources
`az monitor metrics list`	View resource metrics
`az monitor activity-log list`	View activity logs
`az monitor action-group create`	Set up alert notifications

Reference: learn.microsoft.com/cli/azure/monitor

patterns

Minimum viable bot/agent CRUD flow

The numbered steps below show the typical order for provisioning a complete bot project from scratch using only az commands:

# 1. Resource group
az group create --name rg-mybot --location eastus

# 2. App registration + secret
APP_ID=$(az ad app create --display-name "MyBot" --query appId -o tsv)
APP_SECRET=$(az ad app credential reset --id $APP_ID --query password -o tsv)
TENANT_ID=$(az account show --query tenantId -o tsv)

# 3. Hosting plan
az appservice plan create --resource-group rg-mybot --name mybot-plan --sku B1 --is-linux

# 4. Web app (or functionapp / containerapp)
az webapp create --resource-group rg-mybot --plan mybot-plan --name mybot-app --runtime "NODE:20-lts"

# 5. Bot registration
az bot create --resource-group rg-mybot --name mybot-bot \
  --app-type SingleTenant --appid $APP_ID --tenant-id $TENANT_ID

# 6. Connect channels
az bot msteams create --resource-group rg-mybot --name mybot-bot
# az bot slack create --resource-group rg-mybot --name mybot-bot ...

# 7. AI backend (Azure OpenAI)
az cognitiveservices account create --resource-group rg-mybot --name mybot-openai \
  --kind OpenAI --sku S0 --location eastus
az cognitiveservices account deployment create --resource-group rg-mybot \
  --name mybot-openai --deployment-name gpt-4o \
  --model-name gpt-4o --model-version "2024-08-06" --model-format OpenAI \
  --sku-name Standard --sku-capacity 10

# 8. Secrets management
az keyvault create --resource-group rg-mybot --name mybot-kv --location eastus
az keyvault secret set --vault-name mybot-kv --name "AppSecret" --value "$APP_SECRET"

# 9. Wire up permissions (managed identity → OpenAI)
az webapp identity assign --resource-group rg-mybot --name mybot-app
PRINCIPAL_ID=$(az webapp identity show --resource-group rg-mybot --name mybot-app --query principalId -o tsv)
OPENAI_ID=$(az cognitiveservices account show --resource-group rg-mybot --name mybot-openai --query id -o tsv)
az role assignment create --assignee $PRINCIPAL_ID \
  --role "Cognitive Services OpenAI User" --scope $OPENAI_ID

# 10. Observability
az monitor diagnostic-settings create --resource rg-mybot/mybot-app \
  --name mybot-diag --logs '[{"enabled":true,"category":"AppServiceHTTPLogs"}]' \
  --workspace <log-analytics-workspace-id>

Teardown (delete everything)

# Delete the entire resource group and all resources within it
az group delete --name rg-mybot --yes --no-wait

# Delete the app registration separately (it lives in Entra ID, not the resource group)
az ad app delete --id $APP_ID

List all resources in a bot project

# See everything in the resource group
az resource list --resource-group rg-mybot --output table

# Check bot channel connections
az bot show --resource-group rg-mybot --name mybot-bot --query "properties.enabledChannels"

# Check OpenAI deployments
az cognitiveservices account deployment list --resource-group rg-mybot --name mybot-openai --output table

pitfalls

App Registration lives outside the resource group. Deleting the resource group does not delete the Entra ID app registration. Always clean up with az ad app delete --id <appId> separately.
Key Vault soft-delete. Deleted vaults are retained for 90 days by default. Recreating a vault with the same name fails until you purge it: az keyvault purge --name <vault-name>.
Cognitive Services region availability. Not all Azure OpenAI models are available in all regions. Check az cognitiveservices model list --location <region> before creating the account.
Role assignment propagation delay. After az role assignment create, it can take up to 5 minutes for the assignment to propagate. If your bot gets 403 errors immediately after setup, wait and retry.
Managed identity vs app secret. Prefer managed identity (az webapp identity assign) over storing MicrosoftAppPassword in app settings. Managed identities rotate automatically and never expire.
Container Apps require an environment. You must create a Container Apps environment (az containerapp env create) before creating a container app. The environment defines the Log Analytics workspace and networking.

instructions

This expert is a reference catalog of all Azure CLI commands relevant to bot and agent development. Use it when a developer asks "what az commands do I need for X?" or needs to look up the CLI surface for a specific Azure service. For step-by-step deployment instructions, defer to azure-bot-deploy-ts.md.

Pair with: azure-bot-deploy-ts.md (step-by-step deployment), ../security/secrets-ts.md (secrets best practices), ../bridge/infra-compute-ts.md (compute comparisons).

research

Deep Research prompt:

"Catalog all Azure CLI (az) command groups a developer would need for creating, reading, updating, and deleting resources in a bot/agent project on Azure. Include: bot service (az bot), bot channels, bot auth settings, AI Foundry agents (az cognitiveservices agent), Azure OpenAI (az cognitiveservices account), app registration (az ad app), managed identity (az identity), role assignments, hosting (webapp, functionapp, containerapp), resource groups, subscriptions, Key Vault, storage accounts, Cosmos DB, and monitoring. For each group, list the key CRUD commands and their purpose."

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs an API key, Needs Python, Needs Node.js

Security

What our scanner noticed· Medium risk

Possible data-exfiltration endpoints
Instructions that use the network
Downloads piped into a shell

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by

Microsoft

Publisher

Microsoft (Official)

Source

microsoft/skills · .github/plugins/microsoft-365-agents-toolkit/skills/teams-app-developer · commit 0696600

Licence

MIT License (redistribution allowed)

LICENSE (added by AutoGineer from LICENSE)
ATTRIBUTION.md (written by AutoGineer)

Synced

2026-11-08

AutoGineer is not affiliated with or endorsed by Microsoft.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download teams-app-developer.zip

From the author

AutoGineer summary

What it does

When to use it

Advantages

Usage examples

Install

Documentation by Microsoft

Microsoft 365 Agents Toolkit Skill

AI Behavior Guidelines

ATK CLI Setup

CLI Global Options

Sub-Skills

Shared References

Workflow Chains

ATK Project Context Resolution

Step 1: Detect ATK Project

Step 2: Resolve Common Configuration

Step 3: Collect Missing Values

Files

experts/deploy/azure-cli-reference-ts.md

azure-cli-reference-ts

purpose

rules

1. Bot Service (az bot)

Bot Channels

Bot Auth (az bot authsetting)

2. AI Foundry Agents (az cognitiveservices agent)

3. Azure OpenAI / Cognitive Services (az cognitiveservices account)

4. App Registration / Identity (az ad app, az ad sp, az identity)

App Registration (az ad app)

Managed Identity (az identity)

Role Assignments (az role assignment)

5. Hosting / Compute

Web App (az webapp)

App Service Plan (az appservice plan)

Function App (az functionapp)

Container App (az containerapp)