Skip to content
China Explained

CLI and YAML

CLI and YAML

Section titled “CLI and YAML”

YAML is for repetition

Section titled “YAML is for repetition”
agents:
  - name: researcher
    system_prompt: "Collect factual notes with source links."
workflow:
  type: sequential

Secrets, long private notes, and one-off experiments do not belong in reusable YAML. Configuration controls behavior, so review it like code.

Interactive work and repeatable work are different

Section titled “Interactive work and repeatable work are different”

Use Python when the workflow is application logic. Use YAML or CLI configuration when the workflow should be run repeatedly by someone who should not edit code.

NeedPrefer
Prototype logicPython script
Run a known workflowCLI or YAML
Store secretsEnvironment or secrets manager
Review behaviorVersioned YAML near the project
agents:
  - name: researcher
    system_prompt: "Collect factual notes with source links."
workflow:
  type: sequential
Section titled “Related pages”

References

Section titled “References”