Quickstart

Create and deploy your first agent in minutes.

This guide walks from an empty workspace to a live web widget. You can follow it with a local dev stack (docker compose) or a hosted Convoship account.

1. Create an agent

Open Assistants (/app/assistants) and click the Sketch → bot card. Choose Start blank or upload Draw.io / PDF / Word / image sources with optional AI Enrich — see New assistant wizard and Import sources.

2. Add an intent and sub-flow

  1. Open Intents in the left rail and create an intent (e.g. check_balance).
  2. Add training phrases — one per line — such as "what is my balance" and "check balance".
  3. Open the intent to edit its sub-flow: drag Message and Entity nodes from the library, connect them, and configure prompts in the inspector.

3. Test

Use the floating simulator (bottom-right) or the Test tab to send utterances. The execution trace shows which nodes ran and which slots were filled.

4. Publish and deploy

  1. Open Publish and click Publish draft.
  2. Open Channels → New deployment, set allowed origins for your site, copy the cdp_* token.
  3. Paste the embed snippet on your website and load the Convoship embed script.