Azure / Azure/azure-dev

Generate a ready-to-sideload Teams app package during azd deploy for activity-protocol agents

Open
#9,333 0 comments 0 reactions 0 assignees View on GitHub
enhancement ext-agents
Dominant language
Go
Stars
569
Forks
364
Avg merge
2d 19h
Merged PRs (30d)
136

Description

### Summary

For activity-protocol (Teams) hosted agents, `azd deploy` currently creates the Azure Bot + Teams channel and writes a `TEAMS_APP_SETUP.md` guide, but the user still has to assemble a Teams app package (manifest, icons, bot entry) by hand before they can sideload and try the agent in Teams.

### Proposal

After the bot is created, have the `azure.ai.agents` extension call the Foundry Microsoft 365 packaging API (`POST /agents/{name}/microsoft365/zip`) to download a ready-to-sideload Teams app package (`appPackage.zip`) next to the agent source, and update the setup guide to lead with sideloading that package (Teams UI upload or `atk install --scope Personal`, no Teams admin needed).

### Scope

- Activity-protocol agents only; non-activity deploys unaffected.
- Best-effort: packaging failures never fail the deploy; the guide falls back to manual packaging steps.
- Publishing to the org catalog (Shared/Tenant, admin-gated) is out of scope.

Tracking issue for the change in the linked PR.

Contributor guide

Open the contributing guide

Research direction

Start at the azure.ai.agents extension path used by azd deploy and the generated TEAMS_APP_SETUP.md guide. Trace activity-protocol agent deployment through the POST /agents/{name}/microsoft365/zip packaging call; done means a best-effort appPackage.zip is available beside the source, the guide leads with sideloading it, and packaging failures preserve the manual fallback without failing deploy.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure, go
Domain
cli, cloud
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.