功能介绍
在AgentRun运行时中创建的Agent,支持被其他系统调用,将已开发好的 Agent 快速集成到前端网页、后端服务等业务系统中
前提条件
操作步骤
进入集成与发布页面
进入AgentRun运行时页面;
在需要被集成的Agent卡片中,点击详情;
在Agent详情页,选择左侧目录的集成与发布,进入集成与发布页面。
此时可以在页面中看到三种集成方式,按需选择被集成方式,分别为:
UI集成:
支持一键生成前后端一体的 Agent 应用界面;
可以将该界面以 iframe、独立域名等形式嵌入到现有网页或其他应用中;
适合快速提供“可视化对话界面”的场景(如内部工作台、门户网站等)。
代码集成:
提供标准的 HTTP API 接口(如兼容 OpenAI Chat Completions 协议);
外部系统可以按标准协议API/SDK直接调用 Agent 的接口,适合多语言、多平台集成。
生态集成:
支持在Dify、n8n等平台集成Agent。
配置UI集成
选择集成模板:通过集成模板,来指定UI集成方式与风格模板,选择完成后,可以点击预览效果,查看当前配置的最终效果;
集成方式:全屏嵌入、浮窗聊天、侧边栏;
风格模板:简约风格、商务风格、科技风格、温馨风格。
开始集成:点击开始集成后,需要指定集成的Agent对应版本的EndPoint,进行API绑定配置,配置完成后,单击下一步;
等待部署完成:查看部署日志,等待部署完成;
测试部署结果:部署成功后,会在页面中显示已部署的集成资源,并生成一个临时的访问地址,可以点击访问地址,进行Agent访问和使用;
重要当前访问地址是 CNCF SandBox 项目 Serverless Devs 社区所提供,仅供学习和测试使用,不可用于任何生产使用;社区会对该域名进行不定期地拨测,并在域名下发 1 天后进行回收,强烈建议您绑定自定义域名以获得更好的使用体验。
绑定自定义域名:点击访问地址右侧的增加,可以选择已有域名或新增域名进行正式域名的绑定,自定义域名配置可以参考配置自定义域名。
代码集成
按标准协议API/SDK直接调用 Agent 的接口,适合多语言、多平台集成,代码示例如下:
curl https://12**********.agentrun-data.cn-hangzhou.aliyuncs.com/agent-runtimes/agent-code-XVe7d/endpoints/Default/invocations/openai/v1/chat/completions -XPOST \
-H "content-type: application/json" \
-d '{
"messages": [{"role": "user", "content": "写一段代码,查询现在是几点?"}],
"stream":true
}'