Aegra自定义路由指南:为你的AI Agent服务器快速添加FastAPI端点

发布时间:2026/10/13 22:30:20

Aegra自定义路由指南:为你的AI Agent服务器快速添加FastAPI端点 后端人工智能AI Agent【免费下载链接】aegraOpen source alternative to LangGraph Platform (now LangSmith Deployments) - Self-hosted AI agent backend with FastAPI and PostgreSQL. Zero vendor lock-in, full control over your agent infrastructure.项目地址https://gitcode.com/gh_mirrors/ae/aegra点击查看免费下载Aegra 是一个自托管的 AI Agent 后端平台LangGraph Platform 的开源替代方案基于 FastAPI 和 PostgreSQL 构建。除了内置的 Agent Protocol 接口外Aegra 还支持自定义路由你可以挂载一个自己的 FastAPI 应用与核心 API 并行运行轻松为服务器添加 Webhook、管理面板、健康看板等任意 HTTP 端点。本指南将带你用最少的步骤完成配置。为什么需要自定义路由默认情况下Aegra 提供/assistants、/threads、/runs、/store等核心接口来管理你的 Agent。但实际业务中你往往还需要Webhook 接收端点接收第三方平台的回调通知️管理后台接口暴露内部工具或统计信息额外业务接口让前端直接调用而不必再搭一套服务借助自定义路由这些端点可以和 Agent 服务器跑在同一个进程、同一个端口里省去额外的网关和反向代理。一键添加端点三步配置整个过程只需三步官方文档见 custom-routes.mdx第一步创建你的 FastAPI 应用新建一个custom_routes.py创建一个app实例并定义端点from fastapi import FastAPI app FastAPI() app.get(/custom/hello) async def hello(): return {message: Hello from custom route!}第二步在 aegra.json 中注册在配置文件里加入http.app字段指向你的应用格式为./文件路径:变量名{ http: { app: ./custom_routes.py:app } }仓库自带的 aegra.json 就是实际用法app: ./examples/custom_routes_example.py:app。第三步启动服务器aegra dev启动后访问http://localhost:2024/custom/hello就能看到你的端点生效了——它与 Agent Protocol API 并行可用。路由优先级哪些路径能覆盖Aegra 通过 route_merger.py 把自定义应用与核心路由合并路由按以下优先级处理优先级路由说明1/health、/ready、/live、/docs、/openapi.json始终可访问不可覆盖2你的自定义路由优先于可覆盖路由3/、/info可被自定义路由覆盖4/assistants、/threads、/runs、/store核心接口不可覆盖也就是说你可以自定义根路径/来返回自己的欢迎页但核心的 Agent Protocol 接口和健康检查永远安全、不受影响。自定义路由的认证配置默认情况下自定义路由不带Aegra 的认证。你可以根据需要选择两种保护方式方式一全局开启认证在aegra.json中设置enable_custom_route_auth{ http: { app: ./custom_routes.py:app, enable_custom_route_auth: true } }开启后你的应用中所有 FastAPI 路由都会要求有效凭证否则返回401。该配置项定义在 config.py。方式二按路由精细控制只对特定端点使用require_auth依赖其余端点保持公开from fastapi import Depends from aegra_api.core.auth_deps import require_auth from aegra_api.models.auth import User app.get(/custom/whoami) async def whoami(user: User Depends(require_auth)): return {identity: user.identity, display_name: user.display_name}仓库中的 custom_routes_example.py 完整演示了公开端点、受保护端点和用户信息获取的写法建议直接参考。CORS 跨域配置如果前端部署在不同域名下可以在http.cors中配置跨域规则{ http: { app: ./custom_routes_example.py:app, cors: { allow_origins: [https://myapp.com], allow_credentials: true } } }未配置时默认allow_origins: [*]任意来源、不带凭证指定了具体来源后allow_credentials默认自动为true也可用allow_origin_regex以正则批量匹配来源常见问题速查Q自定义路由会影响核心接口吗不会。核心接口和健康检查受保护无法被覆盖两者互不干扰。Q可以挂载多个路由文件吗推荐在一个 FastAPI 应用内用include_router组织多个模块比拆分多个文件更易管理。Q配置项有哪些http.app自定义应用的导入路径http.enable_custom_route_auth是否为所有自定义路由启用认证http.cors.allow_origins/allow_origin_regex/allow_credentials跨域策略总结通过http.app一个配置项Aegra 就能让你的业务端点与 AI Agent 服务器同端口运行路由优先级保证核心接口安全enable_custom_route_auth或require_auth提供灵活的认证粒度CORS 配置则让前后端分离部署开箱即用。更多细节可查阅官方文档 docs/guides/custom-routes.mdx。赞分享后端人工智能AI Agent【免费下载链接】aegraOpen source alternative to LangGraph Platform (now LangSmith Deployments) - Self-hosted AI agent backend with FastAPI and PostgreSQL. Zero vendor lock-in, full control over your agent infrastructure.项目地址https://gitcode.com/gh_mirrors/ae/aegra点击查看免费下载相关推荐NoneBot2 驱动器路由指南为机器人添加自定义 HTTP 与 WebSocket 服务端接口NoneBot2 驱动器路由指南为机器人添加自定义 HTTP 与 WebSocket 服务端接口 NoneBot2 的服务端型驱动器本质上是基于 ASGI 的后端即时通讯开源射频设计工具的未来RF-Tools-KiCAD路线图与社区发展开源射频设计工具的未来RF Tools KiCAD路线图与社区发展 RF Tools KiCAD是一款专为KiCAD打造的开源射频设计工具集集成了足迹向导、Webiny 自定义 HTTP 路由完整指南用 Api.Route 与 HttpRouteHandler 在 GraphQL API 旁添加 REST 端点Webiny 自定义 HTTP 路由完整指南用 Api.Route 与 HttpRouteHandler 在 GraphQL API 旁添加 REST 端点CMS后端前端云原生AI 应用创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/10/13 22:30:20

鸿蒙+Unity+Sentry崩溃符号化:从so偏移到C#行号的完整链路

1. 这不是“加个SDK”就能搞定的事:鸿蒙UnitySentry的三重交界区“团结引擎接 Sentry:鸿蒙打包通过,崩溃符号化到 C# 行号”——这个标题乍看像一句技术通告,但实际是踩过至少七轮真机构建、四次符号表解析失败、两次NDK版本回滚后…

2026/10/13 22:30:20

用Python从零构建文字冒险游戏:基于状态机的互动小说开发实践

文字冒险游戏,又叫互动小说,是一种只靠文字和选择驱动一切的游戏形态。用Python来做这类游戏,是我接触编程之后觉得投入产出比最高的练手项目之一。有人觉得它“太简单”,其实文字冒险游戏几乎涵盖了一款完整游戏的核心骨架&#…

2026/10/13 22:25:19

RPA CoE与GPT结合:企业自动化架构设计与落地实操

1. 当RPA CoE遇上GPT:一场企业自动化的化学反应第一次听到"RPA CoE x GPT"这个组合的时候,我正蹲在一个流程自动化的项目里焦头烂额。业务方丢过来三十多个流程需求,每个都喊着"急",而团队里能写RPA脚本的就那…

2026/10/13 23:30:30

Kimi K3 百万上下文超长代码重构与跨文件符号依赖解析深度实测

在长文本大模型的能力象限中,代码重构和跨文件符号解析一向被视为试金石。普通的文本总结允许模型存在一定程度的模糊概括,但在一个包含数十万行代码、数百个互相引用的工程中,一个方法签名的类型推导错误,或者一条遗漏的接口实现…

2026/10/13 23:30:30

汇编指令实战手册:从PDF到可调试的活代码

简介:《汇编语言指令大全(详解版)》是一份面向计算机专业学生、嵌入式开发者及底层技术爱好者的核心参考资料,系统梳理x86架构下常用汇编指令的语法、功能、操作数类型与典型应用场景,助力读者深入理解CPU执行机制、提升逆向分析与性能优化能…

2026/10/13 23:30:30

数字滤波器结构详解:从直接型到级联型的工程选型指南

做信号处理的同学基本都躲不过这个坎:数字滤波器的基本结构。教材第5章放了一堆信号流图,直接I型、直接II型、转置、级联、并联,乍一看像是同一个传递函数换了几种画法,纯粹在玩纸面游戏。我以前也这么觉得,直到后来在…

2026/10/13 23:30:30

PS5又被完全破解了?从固件漏洞、信任链拆解主机破解传言

PS5又被完全破解了?每隔一两个月,总能在群里、短视频平台刷到类似的消息——“PS5又被完全破解了!”配上醒目的红字标题,评论区里一半人问教程,一半人说假的,吵得不可开庭。作为一个从PS3时代就开始折腾主机…

2026/10/13 23:30:30

Uni ECharts:基于ECharts的uni-app跨端图表组件封装实践

1. 项目背景:跨端图表这条路,ECharts 原方案根本走不通去年年底接了一个数据看板类的跨端项目,需求很直白:同一个图表页面,要同时跑在微信小程序、iOS App 和 H5 上。前端团队当时的第一反应是“直接用 ECharts 不就行…

2026/10/13 23:25:30

k-means-LSTM组合预测:多输入多输出时间序列建模与GUI实现

简介:这份资源面向具备一定机器学习与Python基础的研发人员、数据科学家及时间序列预测学习者,围绕k均值聚类与长短期记忆神经网络相结合的多输入多输出组合预测方法展开。其核心思路是先用k-means对数据做预处理与特征提取,再对每个子集分别…

2026/10/13 5:19:27

Python调用Gemini Structured Outputs实现工单路由门禁

客服工单最怕的不是模型“答错一句话”,而是它给出一段看起来合理的说明,程序却从中猜错优先级。通俗做法是:要求模型只交 JSON(JavaScript Object Notation,轻量数据格式),再让代码验证它。Gem…

2026/10/13 17:09:18

Spring Boot超市进销存系统毕设实战:从需求拆解到答辩通关

最近带的一个学生项目组里,有A同学跑来问我:选什么毕设题目最稳妥,既能让评审老师觉得工作量够,又不会在答辩时被问到语无伦次。我第一反应就是推荐基于Spring Boot的超市仓库管理系统——也就是超市进销存系统。这个题目乍一看平…

2026/10/12 12:54:07

Flutter StatefulWidget 生命周期核心解析

很多刚开始接触 Flutter 的朋友,在看完一堆“Hello World”和基础组件之后,大概率都会撞上同一堵墙:StatefulWidget 里那堆 initState、build、dispose 方法,到底什么时候被调用?为什么顺序是那样?在里面到…

2026/10/13 0:04:41

基于Triton部署YOLO目标检测:从训练脚本到线上服务

简介:这份资源面向希望将目标检测模型落地到生产环境的深度学习开发者与算法工程师,聚焦于用 Triton Inference Server 部署 YOLOv9 的完整实战方案,解决从训练权重到线上推理服务之间的工程化难题。压缩包共 16 个文件,约 886KB&…

2026/10/13 0:04:41

手把手教你云端部署Qwen-Image-2.1:从GPU选型到在线文生图服务

Qwen-Image-2.1 这个开源的图像生成模型,最近在内容创作和 AI 应用圈子里热度相当高。它属于通义 Qwen 系列里的视觉生成分支,让我眼前一亮的是它对中文长文本的理解能力——以前用那些老方案生成带中文文字的图,十个里九个是“乱码印刷体”&…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑