set_effort_vote

Beschreibung

Gibt die eigene Aufwandsschätzung des verbundenen Nutzers für ein Ziel ab — nie die eines anderen. planned ist die Schätzung vor der Arbeit, actual der tatsächliche Aufwand. Pro Nutzer, Ziel und Phase gibt es genau eine Schätzung; ein erneuter Aufruf ersetzt sie. Gehört dem Nutzer das Ziel, wird seine geplante Schätzung zugleich zum Aufwand des Ziels. 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

Diesen Text sieht das KI-Modell — unverändert und auf Englisch, so wie ihn der Server ausliefert:

Cast the connected user’s OWN effort estimate for one goal — never anyone else’s. phase “planned” is the estimate before the work, “actual” what it really took; value is a t-shirt size on the scale S < M < L < XL < XXL. One estimate per user, goal and phase: calling again replaces it. When the connected user owns the goal, a planned estimate also becomes the goal’s effort field (the owner’s planned size search_goals shows); anyone else’s estimate only adds to the multi-estimator aggregate get_goal returns. Errors: { error: “not_found”, field: “goalId” }, { error: “graph_unavailable”, retryable: true } (nothing was written). Only available on connections granted write access.

Parameter

Name	Typ	Pflicht	Einschränkungen	Beschreibung
goalId	Text	Ja		The goal id
phase	Text	Ja	planned | actual	planned = your estimate before the work; actual = what it really took
value	Text	Ja	S | M | L | XL | XXL	Your effort estimate (t-shirt size)

Zurück zur Übersicht