AI Agent for Linear Issue Sentiment Analysis & Negative Trend Alerts

Unlock Proactive Issue Management with this AI Agent

This n8n workflow acts as an AI Agent dedicated to monitoring customer and team sentiment within your Linear issues. It periodically fetches recently updated issues from Linear, then employs OpenAI's language models to perform sentiment analysis on the comment threads. The agent determines if the overall sentiment is positive, negative, or neutral and summarizes its findings. This sentiment data, along with key issue details, is then logged and tracked in an Airtable base. If an issue's sentiment transitions from non-negative to negative, the agent automatically sends a prioritized alert to a designated Slack channel, enabling your team to address potential problems swiftly.

This AI Agent has the following abilities:

• Sentiment Analysis: Understands and categorizes the emotional tone of text.
• Data Tracking & Logging: Records sentiment changes and issue details over time.
• Automated Alerting: Notifies relevant teams of critical sentiment shifts.

Key Features & Benefits

• Continuous Issue Monitoring: Automatically checks for updates in Linear at configurable intervals (e.g., every 30 minutes).
• AI-Powered Sentiment Analysis: Leverages OpenAI to accurately gauge the sentiment (positive, negative, neutral) and generate a summary from issue comment threads.
• Sentiment Trend Tracking: Stores current and previous sentiment scores in Airtable, providing a historical view and enabling transition detection.
• Proactive Negative Sentiment Alerts: Instantly notifies your team via Slack when an issue's sentiment degrades to negative, allowing for timely intervention.
• Data-Driven Insights: Consolidates issue sentiment data in Airtable for easy review, reporting, and identification of broader trends.
• Reduced Alert Fatigue: Includes a mechanism to deduplicate notifications for the same issue update, ensuring your team only receives actionable alerts.

• An n8n instance (Cloud or self-hosted).
• OpenAI API Key.
• Linear API Key (configured as Header Authentication in n8n).
• Airtable Personal Access Token, Base ID, and Table ID. Ensure your Airtable table is set up with fields like 'Issue ID', 'Current Sentiment', 'Previous Sentiment', 'Summary', 'Issue Title', 'Issue Created', 'Issue Updated', 'Assigned'.
• Slack API credentials and the ID of the channel for notifications.

1. Download the n8n workflow JSON file.
2. Import the workflow into your n8n instance.
3. Configure the 'Schedule Trigger' node to set how often the agent checks Linear (e.g., every 30 minutes).
4. In the 'Fetch Active Linear Issues' (GraphQL) node: a. Set up your Linear API Key credentials (select 'HttpHeaderAuth' under Authentication and add your key). b. Modify the variables in the GraphQL query to target specific Linear issues (e.g., filter by updatedAt, team, or project).
5. In the 'OpenAI Chat Model' node, configure your OpenAI API credentials.
6. (Optional) Review the 'Sentiment over Issue Comments' (InformationExtractor) node if you need to adjust the AI's sentiment analysis instructions or attributes (sentiment, sentimentSummary).
7. For the Airtable nodes ('Get Existing Sentiment', 'Update Row'): a. Configure your Airtable credentials (Personal Access Token). b. Enter your Airtable Base ID and Table ID in each node. c. Ensure your Airtable table has columns for: Issue ID (Text), Current Sentiment (Single Select: Positive, Negative, Neutral), Previous Sentiment (Single Select: Positive, Negative, Neutral, N/A), Summary (Long Text), Issue Title (Text), Issue Created (Date), Issue Updated (Date), Assigned (Text).
8. Configure the 'Airtable Trigger' node with your Airtable Base ID, Table ID, and select 'Current Sentiment' as the triggerField.
9. In the 'Report Issue Negative Transition' (Slack) node: a. Configure your Slack API credentials. b. Set the channelId to your desired Slack notification channel. c. (Optional) Customize the alert message in the blocksUi parameter to match your Linear workspace URL and desired format.
10. Activate the workflow.