H2h2o
AI Assistants

Generate AI assistant spec from a prompt.

Uses an LLM with guided JSON to generate one or more AI assistant configurations from a natural language description. The returned specs map to every field in the create-assistant UI and can be used directly with the create_ai_assistant endpoint.

post/ai_assistants/generate_spec

Request

Request body

promptstring required

Natural language description of the desired assistant(s).

llmstring

Optional LLM model override for generation.

countinteger

Number of assistant configurations to generate (default 1).

Response

Generated assistant configurations.

passedboolean

Whether the user prompt was minimally sufficient to create the assistant. Callers MUST NOT create any assistants when passed is false; only show response to the user.

dialog'none' | 'text' | 'ui'

Confirmation strategy the caller should use before creating the assistant.

  • "none": user gave everything needed; create directly and show response.
  • "text": confirm in chat with the user before creating.
  • "ui": open the full create-assistant dialog pre-filled from the spec. Always "text" when passed=false.
responsestring

When passed=false, a clarifying question describing what info is missing. When passed=true, a human-language message keyed to dialog. May include the literal tokens {artifact_url} and {artifact_name} which the caller substitutes after creation.

llm_usedstring

The actual model that generated the specs (populated when llm=auto).

Changes

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