Magento Content Flow docs

Practical setup and operations guide for preview-first Magento AI automation.

Quickstart

1. Connect Magento

Open Stores, add base URL + credentials, and run connection test.

2. Add AI key

Open Settings, save your account-level OpenAI key.

3. Create first rule from template

Open Rules, choose a template pack, adjust conditions and prompt.

4. Run dry-run and review

Queue dry-run, review run items, approve selected outputs, then apply approved snapshots.

Preview to publish workflow

  1. Create rule basics: name, store, target attribute, model.
  2. Set product conditions and source fields.
  3. Attach optional brand/compliance profiles.
  4. Preview matching products (sample only).
  5. Preview generated output (1-3 products).
  6. Save rule and run dry-run.
  7. Approve/reject items on run detail.
  8. Apply approved snapshots to Magento.
  9. Export CSV for QA/audit if needed.

Run lifecycle: queued -> running -> succeeded|partial|failed.

Common skip reasons

  • cooldown_fingerprint: same successful fingerprint exists in cooldown window.
  • source_fingerprint_unchanged: source values + generation settings unchanged since last success.
  • unchanged_value: generated output equals current Magento value.

Common policy block reasons

  • policy_banned_phrase
  • policy_missing_required_phrase
  • policy_too_long / policy_too_short
  • policy_pattern_match
  • policy_excessive_exclamation
  • policy_superlative_excess

API routes

Core rules + runs:

  • GET|POST /api/content-flow/rules
  • PATCH|DELETE /api/content-flow/rules/{id}
  • POST /api/content-flow/rules/{id}/run
  • POST /api/content-flow/rules/{id}/dry-run
  • POST /api/content-flow/rules/preview-match
  • POST /api/content-flow/rules/preview-generation
  • POST /api/content-flow/rules/{id}/duplicate
  • POST /api/content-flow/rules/bulk-action
  • GET /api/content-flow/runs
  • GET /api/content-flow/runs/{id}
  • GET /api/content-flow/runs/{id}/items
  • POST /api/content-flow/runs/{id}/approve-items
  • POST /api/content-flow/runs/{id}/reject-items
  • POST /api/content-flow/runs/{id}/apply-approved
  • GET /api/content-flow/runs/{id}/export

Profiles + presets:

  • GET|POST /api/content-flow/brand-profiles
  • GET|PATCH|DELETE /api/content-flow/brand-profiles/{id}
  • GET|POST /api/content-flow/compliance-profiles
  • GET|PATCH|DELETE /api/content-flow/compliance-profiles/{id}
  • GET /api/content-flow/rule-templates
  • GET /api/content-flow/prompt-presets
  • GET /api/content-flow/condition-presets

CLI commands

php cli.php migrate
php cli.php migrate:status
php cli.php content-flow:schedule --limit=500
php cli.php content-flow:work --loop --sleep=2
php cli.php content-flow:run-rule --rule=123 --dry-run
php cli.php content-flow:test

Troubleshooting

Connection test fails

Verify Magento base URL, auth mode, and integration permissions. Retest after updates.

Preview fails

Check store connection status, AI key validity, and rule payload completeness.

Runs stay queued

Worker may be stopped. Run php cli.php content-flow:work --loop --sleep=2.