Skip to main content

buildAiReviewColumns

Turns the reviewer's description of what they want into suggested columns, and persists nothing: the client calls addAiReviewColumn for each suggestion the reviewer keeps. Distinct from generateAiReviewColumns, which runs extraction on columns that already exist.

A description the builder will not act on - an instruction aimed at the model, or text that is not about documents - comes back as COLUMN_SUGGESTION_REFUSED with what the reviewer should say instead.

buildAiReviewColumns(
  input: BuildAiReviewColumnsInput!
): BuildAiReviewColumnsPayload!

Arguments​

buildAiReviewColumns.input ● BuildAiReviewColumnsInput! non-null input​

Type​

BuildAiReviewColumnsPayload object​

Carries no review, because the mutation writes nothing. Suggestions and errors are mutually exclusive: a refusal is an error with an empty suggestion list, not a successful call that happened to return nothing. The list is never null, so a client reading an error case does not have to tell an empty answer from a missing one.