后端人工智能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），仅供参考