Introduction

What Convoship is and how the platform fits together.

Convoship is a conversational AI studio for designing, testing, and deploying bots. Use Assistants for scripted intent + flow bots, Agents for LLM reasoning over tools, and Workflows to chain them together.

What you build

An Assistant is a scripted bot: intents, sub-flows, entities, tools, and Channels deployment tokens (cdp_*). An AI Agent is a separate agentic runtime with mission, tasks, tool handlers, publish/publicToken embed, and guardrails — see /docs/agent-vs-assistant and /docs/agentic-ai.

Studio layout

  • Workspace — top-level container for Assistants, Agents, members, secrets, and audit logs.
  • Assistants dashboard (/app/assistants) — scripted bots with intents and flows.
  • Agents dashboard (/app/agents) — agentic bots with tasks, tools, and playground.
  • Agent shell — left rail with Build, Operate, and Move sections while editing one Assistant.
  • Simulator — floating chat on every Assistant page to test conversations live.

Typical workflow

  1. Create an agent (blank, template, or Draw.io import).
  2. Define intents and build sub-flows on the canvas.
  3. Add entities and tools as needed.
  4. Test utterances and simulate full sessions.
  5. Publish a version and deploy via Channels (web widget).

Feature map

Every major studio surface has a dedicated doc page. Use the left sidebar to jump directly, or follow the table below.

Studio areaDoc page
Workspace dashboardWorkspace
Members & rolesMembers
Secrets vaultSecrets
Workspace audit logWorkspace audit log
Shared HTTP/agent toolsWorkspace tools
Plan, MFA, sessionsWorkspace settings
Assistants dashboardAssistants dashboard
New assistant wizard (3 steps)New assistant wizard
Import review gateImport review
Multi-source importImport sources
Agent settingsAgent settings
Flow canvas & node repairFlow builder
Intents & sub-flowsIntents
EntitiesEntities
Tools (assistant scope)Tools
Small talkSmall talk
Welcome / fallback / no-inputEvents
Knowledge (RAG)Knowledge
Python script nodesPython scripts
Runtime & intent matchingRuntime engine
Simulator & utterance testTest & simulator
Publish releasePublish
Version history & restoreVersions
Metrics & funnelsAnalytics
Web widget & providersChannels & deploy
Embed SDK APIEmbed SDK
Session transcriptsHistory
Design-time auditChange log
Agent vs Assistant choiceAgent vs Assistant
AI Agents dashboardAgentic AI overview
New Agent wizard (4 steps)New Agent wizard
Playground, convos, evalsPlayground & evals
Workflows landingWorkflows overview
Chain editorChain editor
Workflow flow canvasWorkflow canvas
JSON / Draw.io exportExport
REST API surfaceAPI reference
Production & voice opsProduction deployment

Tip

Use Change log to see who edited intents and flow. Use Versions to export or restore a past release.