개요

에이전트가 Linear를 통해 이슈, 프로젝트, 개발 워크플로우를 관리할 수 있도록 지원합니다. 이슈를 생성 및 업데이트하고, 프로젝트 타임라인을 관리하며, 팀을 조직하고, AI 기반 자동화로 소프트웨어 개발 프로세스를 간소화할 수 있습니다.

필수 조건

Linear 통합을 사용하기 전에 다음을 확인하세요:

리니어 통합 설정

1. Linear 계정 연결하기

  1. CrewAI Enterprise Integrations로 이동합니다.
  2. 인증 통합( Authentication Integrations ) 섹션에서 Linear를 찾습니다.
  3. Connect를 클릭하고 OAuth 절차를 완료합니다.
  4. 이슈 및 프로젝트 관리를 위한 필수 권한을 부여합니다.
  5. 계정 설정에서 Enterprise Token을 복사합니다.

2. 필수 패키지 설치

uv add crewai-tools

사용 가능한 작업

사용 예시

기본 Linear 에이전트 설정

from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools

# Get enterprise tools (Linear tools will be included)
enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token"
)

# Create an agent with Linear capabilities
linear_agent = Agent(
    role="Development Manager",
    goal="Manage Linear issues and track development progress efficiently",
    backstory="An AI assistant specialized in software development project management.",
    tools=[enterprise_tools]
)

# Task to create a bug report
create_bug_task = Task(
    description="Create a high-priority bug report for the authentication system and assign it to the backend team",
    agent=linear_agent,
    expected_output="Bug report created successfully with issue ID"
)

# Run the task
crew = Crew(
    agents=[linear_agent],
    tasks=[create_bug_task]
)

crew.kickoff()

특정 Linear 도구 필터링

from crewai_tools import CrewaiEnterpriseTools

# Get only specific Linear tools
enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token",
    actions_list=["linear_create_issue", "linear_update_issue", "linear_search_issue"]
)

issue_manager = Agent(
    role="Issue Manager",
    goal="Create and manage Linear issues efficiently",
    backstory="An AI assistant that focuses on issue creation and lifecycle management.",
    tools=enterprise_tools
)

# Task to manage issue workflow
issue_workflow = Task(
    description="Create a feature request issue and update the status of related issues to reflect current progress",
    agent=issue_manager,
    expected_output="Feature request created and related issues updated"
)

crew = Crew(
    agents=[issue_manager],
    tasks=[issue_workflow]
)

crew.kickoff()

프로젝트 및 팀 관리

from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools

enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token"
)

project_coordinator = Agent(
    role="Project Coordinator",
    goal="Coordinate projects and teams in Linear efficiently",
    backstory="An experienced project coordinator who manages development cycles and team workflows.",
    tools=[enterprise_tools]
)

# Task to coordinate project setup
project_coordination = Task(
    description="""
    1. Search for engineering teams in Linear
    2. Create a new project for Q2 feature development
    3. Associate the project with relevant teams
    4. Create initial project milestones as issues
    """,
    agent=project_coordinator,
    expected_output="Q2 project created with teams assigned and initial milestones established"
)

crew = Crew(
    agents=[project_coordinator],
    tasks=[project_coordination]
)

crew.kickoff()

이슈 계층 구조 및 하위 작업 관리

from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools

enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token"
)

task_organizer = Agent(
    role="Task Organizer",
    goal="Organize complex issues into manageable sub-tasks",
    backstory="An AI assistant that breaks down complex development work into organized sub-tasks.",
    tools=[enterprise_tools]
)

# Task to create issue hierarchy
hierarchy_task = Task(
    description="""
    1. 세분화가 필요한 대형 기능 이슈를 검색합니다
    2. 각 복잡한 이슈에 대해 다양한 컴포넌트별로 하위 이슈를 생성합니다
    3. 부모 이슈를 적절한 설명과 하위 이슈에 대한 링크로 업데이트합니다
    4. 전문성에 따라 적합한 팀원에게 하위 이슈를 할당합니다
    """,
    agent=task_organizer,
    expected_output="복잡한 이슈가 적절히 할당된 관리 가능한 하위 작업 단위로 분해됨"
)

crew = Crew(
    agents=[task_organizer],
    tasks=[hierarchy_task]
)

crew.kickoff()

자동화된 개발 워크플로우

from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools

enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token"
)

workflow_automator = Agent(
    role="Workflow Automator",
    goal="Automate development workflow processes in Linear",
    backstory="An AI assistant that automates repetitive development workflow tasks.",
    tools=[enterprise_tools]
)

# Complex workflow automation task
automation_task = Task(
    description="""
    1. 7일 이상 진행 중인 이슈를 검색합니다
    2. 마감일과 프로젝트 중요도에 따라 우선순위를 업데이트합니다
    3. 각 팀을 위한 주간 스프린트 계획 이슈를 생성합니다
    4. 이전 사이클에서 완료된 이슈를 보관합니다
    5. 프로젝트 상태 보고서를 새로운 이슈로 생성합니다
    """,
    agent=workflow_automator,
    expected_output="우선순위, 스프린트 계획, 상태 보고서가 업데이트된 자동화된 개발 워크플로우"
)

crew = Crew(
    agents=[workflow_automator],
    tasks=[automation_task]
)

crew.kickoff()

문제 해결

일반적인 문제

권한 오류
  • Linear 계정이 대상 워크스페이스에 필요한 권한을 가지고 있는지 확인하세요
  • OAuth 연결에 Linear API에 필요한 스코프가 포함되어 있는지 확인하세요
  • 워크스페이스에서 이슈 및 프로젝트를 생성/편집할 권한이 있는지 확인하세요
잘못된 ID 및 참조
  • 팀 ID, 이슈 ID, 프로젝트 ID가 올바른 UUID 형식인지 다시 한번 확인하세요
  • 참조된 엔티티(팀, 프로젝트, 사이클)가 존재하며 접근 가능한지 확인하세요
  • 이슈 식별자가 올바른 형식(예: “ABC-1”)을 따르는지 검증하세요
팀 및 프로젝트 연관 문제
  • 이슈나 프로젝트를 생성하기 전에 LINEAR_SEARCH_TEAMS를 사용하여 유효한 팀 ID를 조회하세요
  • 워크스페이스 내에 팀이 존재하고 활성화되어 있는지 확인하세요
  • 팀 ID가 올바르게 UUID 형식으로 구성되어 있는지 검증하세요
이슈 상태 및 우선순위 문제
  • 상태 ID가 팀의 유효한 워크플로우 상태를 참조하는지 확인하세요
  • 우선순위 값이 Linear 구성에서 허용된 범위 내에 있는지 확인하세요
  • 참조하기 전에 사용자 지정 필드와 라벨이 존재하는지 검증하세요
날짜 및 시간 형식 문제
  • 마감일 및 타임스탬프에 ISO 8601 형식을 사용하세요
  • 마감일 계산 시 타임존을 올바로 처리하는지 확인하세요
  • 마감일의 날짜 값이 유효하며 미래인지 검증하세요
검색 및 필터 문제
  • 검색 쿼리가 올바르게 형식화되어 있으며 비어 있지 않은지 확인하세요
  • 필터 공식에서 유효한 필드 이름을 사용하세요: title, number, project, createdAt
  • 복잡한 다중 조건 쿼리를 만들기 전에 단순한 필터를 먼저 테스트해 보세요
  • 연산자 타입이 필터링 대상 필드의 데이터 타입과 일치하는지 확인하세요
서브이슈 생성 문제
  • 상위 이슈 ID가 유효하고 접근 가능한지 확인하세요
  • 서브이슈의 팀 ID가 상위 이슈 팀과 일치하거나 호환되는지 검증하세요
  • 상위 이슈가 이미 보관/삭제되지 않았는지 확인하세요

도움 받기

도움이 필요하신가요?

Linear 연동 설정 또는 문제 해결에 대해 지원팀에 문의하세요.