set_impact_vote
Beschreibung
Section titled “Beschreibung”Gibt die eigene Bewertung des verbundenen Nutzers ab, wie stark ein Ziel einen Driver oder Lever der Wertlandkarte bewegt — nie die eines anderen. Du übergibst genau eines von driverId oder leverId (den Namen des Knotens), die Phase (planning = erwartete, retrospective = tatsächliche Wirkung) und einen Wert von -XL bis +XL. Pro Nutzer, Ziel, Knoten und Phase gibt es genau eine Bewertung; ein erneuter Aufruf ersetzt sie. Eine Bewertung direkt auf einen Driver zählt als dieselbe Stufe auf jedem seiner Lever; dieselbe Person bewertet einen Driver entweder direkt oder über seine Lever, nie beides — ein Widerspruch liefert { error: "conflicting_impact_vote", existing }, die bestehende Bewertung lässt sich nur in der App entfernen. Unbekannte Ziele oder Knoten liefern { error: "not_found", field }. Nur verfügbar, wenn die Verbindung Schreibzugriff (goals:write) erhalten hat UND Schreibzugriff für die Organisation freigeschaltet ist — sonst taucht das Werkzeug gar nicht erst auf.
Beschreibung für das Modell
Section titled “Beschreibung für das Modell”Diesen Text sieht das KI-Modell — unverändert und auf Englisch, so wie ihn der Server ausliefert:
Cast the connected user’s OWN vote on how much one goal moves one value-map Driver or Lever — never anyone else’s. Pass exactly one of driverId or leverId: the node’s name, as get_value_map returns it in name (not its “ValueDriver:…” id) and as get_goal’s impacts list it. phase “planning” is the expected impact, “retrospective” the impact the goal actually had. value runs -XL, -L, -M, -S, 0, +S, +M, +L, +XL (negative = the goal works against it). One vote per user, goal, target and phase: calling again replaces it. Vote a Driver directly only when the goal moves all its Levers alike (it counts as that level on every Lever); one user votes a Driver either directly or via its Levers, never both. Errors: { error: “conflicting_impact_vote”, existing } (the user already voted the other view of this Driver in this phase; nothing was written — it must be removed in the Evident Flow app first), { error: “not_found”, field: “goalId” | “driverId” | “leverId” } (not in this organization), { error: “invalid_target” } (neither or both targets), { error: “graph_unavailable”, retryable: true } (nothing was written). Only available on connections granted write access.
Parameter
Section titled “Parameter”| Name | Typ | Pflicht | Einschränkungen | Beschreibung |
|---|---|---|---|---|
goalId | Text | Ja | The goal id | |
driverId | Text | Nein | The driver to vote on — its name. Pass exactly one of driverId or leverId | |
leverId | Text | Nein | The lever to vote on — its name. Pass exactly one of driverId or leverId | |
phase | Text | Ja | planning | retrospective | planning = expected impact; retrospective = the impact it actually had |
value | Text | Ja | 0 | -XL | -L | -M | -S | +S | +M | +L | +XL | Your impact vote, from -XL (strongly negative) through 0 to +XL |