Jules API 技能

通过 REST API 与 Google Jules AI 编码代理进行交互。Jules 可以自主在你的 GitHub 仓库上执行编码任务——编写代码、修复错误、添加测试以及创建拉取请求。

基础 URL： https://jules.googleapis.com/v1alpha
认证： 通过 x-goog-api-key 请求头传递你的 API 密钥。在 jules.google.com/settings 获取密钥。

列出源（已连接的仓库）

发现哪些 GitHub 仓库已连接到你的 Jules 账户：

bash
curl -s -H x-goog-api-key: $JULESAPIKEY \
https://jules.googleapis.com/v1alpha/sources?pageSize=30

带分页：

bash
curl -s -H x-goog-api-key: $JULESAPIKEY \
https://jules.googleapis.com/v1alpha/sources?pageSize=10&pageToken=PAGE_TOKEN

过滤特定源：

bash
curl -s -H x-goog-api-key: $JULESAPIKEY \
https://jules.googleapis.com/v1alpha/sources?filter=name%3Dsources%2Fgithub-owner-repo

获取单个源

获取特定仓库的详细信息和分支：

bash
curl -s -H x-goog-api-key: $JULESAPIKEY \
https://jules.googleapis.com/v1alpha/sources/SOURCE_ID

示例：sources/github-myorg-myrepo——替换为从列出源获取的实际源 ID。

创建会话（开始编码任务）

创建一个新的 Jules 会话以在仓库上执行编码任务：

bash
curl -s -X POST \
-H x-goog-api-key: $JULESAPIKEY \
-H Content-Type: application/json \
-d {
prompt: TASK_DESCRIPTION,
title: OPTIONAL_TITLE,
sourceContext: {
source: sources/github-OWNER-REPO,
githubRepoContext: {
startingBranch: main
}
},
requirePlanApproval: true
} \
https://jules.googleapis.com/v1alpha/sessions

参数

自动批准 + 自动 PR 示例

bash
curl -s -X POST \
-H x-goog-api-key: $JULESAPIKEY \
-H Content-Type: application/json \
-d {
prompt: 为认证模块添加全面的单元测试,
sourceContext: {
source: sources/github-myorg-myrepo,
githubRepoContext: { startingBranch: main }
},
automationMode: AUTOCREATEPR
} \
https://jules.googleapis.com/v1alpha/sessions

列出会话

列出你所有的 Jules 会话：

bash
curl -s -H x-goog-api-key: $JULESAPIKEY \
https://jules.googleapis.com/v1alpha/sessions?pageSize=10

使用 pageToken 进行分页：

bash
curl -s -H x-goog-api-key: $JULESAPIKEY \
https://jules.googleapis.com/v1alpha/sessions?pageSize=10&pageToken=NEXTPAGETOKEN

获取单个会话

通过 ID 检索单个会话（如果已完成，包含 PR 等输出）：

bash
curl -s -H x-goog-api-key: $JULESAPIKEY \
https://jules.googleapis.com/v1alpha/sessions/SESSION_ID

会话状态

批准计划

当会话处于 AWAITINGPLANAPPROVAL 状态时，批准计划：

bash
curl -s -X POST \
-H x-goog-api-key: $JULESAPIKEY \
-H Content-Type: application/json \
-d {} \
https://jules.googleapis.com/v1alpha/sessions/SESSION_ID:approvePlan

发送消息

向活动会话发送反馈、回答问题或提供额外指示：

bash
curl -s -X POST \
-H x-goog-api-key: $JULESAPIKEY \
-H Content-Type: application/json \
-d {
prompt: YOURMESSAGEHERE
} \
https://jules.googleapis.com/v1alpha/sessions/SESSION_ID:sendMessage

当会话状态为 AWAITINGUSERFEEDBACK 时使用此功能，或在 IN_PROGRESS 期间提供额外指导。

列出活动（监控进度）

获取会话的所有事件/进度：

bash
curl -s -H x-goog-api-key: $JULESAPIKEY \
https://jules.googleapis.com/v1alpha/sessions/SESSION_ID/activities?pageSize=50

获取特定时间戳之后的活动（用于轮询）：

bash
curl -s -H x-goog-api-key: $JULESAPIKEY \
https://jules.googleapis.com/v1alpha/sessions/SESSION_ID/activities?createTime=2026-01-17T00:03:53Z

活动类型

活动将恰好包含以下事件字段之一：

产物

活动可能包含产物：

• - ChangeSet：带有 gitPatch 的代码更改（统一差异、基础提交、建议的提交消息）
• BashOutput：带有 command、output、exitCode 的命令输出
• Media：带有 mimeType 和 base64 data 的二进制输出

获取单个活动

bash
curl -s -H x-goog-api-key: $JULESAPIKEY \
https://jules.googleapis.com/v1alpha/sessions/SESSIONID/activities/ACTIVITYID

删除会话

bash
curl -s -X DELETE \
-H x-goog-api-key: $JULESAPIKEY \
https://jules.googleapis.com/v1alpha/sessions/SESSION_ID

典型工作流程

1. 1. 列出源 以查找仓库资源名称
2. 创建会话，使用描述任务的提示词
3. 轮询会话（获取会话）以跟踪状态变化
4. 列出活动 以监控进度并阅读 Jules 的消息
5. 如果设置了 requirePlanApproval，当状态为 AWAITINGPLANAPPROVAL 时批准计划
6. 如果状态为 AWAITINGUSERFEEDBACK，发送消息并附上你的回复
7. 当状态为 COMPLETED 时，获取会话以找到输出的 PR URL

错误处理