ClickUp 集成

概览

让你的代理通过 ClickUp 管理任务、项目和效率工作流。借助 AI 驱动的自动化，创建和更新任务、组织项目、管理团队分配，并简化你的效率管理。

前提条件

在使用 ClickUp 集成前，请确保你已经具备：

一个拥有有效订阅的 CrewAI AMP 账号
一个具有相应权限的 ClickUp 账号
已通过集成页面连接你的 ClickUp 账号

配置 ClickUp 集成

1. 连接你的 ClickUp 账号

进入 CrewAI AMP Integrations
在身份验证集成部分找到 ClickUp
点击 Connect 并完成 OAuth 流程
授予任务和项目管理所需的权限
从 Integration Settings 复制你的 Enterprise Token

2. 安装所需包

uv add crewai-tools

3. 环境变量设置

export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

或者将其添加到你的 .env 文件中：

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

可用操作

clickup/search_tasks

描述： 使用高级筛选器搜索 ClickUp 中的任务。

参数：

taskFilterFormula (object, optional): 以析取范式表示的筛选器 - 若干 AND 条件组的 OR。

{
  "operator": "OR",
  "conditions": [
    {
      "operator": "AND",
      "conditions": [
        {
          "field": "statuses%5B%5D",
          "operator": "$stringExactlyMatches",
          "value": "open"
        }
      ]
    }
  ]
}

可用字段：space_ids%5B%5D, project_ids%5B%5D, list_ids%5B%5D, statuses%5B%5D, include_closed, assignees%5B%5D, tags%5B%5D, due_date_gt, due_date_lt, date_created_gt, date_created_lt, date_updated_gt, date_updated_lt

clickup/get_task_in_list

描述： 获取 ClickUp 中指定列表里的任务。

参数：

listId (string, required): 列表 - 选择要从中获取任务的列表。使用 Connect Portal User Settings 让用户选择一个 ClickUp 列表。
taskFilterFormula (string, optional): 搜索匹配指定筛选条件的任务。例如：name=task1。

clickup/create_task

描述： 在 ClickUp 中创建任务。

参数：

listId (string, required): 列表 - 选择要在其中创建此任务的列表。使用 Connect Portal User Settings 让用户选择一个 ClickUp 列表。
name (string, required): 名称 - 任务名称。
description (string, optional): 描述 - 任务描述。
status (string, optional): 状态 - 为此任务选择一个状态。使用 Connect Portal User Settings 让用户选择一个 ClickUp 状态。
assignees (string, optional): 负责人 - 选择一名成员（或成员 ID 数组）分配给此任务。使用 Connect Portal User Settings 让用户选择一个 ClickUp 成员。
dueDate (string, optional): 截止日期 - 指定该任务应在何时到期。
additionalFields (string, optional): 其他字段 - 以 JSON 形式指定要包含在此任务上的其他字段。

clickup/update_task

描述： 在 ClickUp 中更新任务。

参数：

taskId (string, required): 任务 ID - 要更新的任务 ID。
listId (string, required): 列表 - 选择要在其中创建此任务的列表。使用 Connect Portal User Settings 让用户选择一个 ClickUp 列表。
name (string, optional): 名称 - 任务名称。
description (string, optional): 描述 - 任务描述。
status (string, optional): 状态 - 为此任务选择一个状态。使用 Connect Portal User Settings 让用户选择一个 ClickUp 状态。
assignees (string, optional): 负责人 - 选择一名成员（或成员 ID 数组）分配给此任务。使用 Connect Portal User Settings 让用户选择一个 ClickUp 成员。
dueDate (string, optional): 截止日期 - 指定该任务应在何时到期。
additionalFields (string, optional): 其他字段 - 以 JSON 形式指定要包含在此任务上的其他字段。

clickup/delete_task

描述： 在 ClickUp 中删除任务。

参数：

taskId (string, required): 任务 ID - 要删除的任务 ID。

clickup/get_list

描述： 获取 ClickUp 中的列表信息。

参数：

spaceId (string, required): 空间 ID - 包含这些列表的空间 ID。

clickup/get_custom_fields_in_list

描述： 获取 ClickUp 中列表内的自定义字段。

参数：

listId (string, required): 列表 ID - 要获取自定义字段的列表 ID。

clickup/get_all_fields_in_list

描述： 获取 ClickUp 中列表内的所有字段。

参数：

listId (string, required): 列表 ID - 要获取所有字段的列表 ID。

clickup/get_space

描述： 获取 ClickUp 中的空间信息。

参数：

spaceId (string, optional): 空间 ID - 要检索的空间 ID。

clickup/get_folders

描述： 获取 ClickUp 中的文件夹。

参数：

spaceId (string, required): 空间 ID - 包含这些文件夹的空间 ID。

clickup/get_member

描述： 获取 ClickUp 中的成员信息。

参数： 不需要。

使用示例

基础 ClickUp 代理设置

from crewai import Agent, Task, Crew
from crewai import Agent, Task, Crew

# Create an agent with Clickup capabilities
clickup_agent = Agent(
    role="Task Manager",
    goal="Manage tasks and projects in ClickUp efficiently",
    backstory="An AI assistant specialized in task management and productivity coordination.",
    apps=['clickup']  # All Clickup actions will be available
)

# Task to create a new task
create_task = Task(
    description="Create a task called 'Review Q1 Reports' in the Marketing list with high priority",
    agent=clickup_agent,
    expected_output="Task created successfully with task ID"
)

# Run the task
crew = Crew(
    agents=[clickup_agent],
    tasks=[create_task]
)

crew.kickoff()

筛选特定 ClickUp 工具

task_coordinator = Agent(
    role="Task Coordinator",
    goal="Create and manage tasks efficiently",
    backstory="An AI assistant that focuses on task creation and status management.",
    apps=['clickup/create_task']
)

# Task to manage task workflow
task_workflow = Task(
    description="Create a task for project planning and assign it to the development team",
    agent=task_coordinator,
    expected_output="Task created and assigned successfully"
)

crew = Crew(
    agents=[task_coordinator],
    tasks=[task_workflow]
)

crew.kickoff()

高级项目管理

from crewai import Agent, Task, Crew

project_manager = Agent(
    role="Project Manager",
    goal="Coordinate project activities and track team productivity",
    backstory="An experienced project manager who ensures projects are delivered on time.",
    apps=['clickup']
)

# Complex task involving multiple ClickUp operations
project_coordination = Task(
    description="""
    1. Get all open tasks in the current space
    2. Identify overdue tasks and update their status
    3. Create a weekly report task summarizing project progress
    4. Assign the report task to the team lead
    """,
    agent=project_manager,
    expected_output="Project status updated and weekly report task created and assigned"
)

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

crew.kickoff()

任务搜索与管理

from crewai import Agent, Task, Crew

task_analyst = Agent(
    role="Task Analyst",
    goal="Analyze task patterns and optimize team productivity",
    backstory="An AI assistant that analyzes task data to improve team efficiency.",
    apps=['clickup']
)

# Task to analyze and optimize task distribution
task_analysis = Task(
    description="""
    Search for all tasks assigned to team members in the last 30 days,
    analyze completion patterns, and create optimization recommendations
    """,
    agent=task_analyst,
    expected_output="Task analysis report with optimization recommendations"
)

crew = Crew(
    agents=[task_analyst],
    tasks=[task_analysis]
)

crew.kickoff()

获取帮助

Need Help?

Contact our support team for assistance with ClickUp integration setup or troubleshooting.