@ agent-relay/ agent( 代理服务器)
主动的代理跑步时间——一个接线员,三个触发器,一个工作空间.
网站: agentrelay.com (英语) • 妇女 文档 : extrelay.com/docs (英语)
它会做什么
@agent-relay/agent 让开发商在不到10分钟和~30行的代码内运送主动代理. 一个 agent({ ... }) 一号电话 onEvent 处理器和运行时间将克龙调度表、文件表和收件箱信息接入单一的常态流——共享工作空间+ ctx政策定位、重试、破解和追踪.
这是建立在 @agent-relay/events (Layer 2——迁移-不可知事件流)并曝光了工作空间-意识 第3层表面开发者实际上想要调用.
安装
npm install @agent-relay/agent
快开始
import { agent } from '@agent-relay/agent';
const handle = agent({
workspace: 'support',
schedule: { every: '5m' },
watch: ['/linear/issues/**'],
onEvent: async (event, ctx) => {
switch (event.type) {
case 'cron.tick':
await ctx.messages.post({ channel: '#triage', text: 'tick' });
return;
case 'relayfile.changed':
const issue = await event.expand('full');
await ctx.once(`triage:${event.id}`, async () => {
// dedup-safe work
});
return;
}
},
});
// ... later
await handle.stop();
处理者合同
每个处理器都收到 (event, ctx)数字 :
event- 正常化AgentEvent信封(轻;呼叫)event.expand('full')页:1ctx工作空间认识背景:ctx.workspace, (中文(简体) ),ctx.agentId, (中文(简体) ),ctx.logger, (中文(简体) ),ctx.signal(AbortSignal), (美国英语),ctx.schedule.{at,every,cancel}, (中文(简体) ),ctx.once(key, fn), (中文(简体) ),ctx.files, (中文(简体) ),ctx.messages
政策执行
agent({
workspace: 'support',
policy: { mode: 'approval-required', approvals: ['#triage-leads'] },
onEvent: async (event, ctx) => {
// each side-effect is gated through policy
await ctx.messages.post({ channel: '#triage', text: 'ack' });
},
});
| 模式 | 行为 |
|---|---|
suggest | Ctx 的表面意图; 不执行 |
auto | 立即执行( 默认) |
approval-required | 阻止人类通过 approvals 频道 |
托管代理部署
import { deployAgent } from '@agent-relay/agent';
await deployAgent({
name: 'support-triage',
workspace: 'support',
source: './agent.ts',
provider: { mode: 'byok' },
});
(见 主动代理 运行时光谱 §7 为主机代理语义学. )
燃烧( LLM 调用标记)
LLM 呼叫内部 ctx.* 自动标记为 (workspace, agentId, event.type, event.id) 可通过 burn。将任意代码路径与 withBurnTags({...}, fn) 如果您需要添加自定义尺寸.
相关
@agent-relay/events—— 第2层规范事件流,其基础是@agent-relay/sdk——经纪人控制+工作流程协调- 主动代理运行时光谱 - 这个装置的设计
许可证
阿帕奇-2.0 — 见 自由主义。 。 。 .