get_engagement_comments
ChatGPTReturns engagement survey comments and open-text responses. Use this to understand the "why" behind engagement scores. PREREQUISITE: Call get_user_context first to confirm the user has access to engagement comments. When to use: - After seeing low or concerning scores in get_engagement_results - "What are people saying about [topic]?" - "Show me recent feedback comments" - "Why is [metric] score low?" - look at related comments - Preparing for team discussions or action planning What you get: - Comment text with question context - Date and recency (latest survey indicator) - Sentiment analysis (Positive or Negative when available) - Reply count for each comment - Grouped by question for easy reading Filtering options: - Filter by team (same as get_engagement_results) - Filter by specific question, theme, or KPI (recommended for topic-based queries) - Text search for specific words (use with caution - see below) - Adjust time period to see older/newer comments Text search limitations (search_text parameter): - Literal text matching only, not semantic/AI search - Case-insensitive but language-dependent - Comments are often in the workspace's local language (Finnish, Swedish, etc.) - Searching English terms in non-English workspaces will return no results - Prefer question/theme/kpi filters for topic-based filtering Privacy: - Comments are anonymous - no author information - Visibility rules are respected (workspace/team/admin-only) - Only shows comments the user is authorized to see Example workflow: 1. Call get_engagement_results → see "Workload" score is 54 (low) 2. Call get_engagement_comments with question: "Workload" to understand why 3. Summarize themes from comments for actionable insights Examples with exact parameters: - "Recent comments" → { "time_period_days": 30 } - "Comments about workload" → { "question": "Workload" } (preferred) - "Leadership theme feedback" → { "theme": "Leadership" } - "Engineering team comments" → { "team": "Engineering" } - "Wellbeing KPI feedback" → { "kpi": "Wellbeing" } - "Comments mentioning 'manager'" → { "search_text": "manager" } (use sparingly, language-dependent)






