You have built a custom agent in Copilot Studio and now want to make it available to your team directly inside Microsoft Teams. Publishing the agent to a Teams channel allows members to interact with it without leaving the chat interface. This article explains the prerequisites, the step-by-step publication process, and common issues that can block a successful deployment.
Copilot Studio agents can be published as Teams apps that appear in the Teams app bar or as tabs inside a specific channel. The channel publication method places the agent as a tab at the top of the channel, giving every member of that channel access. This approach works best for team-wide tools such as IT helpdesk assistants, project status checkers, or knowledge base search bots.
You will learn how to configure the agent for Teams, submit it for admin approval if required, and add it to a channel. The article also covers what to do if the agent does not appear after publishing or if users see a permissions error.
Key Takeaways: Publishing a Copilot Studio Agent to a Teams Channel
- Copilot Studio > Publish > Channel selection > Teams: Opens the Teams app manifest editor where you configure the agent name, icon, and description for Teams.
- Microsoft Teams admin center > Manage apps > Allow or upload: Required when your organization blocks sideloading of custom apps; the agent must be approved by an admin before it appears.
- Teams channel > Add a tab > Copilot Studio agent: The exact sequence to place the published agent as a tab so all channel members can use it.
What Publishing a Copilot Studio Agent to a Teams Channel Means
When you publish a Copilot Studio agent to a Teams channel, you are converting the agent into a Teams app that appears as a tab inside that channel. Every member of the channel can open the tab and start a conversation with the agent. The agent inherits the Teams channel context, meaning it can respond to questions based on the channel topic or perform actions defined in the agent topic flows.
Before you can publish, you need the following prerequisites:
- A Copilot Studio license assigned to the agent author.
- An active Copilot Studio agent with at least one topic and one published test version.
- Permission to create custom Teams apps in your Microsoft 365 tenant. If your tenant blocks sideloading, you need a Teams admin to approve the app.
- Owner or contributor role on the agent in Copilot Studio.
The publication process has two phases. The first phase generates the Teams app package inside Copilot Studio. The second phase adds that app as a tab in the target Teams channel. Both phases are described in the next section.
Steps to Publish a Copilot Studio Agent to a Teams Channel
Follow these steps in order. Skipping the app registration step in Copilot Studio will cause the agent to fail when you try to add it to the channel.
- Open the agent in Copilot Studio
Go to copilotstudio.microsoft.com and sign in with your work or school account. Select the agent you want to publish from the list of agents on the left sidebar. - Navigate to the Publish section
In the left navigation menu, click Publish. Then click the Channels tab. You will see a list of available channels including Teams, Power Apps, and web chat. - Configure the Teams channel
Click the Teams channel tile. A panel opens where you can set the app name, short description, full description, and icon. The app name must be unique across your tenant. Upload a 192×192 pixel icon for the app tile and a 32×32 pixel icon for the tab bar. Click Save after filling in all fields. - Generate the Teams app package
Back on the Channels page, click Publish at the top of the page. Copilot Studio generates a .zip file containing the Teams app manifest and the agent configuration. A dialog appears with the option to download the package. Click Download and save the .zip file to your computer. - Upload the app to Microsoft Teams
Open Microsoft Teams. In the left sidebar, click Apps. At the bottom of the Apps page, click Manage your apps then select Upload an app. Choose Upload a custom app and select the .zip file you downloaded. Teams installs the app for your organization. If your tenant blocks custom uploads, you see a permission error. In that case, send the .zip file to a Teams admin and ask them to upload it through the Teams admin center. - Add the agent as a tab to the target channel
Navigate to the Teams channel where you want the agent to appear. At the top of the channel, click the + icon to add a new tab. In the tab gallery, search for the name of your agent. Select the agent from the list. In the popup that appears, click Add. The agent tab is now visible to all channel members. - Test the agent in the channel
Click the tab to open the agent interface. Type a test message such as Hello or a question related to your agent topics. Verify the agent responds correctly. If the agent does not respond, check that the agent has at least one published topic and that the topic trigger phrases match your test input.
What to Do If the Agent Does Not Appear or Fails to Load
The agent tab is missing from the tab gallery
If you do not see your agent in the tab gallery after uploading the app, the app may not be fully installed. Go back to Teams > Apps > Manage your apps and confirm the app is listed. If it is listed but shows a status of Blocked, a Teams admin must approve it in the Teams admin center under Manage apps by selecting the app and clicking Allow.
Users see a sign-in prompt when opening the tab
This happens when the agent requires authentication for certain topics. In Copilot Studio, go to the agent settings and enable Authentication for Microsoft Entra ID. Publish the agent again, download the updated .zip file, and re-upload it to Teams. Users must sign in once to authenticate the agent for their session.
The agent responds with generic errors or no reply
The agent may not have a topic that matches the user input. In Copilot Studio, open the Topics section and verify that the trigger phrases for your topics cover the questions users will ask. Republish the agent after making changes. Also check that the agent is not in a draft state. Only published agents work in Teams channels.
Copilot Studio Agent in Teams Channel vs Teams App Bar
| Item | Teams Channel Tab | Teams App Bar |
|---|---|---|
| Access location | Inside a specific channel as a tab | Left sidebar of Teams under the Apps section |
| Audience | Channel members only | All users who install the app |
| Context awareness | Can read channel name and topic | No channel context |
| Visibility | Visible to everyone in the channel | Visible only to the user who installed it |
| Admin approval | Required if tenant blocks custom uploads | Required if tenant blocks custom uploads |
Once the agent is published as a channel tab, you can update the agent in Copilot Studio and republish. The tab automatically reflects the latest published version after a few minutes. There is no need to re-upload the app unless you change the app name, icon, or description.