ambleloft把你的应用接给 Agent
保留已有的业务系统，用插件提供用户和 Agent 都能理解的操作入口。
实践指南
完成后：明确业务动作、认证与可核对的提交结果。
前置条件：按本页具体步骤准备所需文件与工具；学习路线中的上一页不自动构成依赖。
本页内容
01从一个明确的业务动作开始
例如查询申请记录，或确认后提交申请。插件操作声明输入输出、调用方、权限与读写效果；Node handler 负责调用你的 API。案例中的项目读取演示了页面与 Agent 共用一个操作的方式。
代码示例
import { defineExtension } from '@ambleloft/extension-sdk';
export const { activate } = defineExtension({
activate(context) {
context.subscriptions.push(
context.operations.register('describeProject',
async (input, invocation) => {
const project = await invocation.resources
.getProject(input.projectId as string);
return { ...project };
}
)
);
}
});02选择用户的操作界面
字段和线性步骤适合声明式表单；定制布局适合聊天内 HTML 页面。独立插件首页可以承接服务状态、记录查询和设置。不要让界面绕过宿主的授权与写入确认。
03连接企业账号与资源
enterprise-auth 演示宿主管理的账号会话与声明式 HTTPS 资源访问。开发者需替换 baseUrl、audience、scopes，并在宿主账号设置配置 issuer/clientId。身份服务需支持 PKCE S256、resource 和 loopback 回调。占位域名不是可直接使用的企业连接器。
查看完整案例与运行说明04让提交结果可以核对
服务端负责持久化、幂等和按原执行记录查询结果。提交后响应丢失时先查询原业务结果，不把再次写入当作重试查询。参考报销案例的结果恢复流程。
查看完整案例与运行说明检查结果与排错
明确业务动作、认证与可核对的提交结果。
按本页的验证步骤核对实际结果。涉及业务服务时，分别检查界面提交、工具回执与服务端记录。
打开错误代码与排错 →