@alvin0/ai-agent-sdk-core
提供商中立合同和运行时间原始,用于构建模型适配器和流式AI应用.
运行时间 : 通用。发布代码使用 ECMAScript、 获取兼容类型、 Web Streams、 中止控制器、 性能计时器和 Web Crypto 。 它不使用节点内置, process, (中文(简体) ), Buffer,本地路径,文件系统访问,儿童过程,或 stdio.
pnpm add @alvin0/ai-agent-sdk-core
createAgentRuntime() 是推荐成分根. defineAgent()
抓取可重复使用的代理定义,每次运行时间都会显示 SdkLogger
其记录共享运行时间/运行相关性和隐私政策:
import {
createAgentRuntime,
defineAgent,
type SdkLogger,
} from '@alvin0/ai-agent-sdk-core'
const runtime = await createAgentRuntime({ providers: [provider] })
const definition = defineAgent({ id: 'assistant', instructions: 'Be concise.' })
const logger: SdkLogger = runtime.logger({ fields: { component: 'assistant' } })
const agent = runtime.agent({ ...definition, model: { provider: 'openai', id: 'gpt-6-luna' } })
logger.info('agent ready')
import { ModelAdapter, ModelRegistry } from '@alvin0/ai-agent-sdk-core'
const registry = new ModelRegistry()
registry.registerAdapter(['example'], new YourAdapter())
const call = registry.stream({
provider: 'example',
model: 'model-id',
messages: [],
})
for await (const chunk of call) {
// Consume normalized chunks.
}
const report = await call.report
该套件包括电文和流合同、示范登记和再试验原始数据、正常错误、使用会计、明确的观察/联系端口以及交易提供者-插件登记。 供应商HTTP/SSE运输、混凝土出口商、文件系统技能、环境证书和协议执行属于单独的成套能力.
文档根加 /agent, (中文(简体) ), /memory, (中文(简体) ), /observability, (中文(简体) ), /provider, (中文(简体) ),
/skills, (中文(简体) ), /tools, (中文(简体) ), /embedding,以及 ./package.json 是公开的。 内部源路径为
不符合合同.
会议 hooks.beforeCompletion 可能返回 { kind: 'continue', messages: [...] }
在模型自愿停止后完成待处理的应用工作。 使用
createUserMessage 与 source: { kind: 'app', producer: 'your-workflow' }。 。 。 .
SDK在同一转弯和运行中消耗了这个上下文,保留了用法,
剩余预算、注销和原始历史。 继续被忽略
能力已经用尽。 这个钩子在空答恢复前运行 所以可以
继续采用在评论后停止、没有最后答复的模式.
每条信息都必须是应用源;混合或
人类来源的批次在解剖学上被否决. 空批次本身不是
继续转弯。 主机应绑定重复的完成异议并停止
当工作流程不再取得进展时. { kind: 'yield' } 仍然暂停
没有最终完成或深入投票.
onTurnEnd 保留其回收结果语义学并接受续作
裁决; 应用程序完成门应更可取 beforeCompletion。 。 。 .
validateJsonFileContent 从 /tools 或者说 /agent 验证完成 .json
在主机写之前写/编辑内容。 验证默认值 :
字节和报告可恢复的语法错误。 见 jSON 写的工作空间
用于主机选择退出和集成实例.
createManagedAgentTeam 从 /agent 支持牵头授权和选择共享板
协作。 见 多代理主机指南 工具,
从0.1.12开始的预算和移徙 离线示例
没有提供者证书的两种模式.
在0.1.5中添加的 Opt-in优化帮助包括 defineActionFusion 财务报告和审定财务报表
createModelEvidenceReducer 从 /tools,以及 createContextOptimizer 从
/memory应用选择管道步骤、里程碑摘要、日志存储、,
和减少模型。 见 应用程序指南
用于配置、精确证据倒置和可运行验证.
现有代理、工具和会话进口仍然可用。 评议
升级指南
用于描述默认、已排队的引导收件以及管理团队验证
发布0.1.4版后的变化. 还需要程序工具
届会 experimentalPrograms 赠款;普通工具没有.
关于0.1.7完成,待输入、流替换和停止行为,见
页:1 升级指南。 。 。 .
RuntimeAgentSession.hasUnansweredInput() 财务报告和审定财务报表 runPending() 曝光左边的工作
经过一个终端回合。 使用 response.completed 目标完成.
在0.1.8中,精确的重复后卫可以重用刚刚成功过的
工具结果并允许一个限定模式重新规划. EmbeddingError.failure 保留
可用的提供者 HTTP 状态,通过正常化重试延迟和请求 ID .
见 从0.1.7升级
对于排除,取消和预算行为.