@ agentskit/ 合并
简介 : major-package
标记 : agentskit • 妇女 typescript • 妇女 ai-agents
AgentsKit代理的统一、插件和游戏服务集成——一个描述符
每个服务,投放到工具,连接器,触发器,以及认证. 每个
集成为 HTTP/fetch- 只:没有捆绑或要求销售商SDK
(见 ADR-0012 (英语)HTTP (韩语)
重试、 超时- 信号、 校对行为使用 @agentskit/net
运行时间依赖.
已核实的证据
- 软件包元数据和测试在
packages/integrations/。 。 。 . - 软件包指南 : https://www.agentskit.io/docs/for-agents/合并
- 稳定地图: 文件/服务.md
如何适应生态系统
@agentskit/集成将SaaS API变为代理准备工具,连接器,触发器,以及来自一个服务描述符的auth.
- 探员Kit:与本回购中的其他包一起作曲,从可互换的小零件来构建代理.
- 书记官处: 查找已使用此图层的即时代理和模板 登记. agentskit.io。 。 。 .
- 游戏本: 学习本层背后的生产模式 游戏本. agentskit.io。 。 。 .
安装
npm install @agentskit/integrations
快开始
// Most consumers don't author integrations directly — they pull ready-made
// service descriptors from the registry and project them into tools:
import { integrationTools } from '@agentskit/integrations'
export const tools = integrationTools('slack', {
credential: process.env.SLACK_BOT_TOKEN,
})
服务说明人居住在 src/services/。描述者宣布
服务的动作、触发器、认证和 CONFIG_FIELDS; 投影帮助器
将每个消费者需要的描述文字变成表面(a) ToolDefinition
用于运行时间,用于应用程序的连接-形式,一个webhook触发器等).
目录是 捆绑, 只获取 一套~50服务(ADR-0012).
@agentskit/tools 使用此软件包,而不是重新发送集成.
授权新的整合
import { defineIntegration, defineAction } from '@agentskit/integrations'
export const myService = defineIntegration({
name: 'my-service',
http: { baseUrl: 'https://api.example.com' },
actions: [
defineAction({
name: 'send',
schema: { type: 'object', properties: { to: { type: 'string' } }, required: ['to'] },
execute: (args, { http }) => http({ method: 'POST', path: '/send', body: args }),
}),
],
})
执行边界(复原力和安全性)
预测和HTTP共用一套安全合同 (单位:千美元)ADR-0026 (英语):
HttpToolOptions.signal编号 :ProjectionConfig.signal取消打电话者,包括按要求暂停.HttpToolOptions.retry——只选入一能方法的复试:默认一次完全尝试,使用GET编号 :PUT编号 :DELETE正在重试408, (中文(简体) ),425, (中文(简体) ),429, (中文(简体) ),500, (中文(简体) ),502, (中文(简体) ),503,以及504当配置为更多尝试时。 后退以100ms起跑,2秒后起跑,没有焦急.Retry-After以该上限为界;三角洲秒由共享剖析器四舍五入到最接近的毫秒。 网络错误没有重试 .- 重试接缝 —— 说
sleep(delayMs)仍为一证回召;now()提供 HTTP 日期的时钟Retry-After数值。 总体超时也结束了一个待定的自定义睡眠等. - 超时兼容性 —— 说
composeTimeoutSignal仍按版本折旧0.10.0和至少90天的时间。 内容cleanup()解析相容中继; 本地超时信号在自己的时钟上过期. - 来源自定义的 HTTP 何时
baseUrl已经设定,httpJson拒绝跨源路径并禁用自动重定向,因此绑定的证书不能离开该源. - 衍生确认 ——投影部队
requiresConfirmation用于与sideEffect联 合 国write, (中文(简体) ),external,或destructive(描述符不能选择退出). ProjectionConfig.fetchUntrusted——对模型控制的URL进行政策强制获取. 直接耳语(和类似)消费者 必须注入 一个 egrees- policy 获取; 已贬值@agentskit/tools静音外观注射safeFetch独立于提供者fetch。 。 。 .
稳定
beta 可用于生产;说明、登记和投影合同
被运出, 仅获取目录被填入, 执行边界是
明确(ADR-0026)。 还没有 stable: 公众表面仍可轻微移动
随同变换组的笔记发布. 偏爱 ~x.y.z 如果你需要更紧的针.
成熟性和相容性
- 稳定性: β 语录 看到了吗 文件/服务.md
- 节点.js 20+ 财务报告和审定财务报表 类型脚本 严格模式
- 发表于
@agentskit/integrations