Output control determines how an AI agent returns data to your flow. Configure the output type to ensure the agent’s response is predictable, validated, and easy to map in downstream steps.
You select the output mode when configuring the agent. The available options depend on the capabilities of the selected model.
An agent supports the following output types:
-
Plain text: Returns a plain text response. This is the default output type and is commonly used for summaries, explanations, and classifications.
-
JSON: Returns structured output that must conform to a schema you define. Before the result is released to the flow, the Celigo platform validates the response against the schema.
If validation fails, the record errors out with a clear message. No partial or malformed JSON is passed downstream.
Important
Use JSON output when downstream mappings or logic require predictable fields.
-
Binary file: Generates a file and returns a reference to it. The file is written to temporary storage and can be retrieved by downstream steps using standard file integration.
Generated files are retained for one hour.
Warning
Binary output is subject to size limits and retention policies. If limits are exceeded or temporary storage is unavailable, the run fails with guidance.