How actions get scored

What an Action is, how the agent links work to outcomes, and what the impact score actually measures.

An Action is anything the user or agent does that could plausibly move citations: an article published, a placement posted, schema installed, a corpus change. Every Action is recorded once with the prompts it targets so the Impact tab can re-probe those prompts before / after.

Action types

  • ARTICLE_PUBLISHED — article moved to PUBLISHED status
  • ARTICLE_GENERATED — agent finished drafting (less weighted; doesn’t move citations until published)
  • PLACEMENT_PLACED — Social opportunity posted by user
  • SCHEMA_INSTALLED — schema fix applied (manual confirmation; agent can’t verify by itself yet)
  • CORPUS_CHANGED — bulk content update (placeholder for future corpus management)

Score computation

The agent re-probes the targeted prompts on a schedule and compares citation rate before / after. Impact score is the weighted citation delta, normalized so positive = more citations, negative = fewer. Magnitude correlates with both the size of the delta and the number of prompts moved.

Why some Actions have low scores

Common reasons:

  • The targeted prompts were already won (no room to move).
  • The action’s effect hasn’t propagated yet — LLM indexes update on irregular cycles. Wait ±14 days.
  • The action was off-target — the agent may have linked it to tangentially-related prompts. Edit the action’s targetPromptIds if obvious.
← Back to knowledge base

Question we didn’t answer? Email hi@syncseo.io.