朱尔斯·SDK
一个SDK在云中运行一队编码代理
管弦乐团复杂,由来已久的编码任务,与一款GitHub repo融合到一个麻黄云环境.
实例
将工作发送给基于云的会话
import { jules } from '@google/jules-sdk';
const session = await jules.session({
prompt: `Fix visibility issues in the examples/nextjs app.
**Visibility issues**
- White text on white backgrounds
- Low contrast on button hover
**Instructions**
- Update the global styles and page components to a dark theme with the shadcn zinc palette.
`,
source: { github: 'davideast/dataprompt', baseBranch: 'main' },
autoPr: true,
});
监测代理的进展情况
import { jules } from '@google/jules-sdk';
const session = jules.session('<session-id>');
for await (const activity of session.stream()) {
switch (activity.type) {
case 'planGenerated':
console.log(`${activity.plan.steps.length} steps.`);
break;
case 'progressUpdated':
console.log(`${activity.title}`);
// Check for code updates
if (artifact.type === 'changeSet') {
const parsed = artifact.parsed();
for (const file of parsed.files) {
console.log(`${file.path}: +${file.additions} -${file.deletions}`);
}
}
break;
case 'sessionCompleted':
console.log('Session finished successfully.');
break;
}
}
// Get the pull-request URL once complete
const outcome = await session.result();
if (outcome.pullRequest) {
console.log(`PR: ${outcome.pullRequest.url}`);
}
安装
npm i @google/jules-sdk
export JULES_API_KEY=<api-key>
核心特征
用编码代理运行云函数
Jules会话在云中运行,可以运行时没有GitHub寄存器. 我们称之为"无复会" 它们非常强大,因为它们像 预设的服务器功能。 Jules VM 带有预配置的图像,有Node.js,Python,Rust,Bun等许多运行时间和工具.
将上下文通过提示并让代理生成结果.
import { jules } from '@google/jules-sdk';
import { sql } from 'drizzle-orm';
const longDocumentsNobodyWantsToRead = await sql`SELECT * FROM documents`;
const userPrompt = process.argv[2];
const session = await jules.session({
prompt: `You are a assistant that can read long documents and answer questions about them.
## The user's question
${userPrompt}
## The documents
${longDocumentsNobodyWantsToRead.map((e) => e.title).join('\n')}
## Answer Format
Create a markdown response with the following sections:
- Summary
- Answer
- Sources Cited
`,
});
const result = await session.result();
const files = result.generatedFiles();
const answer = files.get('answer.md');
console.log(answer?.content);
// Call the script as CLI
// node index.js "Review the policies and explain to me delivery timelines like I'm 7 years old."
交互式会议
使用 jules.session() 用于您所观察的工作流程,提供反馈,并引导进程.
const session = await jules.session({
prompt: 'Refactor the user authentication module.',
source: { github: 'your-org/your-repo', baseBranch: 'develop' },
});
console.log(`Session created: ${session.id}`);
await session.waitFor('awaitingPlanApproval');
console.log('Plan is ready. Approving it now.');
await session.approve();
const reply = await session.ask(
'Start with the first step and let me know when it is done.',
);
console.log(`[AGENT] ${reply.message}`);
const outcome = await session.result();
console.log(`Session finished with state: ${outcome.state}`);
创建代理会话群
并行处理多个项目 jules.all()感觉就像 Promise.all() 但内置货币控制.
const todos = ['Fix login bug', 'Update README', 'Refactor tests'];
const sessions = await jules.all(todos, (task) => ({
prompt: task,
source: { github: 'user/repo', baseBranch: 'main' },
}));
console.log(`Created ${sessions.length} sessions.`);
更多控制货币计数和错误处理.
const sessions = await jules.all(largeList, mapFn, {
concurrency: 10,
stopOnError: false,
delayMs: 500,
});
查询您的本地知识库
SDK 缓存在本地保存会话数据,并曝光用于过滤和投影所有会话的查询语言.
// Find failed sessions
const failures = await jules.select({
from: 'sessions',
where: { state: 'failed' },
limit: 10,
});
// Get recent agent messages with computed summaries
const messages = await jules.select({
from: 'activities',
where: { type: 'agentMessaged' },
select: ['id', 'createTime', 'summary', 'artifactCount'],
order: 'desc',
limit: 5,
});
反应流
这个 .stream() 方法返回一个 AsyncIterator 观察特工的进展.
for await (const activity of session.stream()) {
switch (activity.type) {
case 'planGenerated':
console.log(
'Plan:',
activity.plan.steps.map((s) => s.title),
);
break;
case 'agentMessaged':
console.log('Agent says:', activity.message);
break;
case 'sessionCompleted':
console.log('Session complete!');
break;
}
}
代码 diffs 与媒体艺术
活动可以包含文物: 代码变化 (:changeSet)或图像(media) (中文(简体) ).
for (const artifact of activity.artifacts) {
if (artifact.type === 'changeSet') {
const parsed = artifact.parsed();
for (const file of parsed.files) {
console.log(`${file.path}: +${file.additions} -${file.deletions}`);
}
}
if (artifact.type === 'media' && artifact.format === 'image/png') {
await artifact.save(`./screenshots/${activity.id}.png`);
}
}
SDK 配置
默认 jules 实例查找环境变量 JULES_API_KEY。如果需要在代码中设置 API 密钥或创建多个实例,请使用 with 方法.
import { jules } from '@google/jules-sdk';
// Multiple API keys
const customJules = jules.with({ apiKey: 'other-api-key' });
// Polling & timeouts
const customJules = jules.with({
pollingIntervalMs: 2000,
timeout: 60000,
});
处理错误
SDK 提供了继承自 JulesError。 。 。 .
import {
jules,
JulesError,
JulesNetworkError,
JulesApiError,
JulesRateLimitError,
MissingApiKeyError
} from '@google/jules-sdk';
try {
const session = await jules.session({ ... });
} catch (error) {
if (error instanceof JulesError) {
console.error(`SDK error: ${error.message}`);
}
}
代理来源
每个代理会议都有一个 source 属性,用于定义会话中使用的源上下文。 这主要是一个 GitHub 寄存器,但会话也可以在没有源头的情况下运行,并且只使用在快取中传递的上下文.
// List all connected sources
for await (const source of jules.sources()) {
if (source.type === 'githubRepo') {
console.log(`${source.githubRepo.owner}/${source.githubRepo.repo}`);
console.log(` Private: ${source.githubRepo.isPrivate}`);
}
}
// Get a specific source
const myRepo = await jules.sources.get({ github: 'my-org/my-project' });
if (myRepo) {
console.log(`Found: ${myRepo.id}`);
}
API 概览
- 核心 :
jules: 预初始化客户端.jules.with(options): 创建自定义配置的新客户端.jules.run(options): 创建自动会话.jules.session(options): 创建或再水合交互式会话.jules.all(items, mapFn, options):批处理.
- 会话控制 :
session.ask():发送消息并等待代理回复.session.send():发火而忘之.session.approve(): 核准一项待决计划.session.waitFor():暂停,直到会话达到特定状态.session.result():等待最终结果.
- 意见:
session.stream(): 所有活动的同步执行者.session.history(): 缓存活动流.session.updates():活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活.session.select(query):查询本地缓存.session.info(): 获取最新会话状态 .
- 工艺:
artifact.save(): 保存到文件系统.artifact.toUrl():获取数据URI.artifact.parsed(): 结构化 diff 解析变化ets.
- 资料来源:
jules.sources(): 在所有相通源头上进行同步传动.jules.sources.get(filter):通过标识获取特定源.
许可证
阿帕奇 - 2.0
说明: 这不是官方支持的Google产品. 本项目没有资格参加 Google 开源软件脆弱性奖励方案。 。 。 .