stack kb agent-builder post-agent-builder-converse-async cli command
Auth required
elastic stack kb agent-builder post-agent-builder-converse-async [options]
Send chat message (streaming)
Behaviour flags:
--dry-run — validate all inputs and exit without performing any action
--execution-modeenum-
define how to execute the agent (local execution or via task_manager)
Values: local, task_manager
--access-controlstring- Optional conversation access control. Defaults to private.
--actionenum-
The action to perform. "regenerate" re-executes the last round with the original input. Requires conversation_id.
Values: regenerate
--agent-idstring- The ID of the agent to chat with. Defaults to the default Elastic AI agent.
--attachmentsstring[]-
Optional attachments to send with the message.
Repeatable: pass
--attachmentsmultiple times to supply more than one value --browser-api-toolsstring[]-
Optional browser API tools to be registered as LLM tools with browser.* namespace. These tools execute on the client side.
Repeatable: pass
--browser-api-toolsmultiple times to supply more than one value --configuration-overridesstring- Runtime configuration overrides. These override the stored agent configuration for this execution only.
--connector-idstring- Optional connector ID for the agent to use for model routing. Mutually exclusive with
inference_id; omit or use only one. --conversation-idstring- Optional existing conversation ID to continue a previous conversation.
--execution-idstring- Optional client-generated execution ID. Provide it to address this execution later (for example, to abort it). Must be unique; defaults to a server-generated ID.
--inference-idstring- Optional inference endpoint ID for model routing (public alias for the same internal identifier as
connector_id). Mutually exclusive withconnector_id. --inputstring- The user input message to send to the agent.
--project-routingstring- Cross-project search routing expression resolved from the header project picker, applied to the run's searches. Serverless (CPS) only; ignored elsewhere.
--promptsstring- Use this field to respond to a
confirmation,authorization, orask_user_questionprompt. Send anallowboolean to answer aconfirmationprompt, anauthorizedboolean to answer anauthorizationprompt, or ananswersarray (one entry per question) to answer anask_user_questionprompt. --read-only- When true, the created conversation is presented as read-only in the UI: its history is shown but no message input is offered. This carries no authorization meaning — the conversation can still be continued through the API. This setting is ignored when continuing an existing conversation.
--input-filestring- path to a JSON file to use as command input
--dry-run- validate all inputs and exit without performing any action (preview changes without applying them)
--json-
output as JSON