Create Custom Protocols

You can define your own custom workflows by uploading a YAML blueprint that describes how models should be linked and what inputs are required.

You can define your own custom workflows by uploading a YAML blueprint that describes how models should be linked and what inputs are required.

Start a New Protocol

From the Protocols page, click Create New Protocol at the top right to open the setup wizard.


Upload or Paste YAML

You can either upload a .yaml    file or paste YAML text directly into the editor.

Your YAML definition should include:

  • A name for the protocol
  • An inputs section defining required parameters
  • Any configuration limits or runtime settings

Use Load Example YAML to prefill the editor with a sample schema if you’re not sure where to start.

As you type or upload a file, the Live Parse Preview updates automatically with the parsed name, inputs, and detected tasks.

Click Continue when your YAML looks correct.

Review and Edit the Schema

After the YAML is parsed, the Schema Editor lets you customize your input fields. You can:

  • Edit labels, types, and validation options
  • Add placeholders, help text, or regex rules
  • Reorder or remove inputs
  • Switch between Builder and JSON view

This lets you fine-tune the form that users will fill out when running the protocol.

Test with Example Inputs

Next, add example input values to verify that your protocol runs as expected.

You can enter inputs using either:

  • Form mode – individual input fields
  • JSON mode – a structured data editor

Click Run Test to validate. Once the test completes successfully, your configuration is ready to publish.

Publish and Use Your Protocol

Click Publish Configuration to make your new protocol available in your workspace.

It will appear in the Protocols catalog and can be run just like any built-in workflow.

Tips

  • Load Example YAML is a great starting point for structure and syntax.
  • Tasks in your YAML (e.g. antifold_generate   , compute_rmsd   , igbert_score   ) represent chained model steps.
  • You can edit or delete a protocol at any time from the main Protocols dashboard.
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us