AiWorkflowAgentTurnInput

No description

input AiWorkflowAgentTurnInput {
  prompt: String!
  agentRunId: ID
  chatConversationId: ID
  folderId: ID
  folderHint: String
}

Fields

AiWorkflowAgentTurnInput.prompt ● String! non-null scalar

The user's latest chat message. On the first turn, this is the original natural-language workflow request.

AiWorkflowAgentTurnInput.agentRunId ● ID scalar

Client-generated session id (UUID). Required for NEW conversations; becomes the external_session_id on the underlying ChatConversation row. For RESUMED conversations (where chatConversationId is supplied) the server reuses the existing conversation's session id and this field is ignored.

AiWorkflowAgentTurnInput.chatConversationId ● ID scalar

Existing chat_conversations.id to resume. When supplied, the server loads that conversation (product-scoped) and continues it; the client does not need to remember the original agentRunId. Either this or agentRunId must be supplied.

AiWorkflowAgentTurnInput.folderId ● ID scalar

Optional folder id the new workflow should land in. When supplied, the agent will not ask the user to pick a folder.

AiWorkflowAgentTurnInput.folderHint ● String scalar

Optional natural-language hint about where the workflow should land (e.g., "the Onboarding folder"). The agent may use the folder-search tool to confirm placement.

Member Of

aiWorkflowAgentTurn mutation