后端人工智能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 是一个开源、自托管的 Agent Protocol 服务器可作为 LangSmith Deployments原 LangGraph Platform的免费替代品基于 FastAPI PostgreSQL让你的 AI Agent 完全跑在自己的基础设施上且 LangGraph 图代码、SDK 调用几乎零改动即可迁移。本文将带你用 5 步完成这次迁移并获得数据、成本与可观测性的完全控制权。为什么要迁移到 Aegra托管平台按运行次数、节点执行和席位收费成本随流量线性上涨而 Agent 状态、对话历史都存储在第三方服务器上。迁移到 Aegra 后维度LangSmith DeploymentsAegra 自托管部署免费版仅限本地付费版上云免费、无限自托管仅企业版需 License Key始终支持Apache 2.0 协议数据库平台托管自己的 PostgreSQL可查询/备份Tracing仅 LangSmith任意 OTLP 后端Langfuse、Phoenix 等认证控制台配置自己的 Python 代码JWT/OAuth/Firebase一台 $5/月的 VPS 就能同时跑服务、数据库和多个 Agent。完整对比见 docs/why-aegra.mdx功能支持矩阵见 docs/feature-support.mdx。迁移前后什么不变什么变完全不变的部分这是零代码改动的关键✅图代码LangGraph Agent 原样运行✅SDK 调用get_client()、client.threads、client.runs.stream()全部相同✅Agent Protocol 前端Agent Chat UI、LangGraph Studio、CopilotKit 直接兼容✅线程状态模型Threads、Checkpoints、状态检查行为一致✅流式输出与 Human-in-the-LoopSSE 模式、中断/恢复模式均相同需要调整的部分只有 4 处项目原来迁移后配置文件langgraph.jsonaegra.json也兼容回退读取langgraph.json客户端 URLhttps://your-deployment.langsmith.comhttp://localhost:2026或你的域名部署命令langgraph deployaegra up或docker compose up认证/Tracing控制台配置aegra.json 环境变量5步迁移实战 第1步安装 Aegra CLI一条命令安装官方命令行工具注意直接安装aegra-cli而非 PyPI 上的aegra元包后者不支持版本锁定pip install aegra-cli第2步拷贝你的 LangGraph 图代码把原有的 graphs 模块复制到新项目目录即可一行代码都不用改mkdir my-project cd my-project cp -r /path/to/your/graphs ./graphs第3步创建 aegra.json 配置文件用aegra.json替代langgraph.json其中graphs部分完全相同{ graphs: { agent: ./graphs/agent.py:graph } }小提示Aegra 支持回退读取langgraph.json所以你可以先原样保留之后再改名迁移更平滑。仓库自带了多示例项目的配置参考例如 aegra.json 中注册了 react_agent、HITL、子图等多种 Agent图实现可查看 examples/react_agent/graph.py。完整配置项auth、HTTP、CORS、store见 docs/reference/configuration.mdx。第4步配置环境变量与数据库创建.env文件写入 LLM 密钥和数据库信息# LLM 提供商密钥 OPENAI_API_KEYsk-... # 已有 PostgreSQL 时直接指定 DATABASE_URLpostgresql://user:passhost:5432/aegraAegra 使用带pgvector扩展的 PostgreSQL推荐pgvector/pgvector:pg18镜像来持久化 Agent 状态并支持向量搜索。使用aegra dev时数据库会通过 Docker 自动拉起无需手动配置。第5步启动服务器只改客户端 URLuv sync uv run aegra dev一条命令完成启动 Docker 中的 PostgreSQL → 执行数据库迁移 → 以热重载方式在http://localhost:2026启动服务。然后只需把应用代码里的客户端 URL 换掉from langgraph_sdk import get_client # 迁移前 # client get_client(urlhttps://your-deployment.langsmith.com) # 迁移后仅改 URL其余全部不变 client get_client(urlhttp://localhost:2026)线程创建、运行、流式输出、状态检查照常工作。启动后访问http://localhost:2026/health返回{status: healthy}即表示迁移完成交互 API 文档在/docs页面。进阶迁移认证与 Tracing 认证LangSmith 靠控制台配置Aegra 改用 Python 认证处理器。写好authenticate函数支持 JWT 校验等然后在aegra.json中加一行auth: {path: ./my_auth.py:auth}即可。示例可参考 examples/jwt_mock_auth_example.py认证实现位于 libs/aegra-api/src/aegra_api/core/auth_registry.py。Tracing原来自动上报 LangSmith现在通过环境变量发送 OTLP且可同时扇出到多个后端OTEL_TARGETSLANGFUSE,PHOENIX可观测性源码与配置说明见 libs/aegra-api/src/aegra_api/observability/ 目录与 docs/guides/observability.mdx。迁移注意事项 ⚠️环境要求Python 3.12本地开发需 Docker用于拉起 PostgreSQL生产推荐 Docker 或 Linux 服务器暂未支持的功能RemoteGraph尚无计划使用前可查 docs/feature-support.mdx 确认完整矩阵验证清单/health健康检查 → 跑通一次runs.stream→ 检查/docs中各 Agent 端点生产部署开发用aegra dev生产用aegra up或docker compose up部署指南见 docs/guides/deployment.mdx总结从 LangSmith Deployments 迁移到 Aegra 本质上只是换一个配置文件名、一条数据库、一个 URL图代码、SDK、前端全部保留。5 步走完后你就拥有了免费的无限部署、自己掌控的数据库、可自由选择的 Tracing 后端和代码级认证——这就是自托管 AI Agent 后端的完整价值。赞分享后端人工智能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点击查看免费下载相关推荐Coolify迁移指南从Heroku到自托管的完整教程Coolify迁移指南从Heroku到自托管的完整教程 想要从Heroku迁移到自托管平台吗Coolify作为一款强大的开源部署工具能帮助你轻松完成这一过后端云原生容器编排运维DevOpsPathway 从 Kafka 迁移到 Redpanda零代码改动的流处理实战指南Pathway 从 Kafka 迁移到 Redpanda零代码改动的流处理实战指南 本篇基于 PathwayPython ETL / 实时流处理框架官方教后端流处理实时分析数据工程人工智能RAGGel Cloud 迁移到自托管 Gel 实例完整割接Cutover指南Gel Cloud 迁移到自托管 Gel 实例完整割接Cutover指南 导读 Gel Cloud 将于 2026 年 1 月底停止服务 所有托管在 G数据库图数据库关系型数据库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考