launch-agent

Launch a new Agent

Stand up a working Agent in one guided flow. Most people running this have just connected Quickchat and have an empty Agent, so build something before you report anything.

Before you start

• Ask whether they have a website to build from. That answer picks the path below.
• Explain this creates a real Agent on the FREE tier (no charge, no card).

Path A — they have a website

1. Call create_assistant with confirm=true (and name if given). Creation is guarded by confirm=true and capped at 5/hour. Tell the user the new scenario_id.
2. Call onboard_assistant_from_url with that scenario_id and the URL. Say out loud that this takes 20-60 seconds while it scrapes the site, writes the persona and embeds the content — silence here is where people give up. It OVERWRITES configuration, so run it only on the freshly created Agent, never an established one.
3. Poll get_assistant_settings until onboarding_from_url_completed is true. If it reports onboarding_progress_tracked false there is no completion signal — read the settings once after ~60s instead.
4. Show what was generated: the name, the main prompt, the guidelines and the language it picked.

If the URL is rejected as a placeholder or marketplace domain, ask for their own business website rather than retrying the same URL.

Path B — no website

Do NOT create an empty Agent and stop. Interview first, in one short round of questions:

• What does the business do, and what is it called?
• Who will be talking to the Agent (customers, members, players, staff)?
• What tone should it take?
• What are the top 3 questions it must answer?

Then create a configured Agent in a single call — create_assistant accepts the settings inline:

• name and one_word_description — what the Agent is called
• short_description — the main prompt: role, what it helps with, what it must not guess at
• ai_commands — one short rule per item, from their must-answer questions
• greeting — the first line a visitor sees
• language_chosen — the language they answered in