托管智能体管理智能体上下文

访问 GitHub

将您的智能体连接到 GitHub 仓库，以进行克隆、读取和创建拉取请求。

您可以将 GitHub 仓库挂载到会话沙箱中，并连接到 GitHub MCP 以创建拉取请求。

GitHub 仓库会被缓存，因此使用相同仓库的后续会话启动速度会更快。

GitHub MCP 和会话资源

首先，创建一个声明 GitHub MCP 服务器的智能体。智能体定义中包含服务器 URL，但不包含身份验证令牌：

AGENT_ID=$(ant beta:agents create --transform id --raw-output < code-reviewer.agent.yaml)

code-reviewer.agent.yaml

name: Code Reviewer
model:
  id: claude-opus-5
system: You are a code review assistant with access to GitHub.
mcp_servers:
  - type: url
    name: github
    url: https://api.githubcopilot.com/mcp/
tools:
  - type: agent_toolset_20260401
  - type: mcp_toolset
    mcp_server_name: github

然后创建一个挂载 GitHub 仓库的会话：

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    resources=[
        {
            "type": "github_repository",
            "url": "https://github.com/org/repo",
            "mount_path": "/workspace/repo",
            "authorization_token": "ghp_your_github_token",
        },
    ],
)

resources[].authorization_token 用于对仓库克隆操作进行身份验证，不会在 API 响应中回显。

挂载仓库时还会加载存储在其根目录 .claude/skills 文件夹中的所有技能。技能在每个会话中仅发现一次，基于会话启动时检出的仓库状态。请参阅从 GitHub 仓库加载技能。

令牌权限

提供 GitHub 令牌时，请使用最低限度的必需权限：

操作	所需作用域
克隆私有仓库	`repo`
创建 PR	`repo`
读取 issue	`repo`（私有）或 `public_repo`
创建 issue	`repo`（私有）或 `public_repo`

多个仓库

通过向 resources 数组添加条目来挂载多个仓库：

resources = [
    {
        "type": "github_repository",
        "url": "https://github.com/org/frontend",
        "mount_path": "/workspace/frontend",
        "authorization_token": "ghp_your_github_token",
    },
    {
        "type": "github_repository",
        "url": "https://github.com/org/backend",
        "mount_path": "/workspace/backend",
        "authorization_token": "ghp_your_github_token",
    },
]

管理运行中会话的仓库

会话创建后，您可以列出其仓库资源并轮换其授权令牌。每个资源都有一个在会话创建时（或通过 resources.list）返回的 id，您可以使用它进行更新。仓库在会话的整个生命周期内保持挂载状态；如需更改挂载的仓库，请创建新会话。

# 列出会话上的资源
listed = client.beta.sessions.resources.list(session.id)
repo_resource_id = listed.data[0].id
print(repo_resource_id)  # "sesrsc_01ABC..."

# 轮换授权令牌
client.beta.sessions.resources.update(
    repo_resource_id,
    session_id=session.id,
    authorization_token="ghp_your_new_github_token",
)

创建拉取请求

借助 GitHub MCP 服务器，智能体可以创建分支、提交更改并推送它们：

client.beta.sessions.events.send(
    session.id,
    events=[
        {
            "type": "user.message",
            "content": [
                {
                    "type": "text",
                    "text": "Fix the type error in src/utils.ts, commit it to a new branch, and push it.",
                },
            ],
        },
    ],
)

后续步骤

会话事件流

在智能体打开拉取请求时流式传输事件并引导智能体

MCP 连接器

连接更多 MCP 服务器，为智能体提供额外的工具

添加文件

在沙箱中与您的仓库一起挂载文件

Was this page helpful?

托管智能体管理智能体上下文

访问 GitHub

将您的智能体连接到 GitHub 仓库，以进行克隆、读取和创建拉取请求。

您可以将 GitHub 仓库挂载到会话沙箱中，并连接到 GitHub MCP 以创建拉取请求。

GitHub 仓库会被缓存，因此使用相同仓库的后续会话启动速度会更快。

GitHub MCP 和会话资源

首先，创建一个声明 GitHub MCP 服务器的智能体。智能体定义中包含服务器 URL，但不包含身份验证令牌：

AGENT_ID=$(ant beta:agents create --transform id --raw-output < code-reviewer.agent.yaml)

code-reviewer.agent.yaml

name: Code Reviewer
model:
  id: claude-opus-5
system: You are a code review assistant with access to GitHub.
mcp_servers:
  - type: url
    name: github
    url: https://api.githubcopilot.com/mcp/
tools:
  - type: agent_toolset_20260401
  - type: mcp_toolset
    mcp_server_name: github

然后创建一个挂载 GitHub 仓库的会话：

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    resources=[
        {
            "type": "github_repository",
            "url": "https://github.com/org/repo",
            "mount_path": "/workspace/repo",
            "authorization_token": "ghp_your_github_token",
        },
    ],
)

resources[].authorization_token 用于对仓库克隆操作进行身份验证，不会在 API 响应中回显。

令牌权限

提供 GitHub 令牌时，请使用最低限度的必需权限：

操作	所需作用域
克隆私有仓库	`repo`
创建 PR	`repo`
读取 issue	`repo`（私有）或 `public_repo`
创建 issue	`repo`（私有）或 `public_repo`

多个仓库

通过向 resources 数组添加条目来挂载多个仓库：

resources = [
    {
        "type": "github_repository",
        "url": "https://github.com/org/frontend",
        "mount_path": "/workspace/frontend",
        "authorization_token": "ghp_your_github_token",
    },
    {
        "type": "github_repository",
        "url": "https://github.com/org/backend",
        "mount_path": "/workspace/backend",
        "authorization_token": "ghp_your_github_token",
    },
]

管理运行中会话的仓库

# 列出会话上的资源
listed = client.beta.sessions.resources.list(session.id)
repo_resource_id = listed.data[0].id
print(repo_resource_id)  # "sesrsc_01ABC..."

# 轮换授权令牌
client.beta.sessions.resources.update(
    repo_resource_id,
    session_id=session.id,
    authorization_token="ghp_your_new_github_token",
)

创建拉取请求

借助 GitHub MCP 服务器，智能体可以创建分支、提交更改并推送它们：

client.beta.sessions.events.send(
    session.id,
    events=[
        {
            "type": "user.message",
            "content": [
                {
                    "type": "text",
                    "text": "Fix the type error in src/utils.ts, commit it to a new branch, and push it.",
                },
            ],
        },
    ],
)

后续步骤

会话事件流

在智能体打开拉取请求时流式传输事件并引导智能体

MCP 连接器

连接更多 MCP 服务器，为智能体提供额外的工具

添加文件

在沙箱中与您的仓库一起挂载文件

Was this page helpful?

GitHub MCP 和会话资源

令牌权限

多个仓库

管理运行中会话的仓库

创建拉取请求

后续步骤

GitHub MCP 和会话资源

令牌权限

多个仓库

管理运行中会话的仓库

创建拉取请求

后续步骤

GitHub MCP 和会话资源

令牌权限

多个仓库

管理运行中会话的仓库

创建拉取请求

后续步骤

GitHub MCP 和会话资源

令牌权限

多个仓库

管理运行中会话的仓库

创建拉取请求

后续步骤