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

# Agent build tools

> Check a build and carry on one that failed.

## 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

**build\_id** `string` *required*

The `build_id` a create tool returned.

### Returns

**build\_id** `string`

**status** `string`

`building`, `ready` or `failed`.

When `status` is `failed`:

**reason** `string`

Why it stopped, in plain words. [`retry_agent_build`](#retry_agent_build) carries it on.

When `status` is `ready`:

**agent\_id** `string`

The new agent's id.

**name** `string`

The agent's name.

**greeting** `string`

What it says first.

**summary** `string`

What the agent does.

**type** `string`

`answers calls` or `makes calls`.

**link** `string`

The agent's page in the VoiceAIWrapper app.

**website\_not\_read** `boolean`

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

**embed\_code** `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>`.

**takes\_visitors** `boolean`

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

**next\_steps** `string[]`

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

```json Ready theme={null}
{
  "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

**build\_id** `string` *required*

The `build_id` of the failed build.

### Returns

The same fields as [`get_agent_build_status`](#get_agent_build_status). Usually `status` is `building` again; keep checking with `get_agent_build_status`.


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