Skip to main content
You can ask Sofie to build an Orchestration from chat. This is useful when you know the workflow outcome but do not want to start by manually placing agents, tasks, inputs, tools, and review steps. If you are still deciding whether the workflow should become an Orchestration, start with Use Orchestrations intelligently.

Start with a clear workflow request

Tell Sofie the repeatable job you want to create. Include the business context, expected inputs, expected output, and review points. Use this structure:
Example:
If the workflow involves regulated or quality decisions, ask Sofie to include assumptions, source gaps, and human review points in the Orchestration design.

Add source context

Before asking Sofie to build, add the context it should understand. You can attach or add:
  • A Workspace that contains related files.
  • A CoDraft template or example deliverable.
  • A CoSheet with data columns and sample rows.
  • A CoMeeting transcript that describes how the process works.
  • Files such as SOPs, protocols, reports, or spreadsheets.
  • A Saved prompt that contains your preferred workflow language.
When the Orchestration should always ask for a source later, describe that as an input instead of attaching only today’s example.

Ask Sofie to propose the design first

For complex workflows, ask for a design review before creation.
Review the proposal for:
  • Missing required inputs.
  • Inputs that should be optional.
  • Too many agents.
  • Tasks that depend on missing sources.
  • Review points that happen too late.
  • Outputs that are too vague to review.

Create the Orchestration from chat

After you approve the design, ask Sofie to create it.
Sofie may ask follow-up questions before creating the Orchestration. Answer them in the same chat so the creation request and decisions stay together.
If Sofie cannot complete the creation from chat in your environment, use the proposed design as the blueprint in /orchestrate/build-orchestrations.

Open the result in Orchestrate

After Sofie creates or prepares the Orchestration, open it in Orchestrate. Check:
  • Name and description.
  • Input names, labels, descriptions, and required settings.
  • Agent role, goal, and backstory.
  • Task descriptions and expected outputs.
  • Tool choices.
  • Human review settings.
  • Output mode and destination.
  • Draft or published status.
Use the Orchestration editor for detailed control. Use chat for iterative design help.

Test from chat

You can also run an Orchestration from chat. Example:
When an Orchestration needs required inputs, Sofie can ask for them before the run starts.

Refine from the test output

After the first run, ask Sofie to inspect the result and suggest changes to the Orchestration.
Then edit the Orchestration directly or ask Sofie to help revise it. When the workflow is repeatable enough to reuse, add Orchestration tests before publishing. See Test Orchestrations for manual tests, saved-run baselines, validation methods, run history, drift, parallel execution checks, and Memory checks.

Prompt examples

What to specify for better Orchestrations

For manual editing details, see Build and edit an Orchestration.