Agent build tools

get_agent_build_status

Check a build started by create_inbound_receptionist, create_outbound_agent or create_website_chatbot. While it is building, the AI app checks again after a few seconds. Scope: agents.read · Hints: read-only

Inputs

string

required

The build_id a create tool returned.

Returns

string

building, ready or failed.

When status is failed:

string

Why it stopped, in plain words. retry_agent_build carries it on.

When status is ready:

string

The new agent’s id.

string

The agent’s name.

string

What it says first.

string

What the agent does.

string

answers calls or makes calls.

string

The agent’s page in the VoiceAIWrapper app.

boolean

true if the website couldn’t be read, so only the details you gave were used.

string

Only for an agent with a web widget (for example from create_website_chatbot): the HTML to paste into the site, just before </body>.

boolean

Only with embed_code. false means the widget is ready but refuses visitors until your plan includes web widgets.

string[]

What to do next, for example connect a phone number or try the agent with the Test button.

Ready

{
  "build_id": "VmF3TmF0aXZlQWdlbnRCdWlsZFR5cGU6YWJjMTIz",
  "status": "ready",
  "agent_id": "VmF3TmF0aXZlQWdlbnRUeXBlOng3azJt",
  "name": "Lakeside Dental Receptionist",
  "greeting": "Thanks for calling Lakeside Dental, how can I help you today?",
  "summary": "Answers calls for Lakeside Dental: Answer questions; Take messages.",
  "type": "answers calls",
  "link": "https://dashboard.voiceaiwrapper.app/en/.../agent/VmF3TmF0aXZlQWdlbnRUeXBlOng3azJt",
  "website_not_read": false,
  "next_steps": [
    "Connect a phone number so it can answer calls.",
    "Try it with the Test button on the agent's page in the VoiceAIWrapper app.",
    "Add a web widget so visitors to your site can talk to it: ask me to create one.",
    "Optional, in the VoiceAIWrapper app: calendar booking, call transfer and texts."
  ]
}

retry_agent_build

Carry on a failed build from where it stopped. It never makes a second agent. A build that is still running, or already ready, is returned as it is. Scope: agents.write · Hints: open world

Inputs

string

required

The build_id of the failed build.

Returns

The same fields as get_agent_build_status. Usually status is building again; keep checking with get_agent_build_status.

Web Widget

Billing

MCP server

get_agent_build_status

Inputs

Returns

retry_agent_build

Inputs

Returns

​get_agent_build_status

​Inputs

​Returns

​retry_agent_build

​Inputs

​Returns

get_agent_build_status

Inputs

Returns

retry_agent_build

Inputs

Returns