ai.action when you only need a prompt and an output. It runs one model call and does not let the model call tools.
Capabilities
- Pass task instructions in
instructionsand task data inuser_prompt. - Use
output_typewhen you need a string, list, or JSON-shaped response for downstream actions. - Tune provider-specific behavior with
model_settings.
Structured outputs
Useoutput_type when a downstream action needs a predictable shape.
- Use a scalar such as
strorintfor simple classification or routing. - Use a JSON schema object when you need named fields.
- Tracecat parses valid JSON before storing it in the action result.
Timeouts
timeout caps active runtime in seconds. Unset means 7200 seconds (2 hours), and Tracecat clamps explicit values between 1800 seconds and TRACECAT__AGENT_SANDBOX_TIMEOUT, which defaults to 10800 seconds. See Actions for the clamp rule and the retry_policy shape. A lower ceiling caps both the default and the minimum.
Reference
ai.action
Call an LLM with a given prompt and model (no tools).
Inputs
Output type for agent responses. Select from a list of supported types or provide a JSONSchema.Default:
null.