> ## Documentation Index
> Fetch the complete documentation index at: https://docs-agents.fpt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Publishing

> Cut a live version of the agent, choose where it serves, and record what changed

Once the agent is ready, publish it to create a live version. You can publish as often as you like; each publish creates a new version, and you choose which version serves on each deployment channel.

<Info icon="rocket">
  Before it is published, the agent only runs in your own test screen. Publishing is what puts it in front of real users, through Agent Workspace or through external channels.
</Info>

## Opening the publish dialog

<Steps>
  <Step title="Open the agent and go to the Agent builder tab">
    In the top right corner, click **Publish**.
  </Step>

  <Step title="Review the version details">
    The dialog shows the number of changes, the version number and where the agent will serve.
  </Step>

  <Step title="Click Publish to finish">
    The agent is packaged into a fixed version. That version never changes again, even as you carry on editing the agent.
  </Step>
</Steps>

<img src="https://mintcdn.com/fpt-62e894b4/OEIa1zuMs6GjYr6X/images/en_pub_dialog.jpg?fit=max&auto=format&n=OEIa1zuMs6GjYr6X&q=85&s=4dfe14a13ea7a2368c47d32de0473b24" alt="Publish dialog" width="1562" height="784" data-path="images/en_pub_dialog.jpg" />

## What is in the dialog

### Changes

**Changes** lists everything that has moved since the previous version: Instructions, Model, Skills, Connections, Guardrails, sub-agents and so on. Click a heading to expand it for detail. The number beside it tells you how many changes are being packaged into this version.

### Version number

The first publish is always **v1.0.0**. From the second onwards, you pick the increment:

| Increment | When to use it | Example |
| - | - | - |
| **Patch** | Small fixes, wording tweaks, no change in behaviour | v1.0.0 to v1.0.1 |
| **Minor** | A new skill, a new connection, extra guidance | v1.0.1 to v1.1.0 |
| **Major** | A significant change to the role or the way the agent works | v1.1.0 to v2.0.0 |

### Release notes

The notes box takes up to 2,000 characters. This is what the agent's users read, so keep it short and answer "what is new in this version".

<Tip icon="wand-magic-sparkles">
  Click **Write from changes** and the system drafts the notes from the change list for you. You can still edit them before publishing.
</Tip>

### Publish to

Tick **Publish to** to expand the section where you choose where the agent serves. When an agent has never been published, the badge beside it reads **Not published**.

<img src="https://mintcdn.com/fpt-62e894b4/OEIa1zuMs6GjYr6X/images/en_pub_targets.jpg?fit=max&auto=format&n=OEIa1zuMs6GjYr6X&q=85&s=13e73fc1de0ce27ed2f0a84a4f20acdd" alt="Choosing where the agent serves" width="1562" height="784" data-path="images/en_pub_targets.jpg" />

## Publishing to Agent Workspace

Agent Workspace is where internal users chat with the agent. Pick one of three scopes.

### Only me

Only you can use the agent. It goes straight into **My agents** in the Workspace.

Use this while the agent is still being finished, or when it serves work that is only yours.

### Company / department

Share the agent with a whole company, a department, or a selected group of people.

Choosing this scope opens an organisation tree:

<Steps>
  <Step title="Use the search box">
    Type a company, department or person into **Search companies, departments or people**.
  </Step>

  <Step title="Tick at the level you want">
    Tick at company level to share with the whole company. Tick at department level to share with that department only. The number beside each row is how many people it covers.
  </Step>

  <Step title="Expand to pick individuals">
    Click the arrow on a department to list its people and tick them one by one.
  </Step>
</Steps>

<img src="https://mintcdn.com/fpt-62e894b4/OEIa1zuMs6GjYr6X/images/en_pub_company_tree.jpg?fit=max&auto=format&n=OEIa1zuMs6GjYr6X&q=85&s=f0ce0f6e2bdda12ac9a51efbe01d6a9a" alt="Organisation tree when sharing an agent" width="1562" height="784" data-path="images/en_pub_company_tree.jpg" />

<Note>
  You can combine choices in a single publish - a whole department plus a few people from another, for example.
</Note>

### FPT AI Agent community

Publishes the agent to every FPT AI Agent user, including people outside your company.

<Warning>
  This is the widest scope there is. Go back over the Instructions, the data inside Skills and the Guardrails before choosing it, to be sure the agent cannot leak internal information.
</Warning>

## Publishing to external channels

The **External channels** section lists the channels outside Workspace. Tick a channel and the version you are publishing will serve there.

### Channels available now

<CardGroup cols={3}>
  <Card title="Web widget" icon="globe" href="/en/live-chat-channel">
    A floating chat window embedded in your website. Configured on the Channels tab.
  </Card>

  <Card title="API" icon="code" href="/en/api-integration">
    Call the agent directly from your own systems. Configured on the Channels tab.
  </Card>

  <Card title="Zalo" icon="comment-dots" href="/en/zalo-channel">
    An Official Account answering customers automatically. Configured on the Channels tab.
  </Card>
</CardGroup>

### Channels coming soon

The three below appear under **Not available yet** so you can see what is on the roadmap. They cannot be configured yet.

<CardGroup cols={3}>
  <Card title="Messenger" icon="facebook-messenger">
    A Facebook page answering customers through the agent.
  </Card>

  <Card title="WhatsApp" icon="whatsapp">
    A WhatsApp Business number answering customers through the agent.
  </Card>

  <Card title="Telegram" icon="telegram">
    A Telegram bot answering customers through the agent.
  </Card>
</CardGroup>

<Info icon="sliders">
  The publish dialog only switches channels on and off. Every detailed channel setting lives on the **Channels** tab. Click **Manage** in the bottom right to go straight there, or see [Managing deployment channels](/en/manage-channels).
</Info>

## Technical integration documentation

Everything above covers enabling and configuring channels inside Console. When your engineering team needs to embed more deeply, see the integration set:

<CardGroup cols={2}>
  <Card title="Live Chat channel" icon="code" href="/en/live-chat-channel">
    Embed code, widget customisation, share links and the Visitor API for teams building their own interface.
  </Card>

  <Card title="Mobile SDK" icon="mobile-screen" href="/en/mobile-sdk">
    Bringing the chat window into Android and iOS apps.
  </Card>

  <Card title="API integration" icon="key" href="/en/api-integration">
    Webhooks, HMAC signing, callbacks, reading conversation history and API keys.
  </Card>

  <Card title="Technical appendix" icon="table-list" href="/en/technical-appendix">
    Error code tables, system limits and the pre-production checklist.
  </Card>
</CardGroup>

## Publishing the first version

<img src="https://mintcdn.com/fpt-62e894b4/OEIa1zuMs6GjYr6X/images/en_publish_first_version.jpg?fit=max&auto=format&n=OEIa1zuMs6GjYr6X&q=85&s=28f2420d0373736be411d2617d1ef1db" alt="Publishing the first version" width="1562" height="784" data-path="images/en_publish_first_version.jpg" />

The first time round, the dialog says "First release - v1.0.0 becomes the version you serve". There is no increment to choose: write the release notes, pick where it serves, and click **Publish v1.0.0**.

## Publishing a later version

<img src="https://mintcdn.com/fpt-62e894b4/OEIa1zuMs6GjYr6X/images/en_publish_next_version.jpg?fit=max&auto=format&n=OEIa1zuMs6GjYr6X&q=85&s=52b72600dba97c9bc691bb8cc6fccdf1" alt="Publishing a later version" width="1562" height="784" data-path="images/en_publish_next_version.jpg" />

<Steps>
  <Step title="Reopen the publish dialog">
    Click **Publish** in the top right of the Agent builder tab.
  </Step>

  <Step title="Choose the version increment">
    Pick Patch, Minor or Major according to the size of the change.
  </Step>

  <Step title="Write the release notes">
    Type them yourself, or click **Write from changes** and edit what comes back.
  </Step>

  <Step title="Check where it serves">
    Review the Agent Workspace scope and which external channels are ticked.
  </Step>

  <Step title="Click Publish">
    The new version is created. Earlier versions are kept and can be put back into service.
  </Step>
</Steps>

## After publishing

<CardGroup cols={2}>
  <Card title="Managing deployment channels" icon="tower-broadcast" href="/en/manage-channels">
    See which channels are running, which version serves on each, and switch versions when you need to.
  </Card>

  <Card title="Live Chat channel" icon="comments" href="/en/live-chat-channel">
    Embedding the agent in your website: domain whitelisting, share links and widget customisation.
  </Card>

  <Card title="Zalo channel" icon="comment-dots" href="/en/zalo-channel">
    Connect an Official Account so the agent answers Zalo messages automatically.
  </Card>

  <Card title="Version history" icon="clock-rotate-left" href="/en/manage-channels">
    Every published version is kept, along with its release notes.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.