list_comments

Beschreibung

Liefert den einheitlichen Verlauf zu genau einem Gegenstand — einem Ziel oder einer Aufgabe: menschliche Kommentare und Changelog-Einträge (Feld-Änderungen wie Stage, Confidence, Owner), chronologisch zusammengeführt. Jeder Eintrag trägt ein kind (“comment” oder “change”), damit ein Systemereignis nie mit einer Wortmeldung verwechselt wird, und ein channel (ui, mcp, cli, sync, system), der sagt, wie er entstand — so erkennt ein Agent seine eigenen Änderungen. Der Changelog ist zielbezogen, daher liefert eine Aufgabe nur Kommentare — die Feld-Historie einer Aufgabe wird am übergeordneten Ziel geführt. Zurückgegeben werden die neuesten Einträge in chronologischer Reihenfolge; gelöschte Kommentare bleiben außen vor.

Erfordert die Kommentar-Funktion

Dieses Werkzeug ist immer sichtbar, liefert aber nur Daten, wenn die Kommentar-Funktion (communication-feed) für Deine Organisation aktiviert ist. Andernfalls antwortet es so, als wäre der Eintrag nicht gefunden worden.

Beschreibung für das Modell

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

The unified feed on ONE subject — a goal or a task — in the connected organization: human comments AND changelog entries (field-level changes such as stage, confidence, owner), chronologically merged. Pass subjectType (“goal” or “task”) and the goal/task id. Every entry carries a kind: a “comment” has authorId/authorName/bodyText/editedAt; a “change” has field/valueBefore/valueAfter plus actorType (user | flow_agent | asana_sync | jira_sync) and a single resolved actor display name — use kind so you never read a system event as something a person said. Every entry (comment or change) also carries a channel saying HOW it was made: ui (the app), mcp (the user via an external agent), cli (the user via the flowagent CLI), sync (an Asana/Jira integration) or system (the Flow Agent) — an entry with channel mcp or cli by the connected user may be your own earlier write. The changelog is goal-scoped, so a TASK subject returns a comments-only feed; a task’s own field-history does not exist (task lifecycle events are recorded on the parent goal — read the goal to see them). Returns the MOST RECENT entries in chronological order; limit caps the merged feed and a note marks when older entries (from either source) were omitted. Deleted comments are excluded. Returns { error: “not_found” } if the subject is not in this organization, is a personal task you cannot see, or the comment feature is off. Read-only.

Parameter

Name	Typ	Pflicht	Einschränkungen	Beschreibung
subjectType	Text	Ja	goal | task	The subject kind the comments belong to
subjectId	Text	Ja		The goal id or task id
limit	Ganzzahl	Nein	1–50	Max feed entries, most recent kept (capped at 50)

Zurück zur Übersicht