AI Agent for Linear Issue Triage & Routing

Unlock Automated Issue Triage with this AI Agent

This AI-driven workflow eliminates the manual bottleneck of triaging new tickets in Linear. When a new issue is created, this agent springs into action. It reads the title and description, sends the context to an OpenAI model, and determines which team is best equipped to handle it based on a customizable knowledge base of your team's responsibilities. The agent then automatically re-assigns the ticket, ensuring it lands in the right hands instantly. If the agent is unsure, it notifies a designated Slack channel for a human to review.

Key Features & Benefits

• AI-Driven Classification: Leverages OpenAI's language understanding to accurately classify issues based on their technical content.
• Automated Routing: Assigns issues to the correct team in Linear without any human intervention, speeding up your development cycle.
• Customizable Team Knowledge: Easily define your teams and their areas of focus in a single node, giving the AI the exact context it needs.
• Smart Exception Handling: If the AI can't confidently classify an issue, it alerts a human via Slack, ensuring nothing falls through the cracks.
• Reduces Manual Workload: Frees up engineering managers and project leads from the repetitive task of ticket triage.

• An n8n instance (Cloud or self-hosted).
• OpenAI API Key with access to a suitable model (e.g., gpt-4 or gpt-3.5-turbo).
• Linear credentials (OAuth2 for the trigger, and a separate API Key for updates).
• Slack API credentials.

1. Download the n8n workflow JSON file and import it into your instance.
2. Configure the 'Linear Trigger' node: connect your OAuth2 credentials and adjust the trigger conditions (e.g., team, state, labels) to match your process.
3. Configure the 'OpenAI' node with your API Key.
4. In the 'Set me up' node, customize the teams variable. List your teams and their responsibilities using the format [Team Name][Description]. The 'Team Name' must exactly match the team name in Linear. Also update the slackChannel variable with your target channel name.
5. Configure the 'Get all linear teams' node with your Linear OAuth2 credentials.
6. Configure the 'Update team' node with your Linear API Key credentials.
7. Configure the 'Notify in Slack' node with your Slack API credentials.
8. Activate the workflow to start automating your issue triage.