Pattern

Publish ritual

Changes that seem not to arrive in a published channel because publishing propagates asynchronously and channels cache old agent versions.

Last reviewed 8 July 2026

The pattern

After every publish, run a fixed ritual before you judge whether a change arrived. Republish, start a new session, clear the client cache, re-add the app, and wait. Publishing propagates asynchronously across regions, and each channel caches its own copy of your agent. Never conclude "the fix didn't work" until you have ruled out propagation.

When to use it

  • After every publish, before you retest in a channel.
  • Whenever behavior differs between the test pane and a published channel.
  • Before you revert a change or open a support case for "publish is broken".

Steps

  1. Publish the agent again in Copilot Studio ("Publish").
  2. Start a completely new chat session in the channel.
  3. Type "start over" to reset the conversation state.
  4. Sign out of the client, for example Teams.
  5. Sign back in.
  6. Remove the agent app from the client.
  7. Re-add the agent from the app catalog, not from a pinned entry.
  8. Wait; propagation can exceed the documented 30 minutes.
  9. Retest with a question whose answer changed in the new version.