构建与 GitHub 深度集成的自动化工作流指南

通过这一步，我们的工作流就拥有了理解和生成人类语言的能力。

第四节：完美收官——设置结束节点

经过大模型的处理，我们已经得到了想要的答案。最后一步，就是将这个答案清晰地呈现给我们。这就是'结束节点'的任务。

操作步骤：

1. 添加结束节点: 在大模型节点之后，添加一个'结束'节点。
2. 自动连接: 通常情况下，这个节点会自动连接到大模型节点的输出，无需过多配置。

至此，一个完整的基础工作流就已经搭建完成了。它的结构清晰，逻辑简单：

开始 -> 输入 -> 大模型处理 -> 结束

第五节：首次运行与效果展示

理论必须与实践相结合。现在，让我们来运行这个刚刚创建的工作流。

操作步骤：

1. 点击运行: 在工作流界面的右上角，找到并点击'运行'按钮。
2. 输入问题: 工作流启动后，会首先显示我们在'开始节点'设置的开场白。接着，在输入框中输入一个问题，例如：'什么是人工智能？'
3. 查看结果: 点击发送后，工作流会依次执行输入、大模型处理和结束节点。很快，你就会在界面上看到大模型生成的关于人工智能的详细解答。

这个基础工作流虽然简单，但它验证了整个流程的可行性，并为我们接下来集成更复杂的工具（如 GitHub_MCP）打下了坚实的基础。

第二章：超级赋能——在工作流中集成 GitHub_MCP

如果说基础工作流是给了我们一个智能对话的框架，那么集成 GitHub_MCP 工具，就相当于为这个框架插上了翅膀，让它能够飞出本地的对话框，直接在广阔的 GitHub 世界中翱翔和作业。

第一节：获取通行证——生成你的 GitHub 个人访问令牌

要让我们的工作流代表我们去操作 GitHub，首先需要向 GitHub 证明'我们是我们自己'。这就需要一个特殊的'通行证'——个人访问令牌（Personal Access Token, PAT）。

操作步骤：

1. 访问 GitHub 设置: 登录你的 GitHub 账户，点击右上角的个人头像，在下拉菜单中选择 Settings（设置）。
2. 进入开发者设置: 在左侧导航栏中，滚动到底部，找到并点击 Developer settings（开发者设置）。
3. 选择个人访问令牌: 在开发者设置页面，依次选择 Personal access tokens -> Tokens (classic)。然后点击 Generate new token 按钮，并选择 Generate new token (fine-grained)。
   • 重点说明: 这里强烈建议选择 Fine-grained tokens。与传统的 Classic tokens 相比，Fine-grained tokens 提供了更精细的权限控制。
4. 配置令牌属性:
   • Token name: 给你的令牌起一个有意义的名字，比如 'Workflow_Agent_Token'。
   • Expiration: 为了方便长期使用和测试，可以选择 No expiration（无过期）。但在生产环境中，出于安全考虑，建议设置一个合理的过期时间。
5. 授予权限 (Permissions): 这是整个过程中最核心、最需要谨慎操作的一步。
   • Repository access: 选择 All repositories 或 Only select repositories。
   • Permissions: 向下滚动，你会看到一个长长的权限列表。文档中为了最大化演示功能，建议将所有权限都打开，并将每个权限的操作级别设置为 Read and write。
     • 安全警告: 在实际应用中，请务必遵循最小权限原则。如果你的工作流只需要创建 Issue，那就只授予 Issues (Read and write) 权限。
6. 生成并保存令牌: 配置完所有权限后，滚动到页面底部，点击 Generate token 按钮。
7. 立即复制并妥善保管: 令牌生成后，会且仅会显示一次。你必须立即点击复制按钮，并将其保存在一个安全的地方。

第二节：节点连接——在工作流中配置智能体

获取了令牌之后，我们就要回到工作流的构建界面，将这把'钥匙'交给一个能够使用它的角色——'智能体（Agent）'节点。

操作步骤：

1. 添加智能体节点: 打开我们之前创建的基础工作流。在输入节点后添加一个'智能体'节点。你可以选择替换掉之前的大模型节点，或者将其置于大模型节点之前。
2. 添加工具: 进入智能体节点的设置界面，你会看到一个'添加工具'的选项。
3. 搜索并选择 GitHub 工具: 在工具市场或工具列表中，搜索关键词 "github"。
4. 输入密钥并连接: 选择 GitHub_MCP 工具后，系统会要求你提供凭证。这时，将你刚刚在 GitHub 生成并保存的个人访问令牌（PAT）粘贴到指定的输入框中，然后点击'链接'或'保存'。
5. 验证连接成功: 如果你的令牌是有效的，系统会显示一个连接成功的提示。
6. 在智能体中正式启用工具: 回到智能体节点的设置界面，再次点击'添加工具'，在'MCP 工具'分类下，你现在应该能看到已经成功链接的 GitHub_MCP 工具。点击它，然后点击'添加'按钮，将其正式加入到该智能体的可用工具箱中。

完成这一步后，你的智能体节点就已经被成功赋能了。

第三节：能力清单——深入了解 GitHub_MCP 的强大功能

以下是 GitHub_MCP 工具集中包含的核心功能：

（注：表格中仅列举了部分常用功能，完整列表请参考文档。）

第三章：实战演练——释放自动化工作流的真正威力

第一节：信息检索——你的专属 GitHub 搜索引擎

对于开发者来说，GitHub 不仅是代码托管平台，更是一个巨大的知识库和灵感来源。

任务一：搜索关于 'PyTorch' 的仓库

目标: 我们希望工作流能像 GitHub 的搜索功能一样，帮我们找到与深度学习框架 'PyTorch' 相关的仓库，并返回第一页的结果。

操作步骤：

1. 设置提示词 (Prompt): 在运行工作流时，向它输入清晰、直接的指令。
   • 用户输入: 请帮我搜索一下 GitHub 上关于 'PyTorch' 的仓库，并返回第一页的结果。

执行过程揭秘：

当智能体接收到这个指令后，它内部的大模型会进行'思考'：

1. 意图识别: 模型首先识别出用户的核心意图是'搜索 GitHub 仓库'。
2. 工具选择: 接着，它会浏览自己拥有的工具列表，发现 search_repositories 这个功能完美匹配当前任务。
3. 参数提取: 模型从用户的输入中提取出 search_repositories 功能所需要的参数。很明显，query 参数就是 'PyTorch'。
4. 工具调用: 智能体随后执行 github_mcp.search_repositories(query='PyTorch', page=1)。
5. 结果格式化: API 调用会返回一串结构化的数据（通常是 JSON 格式），包含了仓库的名称、所有者、描述、URL 等信息。智能体的大模型会将这些原始数据进行整理和美化，以一种更易读的格式呈现给用户。

效果验证：

为了验证其准确性，我们可以手动打开 GitHub 网站，进行相同的搜索。你会发现，工作流返回的结果与 GitHub 官方搜索结果的第一页是完全一致的。

这个看似简单的任务，完美展示了工作流的价值：它将一个多步骤的网页操作，简化成了一次自然语言对话，极大地提升了信息获取的效率。

第二节：趋势追踪——动态获取 GitHub 热门项目

紧跟技术趋势是每个开发者的必修课。GitHub Trending 页面是发现当下最火、最受关注项目的重要渠道。

任务二：获取今日的 GitHub 热门项目

目标: 让工作流返回当天 GitHub 上的热门项目列表，要求包含详细的英文说明，并附上快速跳转链接。

操作步骤：

1. 用户输入: 帮我获取今日的 GitHub 热门项目，需要有详细的英文说明，并附带一个快速跳转链接。

执行过程揭秘：

这个任务比上一个稍微复杂一些。GitHub_MCP 工具列表中可能没有一个直接名为 get_trending_repositories 的功能。这时，智能体的大模型会展现出更强的推理能力：

1. 意图理解: '热门项目'通常与'星星数（stars）'的增长趋势有关。
2. 策略规划: 模型可能会制定一个策略：使用 search_repositories 功能，但构造一个特殊的查询。GitHub 的搜索支持多种限定符，比如 stars:>N，或者按照 updated 日期排序。一个聪明的模型可能会构造一个类似 q='stars:>100 created:>{today-1day}' sort='stars' order='desc' 这样的高级查询，来模拟'今日热门'的效果。
3. 工具执行与结果呈现: 执行搜索后，同样将返回的结果进行美化，提取英文描述和 URL，然后呈现出来。

通过这个任务，我们看到了智能体不仅仅是简单的 API 执行者，它还能在一定程度上理解抽象概念（如'热门'），并将其转化为具体可执行的工具调用策略。

第三节：项目管理——直接在工作流中提交 Issue

这可能是最能体现工作流与 GitHub 深度集成价值的功能之一。在开发过程中，发现 Bug 或有新想法时，我们需要去对应的仓库创建一个 Issue。

任务三：为指定仓库提交一个具体的 Issue

背景: 假设我是项目 undoom-douyin-data-analysis 的使用者，我发现了一个问题：内置浏览器在某些情况下需要用户手动登录，影响了体验。

目标: 通过工作流，向 https://github.com/kk520879/undoom-douyin-data-analysis 这个仓库提交一个 Issue。

操作步骤：

1. 用户输入: 我们需要提供所有必要的信息：仓库地址、Issue 的内容和标题。
   • 请针对我的 undoom-douyin-data-analysis Public 仓库提交一个 issues 内容是：目前可能会出现内置浏览器打开需要进行登录操作或者是弹窗，需要进行一个持久化的操作甚至是增加一个内置 tool 进行用户登录操作
   • 为了让 Issue 更规范，我们可以补充一个标题：标题是：【功能建议】优化内置浏览器登录体验，增加持久化登录

执行过程揭秘：

1. 意图识别: 核心意图是'提交 Issue'。
2. 工具选择: 智能体立即锁定 create_issue 功能。
3. 参数提取:
   • repo: 从仓库名 undoom-douyin-data-analysis 中提取。
   • owner: 从 GitHub 用户名 kk520879 中提取。
   • title: 从用户输入的'标题是：…'中提取。
   • body: 提取用户描述的问题和建议内容。
4. 智能优化（亮点）: 工作流在执行创建 Issue 之前，可能会调用其内置的大模型能力，对用户输入的 body 内容进行优化和润色。它可能会将口语化的描述变得更书面化、结构化，使其看起来更专业，甚至补充一些上下文。
5. 工具调用: 执行 github_mcp.create_issue(owner='kk520879', repo='undoom-douyin-data-analysis', title='...', body='...')。

结果展示与验证：

工作流会返回一个确认信息，通常会包含新创建 Issue 的编号和链接。我们可以点击这个链接，或者直接访问 GitHub 上的该仓库。在 'Issues' 标签页下，我们会赫然发现一个新的 Issue 已经被成功创建。

这个实战案例的意义是巨大的。它意味着，从发现问题、构思描述到最终创建任务记录，整个项目管理的闭环都可以在一个统一的对话界面中完成，无需切换应用，无需中断心流。这对于提升开发者的专注度和工作效率有着不可估量的价值。