Agent集成与发布

功能介绍

AgentRun运行时中创建的Agent,支持被其他系统调用,将已开发好的 Agent 快速集成到前端网页、后端服务等业务系统中

前提条件

  • 已创建可用的 Agent (快速创建Agent/代码创建Agent)并完成发布;

  • Agent配置了管理Serverless开发平台(Devs)的权限(AliyunDevsFullAccess)。

操作步骤

进入集成与发布页面

  1. 进入AgentRun运行时页面;

  2. 在需要被集成的Agent卡片中,点击详情

  3. Agent详情页,选择左侧目录的集成与发布,进入集成与发布页面。

此时可以在页面中看到三种集成方式,按需选择被集成方式,分别为:

UI集成

  • 支持一键生成前后端一体的 Agent 应用界面;

  • 可以将该界面以 iframe、独立域名等形式嵌入到现有网页或其他应用中;

  • 适合快速提供“可视化对话界面”的场景(如内部工作台、门户网站等)。

代码集成

  • 提供标准的 HTTP API 接口(如兼容 OpenAI Chat Completions 协议);

  • 外部系统可以按标准协议API/SDK直接调用 Agent 的接口,适合多语言、多平台集成。

生态集成

支持在Dify、n8n等平台集成Agent。

配置UI集成

  1. 选择集成模板:通过集成模板,来指定UI集成方式风格模板,选择完成后,可以点击预览效果,查看当前配置的最终效果;

    • 集成方式全屏嵌入浮窗聊天侧边栏

    • 风格模板简约风格商务风格科技风格温馨风格

  2. 开始集成:点击开始集成后,需要指定集成的Agent对应版本的EndPoint,进行API绑定配置,配置完成后,单击下一步

  3. 等待部署完成:查看部署日志,等待部署完成;

  4. 测试部署结果:部署成功后,会在页面中显示已部署的集成资源,并生成一个临时的访问地址,可以点击访问地址,进行Agent访问和使用;

    重要

    当前访问地址是 CNCF SandBox 项目 Serverless Devs 社区所提供,仅供学习和测试使用,不可用于任何生产使用;社区会对该域名进行不定期地拨测,并在域名下发 1 天后进行回收,强烈建议您绑定自定义域名以获得更好的使用体验。

  5. 绑定自定义域名:点击访问地址右侧的增加,可以选择已有域名或新增域名进行正式域名的绑定,自定义域名配置可以参考配置自定义域名

代码集成

按标准协议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
 }'