使用 Copilot 处理议题

注意

Copilot 编码智能体 is in 公共预览版 and subject to change.

简介

可以将 GitHub 议题分配给 Copilot，就像对待人类软件开发人员一样。 Copilot 将开始处理该议题，提出拉取请求，并在处理完成后请求你进行审查。有关详细信息，请参阅“关于将任务分配到 Copilot”。

如果之前没有使用过 Copilot 来处理议题，可以在 Best practices for using Copilot to work on tasks 中找到一些有用的建议，以便获得良好的结果。

将议题分配给 Copilot

可以通过将议题分配给 Copilot 来要求 Copilot 开始处理议题。

可以通过以下方式将议题分配给 Copilot：

在 GitHub.com 上（请参阅下一节）
在 GitHub Mobile 上
通过 GitHub API（请参阅本文后面的内容）
使用 GitHub CLI（请参阅 gh issue edit）

在 GitHub.com 上将议题分配给 Copilot

可以在 GitHub.com 上将议题分配给 Copilot，方法与分配其他用户完全相同。

在 GitHub 上，导航到存储库的主页面。
在存储库名称下，单击 “问题”。
打开想要分配给 Copilot 的议题。
在右侧菜单中，单击“分配”。
从被分配者列表中单击“Copilot”****。

提示

将议题分配给 Copilot 时，系统会发送议题标题、描述和当前存在的任何评论。分配议题后，Copilot 不会知道添加到该议题的任何进一步评论，因此也不会对其做出反应。如果有更多信息，或要对原始要求进行更改，请将其作为评论添加到 Copilot 提出的拉取请求中。

还可以从 GitHub.com 上的其他位置将议题分配给 Copilot：

从仓库的“ Issues”页上的议题列表中****。
在 GitHub 项目中查看议题时。

通过 GitHub API 将议题分配给 Copilot

可以通过向 GraphQL API 发出请求将议题分配给 Copilot。

确保使用用户令牌对 API 进行身份验证，例如 personal access token 或 GitHub App 用户到服务器令牌。

通过检查 GraphQL API 中仓库的 suggestedActors 是否包含 Copilot，验证仓库中是否启用了 Copilot 编码智能体。将 monalisa 替换为仓库所有者，将 octocat 替换为名称。

GraphQL

query {
  repository(owner: "monalisa", name: "octocat") {
    suggestedActors(capabilities: [CAN_BE_ASSIGNED], first: 100) {
      nodes {
        login
        __typename

        ... on Bot {
          id
        }

        ... on User {
          id
        }
      }
    }
  }
}

query {
  repository(owner: "monalisa", name: "octocat") {
    suggestedActors(capabilities: [CAN_BE_ASSIGNED], first: 100) {
      nodes {
        login
        __typename

        ... on Bot {
          id
        }

        ... on User {
          id
        }
      }
    }
  }
}

如果为用户启用了 Copilot 编码智能体且其位于仓库中，则从查询返回的第一个节点的 login 值为 copilot-swe-agent。

获取想要分配给 Copilot 的议题的 GraphQL 全局 ID，将 monalisa 替换为仓库所有者，将 octocat 替换为名称，将 9000 替换为议题编号。

GraphQL

query {
  repository(owner: "monalisa", name: "octocat") {
    issue(number: 9000) {
      id
      title
    }
  }
}

query {
  repository(owner: "monalisa", name: "octocat") {
    issue(number: 9000) {
      id
      title
    }
  }
}

使用 replaceActorsForAssignable GraphQL 突变将议题分配给 Copilot。将 ISSUE_ID 替换为上一步返回的 ID，并将 BOT_ID 替换为上上个步骤返回的 ID。

GraphQL

mutation {
  replaceActorsForAssignable(input: {assignableId: "ISSUE_ID", assigneeIds: ["BOT_ID"]}) {
    assignable {
      ... on Issue {
        id
        title
        assignees(first: 10) {
          nodes {
            login
          }
        }
      }
    }
  }
}

mutation {
  replaceActorsForAssignable(input: {assignableId: "ISSUE_ID", assigneeIds: ["BOT_ID"]}) {
    assignable {
      ... on Issue {
        id
        title
        assignees(first: 10) {
          nodes {
            login
          }
        }
      }
    }
  }
}