aiAskTurn

One Ask Paminga IQ turn. The payload is the shared ChatMessagePayload union; this agent emits ChatNarrationPayload (the answer), ChatQuestionPayload (the named thing matched more than one record, or none exactly — the options are the candidates, and picking one sends it back as the next turn), ChatQuestionsPayload (a segment build needs the user's answers; the build stays open, and the reply goes back as the next turn's message), ChatStoppedPayload (the user pressed Stop), or ChatErrorPayload. Gated by AI_ASK_ENABLED, the product's ai_enabled flag, and a per-user hourly limit.

aiAskTurn(
  input: AiAskTurnInput!
): AiAgentTurn!

Arguments

aiAskTurn.input ● AiAskTurnInput! non-null input

Type

AiAgentTurn object

Wrapper returned by every conversational-agent mutation (workflow builder, segment builder, future actions chat). The payload is the same union persisted on ChatMessage rows, so the UI uses one renderer registry for both live mutation responses and polled history. chatConversationId is populated on the very first turn of a new session so the client can stash it and switch into "resume" mode for subsequent calls.