Agent Builder

Build Agent Configuration

Generates a draft configuration from structured answers. This operation does not save or publish an agent. A build can take longer than the 60 second HTTP timeout; use Stream Agent Build for long builds.

post/v1/agent-builder/run

Request

Base URL: https://api.dialnexa.com
URL: https://api.dialnexa.com/v1/agent-builder/run
Auth: HTTP bearer

Request body

build_attemptinteger

Build attempt number (1-2). Validation runs only on attempt 1; attempt 2 skips re-validation.

pipeline'cascaded' | 's2s'

Engine for the generated agent. "s2s" builds the realtime pipeline on the same single-prompt agent; anything else builds the cascaded pipeline.

target_shape'spa' | 'cfa' | 'ivr'

Kind of agent to build. "cfa" writes a conversation-flow document (a step graph), "ivr" writes a touch-tone menu; anything else builds a single-prompt agent.

Example request

{
  "structured_input": {
    "company_and_offering": {
      "description": "Share your company name and a short description of your product, service, or industry.",
      "value": "Acme Corp: we sell B2B payroll software for mid-market HR teams."
    },
    "target_customer": {
      "description": "Share your company name and a short description of your product, service, or industry.",
      "value": "Acme Corp: we sell B2B payroll software for mid-market HR teams."
    },
    "primary_goal": {
      "description": "Share your company name and a short description of your product, service, or industry.",
      "value": "Acme Corp: we sell B2B payroll software for mid-market HR teams."
    },
    "success_criteria": {
      "description": "Share your company name and a short description of your product, service, or industry.",
      "value": "Acme Corp: we sell B2B payroll software for mid-market HR teams."
    },
    "information_to_collect": {
      "description": "Share your company name and a short description of your product, service, or industry.",
      "value": "Acme Corp: we sell B2B payroll software for mid-market HR teams."
    },
    "objections_and_faqs": {
      "description": "Share your company name and a short description of your product, service, or industry.",
      "value": "Acme Corp: we sell B2B payroll software for mid-market HR teams."
    },
    "agent_tone": {
      "description": "Share your company name and a short description of your product, service, or industry.",
      "value": "Acme Corp: we sell B2B payroll software for mid-market HR teams."
    },
    "additional_context": {
      "description": "Share your company name and a short description of your product, service, or industry.",
      "value": "Acme Corp: we sell B2B payroll software for mid-market HR teams."
    },
    "validation_clarifications": {
      "description": "Share your company name and a short description of your product, service, or industry.",
      "value": "Acme Corp: we sell B2B payroll software for mid-market HR teams."
    }
  }
}

Response

Builder run completed or needs more input

successtrue required

errorfalse required

statusCodeinteger required

messagestring required

timestampstring date-time required

Example response

{
  "statusCode": 201,
  "message": "Success"
}

Changes

No recorded changes to this operation across all 1 revision of this API.