Skip to main content

What is supported

CrewAI 1.x. Onecortex recognises a Crew and calls kickoff.

A complete agent

agent.yml
requirements.txt
agent.py
Add OPENAI_API_KEY as a secret on the agent’s Config tab, then deploy. Any model works: this one is an example. See Configuration and secrets.

A complete CrewAI example

research-crew: A researcher and a writer on two sequential tasks sharing one {topic} placeholder. It runs with no model key.

The prompt and the reply

A crew has no single input, so Onecortex fills a placeholder in its tasks with the prompt:
  • One placeholder, such as {topic}: the prompt fills it.
  • Several: the prompt fills the first of {topic}, {question}, {input} or {query} that appears.
  • Several, none with those names: the call fails with a message listing them. Rename one, or wrap the crew in a function that builds the inputs.
  • None: the crew runs with no inputs.
The reply is the crew’s final output.

Events it reports

See Streaming and events.

The caller’s fields

A crew has no per run context, so fields beyond the prompt do not reach it. To use them, point the entrypoint at a function that reads them and calls kickoff itself:
See A Python function.

Known limits

  • CrewAI reports no tool results, so tool calls appear without their outputs.
  • A crew whose model does not stream sends its answer once, at the end, with no tool calls.
  • A crew with several placeholders and none named topic, question, input or query needs a function wrapper.

Troubleshooting

More on Troubleshooting and Errors.
Last modified on September 28, 2026