[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-arklexai--Agent-First-Organization":3,"tool-arklexai--Agent-First-Organization":64},[4,17,27,35,43,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",140436,2,"2026-04-05T23:32:43",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,26],{"id":44,"name":45,"github_repo":46,"description_zh":47,"stars":48,"difficulty_score":23,"last_commit_at":49,"category_tags":50,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,51,52,53,15,54,26,13,55],"数据工具","视频","插件","其他","音频",{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,54],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":79,"owner_email":79,"owner_twitter":79,"owner_website":79,"owner_url":80,"languages":81,"stars":90,"forks":91,"last_commit_at":92,"license":93,"difficulty_score":23,"env_os":94,"env_gpu":94,"env_ram":94,"env_deps":95,"category_tags":105,"github_topics":79,"view_count":23,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":106,"updated_at":107,"faqs":108,"releases":134},3153,"arklexai\u002FAgent-First-Organization","Agent-First-Organization","The official Python library for Arklex framework","Agent-First-Organization 是 Arklex 框架的官方 Python 库，旨在帮助开发者快速构建、部署和扩展具备企业级可靠性的智能 AI 代理系统。它主要解决了传统 AI 应用开发周期长、多代理协作复杂以及难以在生产环境中稳定运行等痛点，让团队能在数天内而非数月内完成高质量代理的开发。\n\n该工具特别适合需要构建复杂自动化流程的软件开发者和技术团队，尤其是那些希望整合检索增强生成（RAG）、数据库操作及外部 API 调用的场景。其核心亮点在于“代理优先”的架构设计，通过声明式的任务图谱（Task Graph）和强大的编排引擎，轻松管理多代理之间的协作与状态。此外，它支持 OpenAI、Anthropic、Gemini 等多种大模型，内置了全面的评估测试套件，并提供了生产级的监控、日志记录及自动扩缩容能力，确保系统在高负载下依然安全稳定。无论是搭建电商客服机器人还是处理复杂的企业工作流，Agent-First-Organization 都能提供灵活且高效的解决方案。","# 🧠 Arklex AI · Agent-First Framework\n\n\u003Cdiv align=\"center\">\n\n![Arklex AI Logo](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Farklexai_Agent-First-Organization_readme_cb3c44233f64.jpeg)\n\n**Build, deploy, and scale intelligent AI agents with enterprise-grade reliability**\n\n[![Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Frelease\u002Farklexai\u002FAgent-First-Organization?logo=github)](https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization\u002Freleases)\n[![PyPI](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Farklex.svg)](https:\u002F\u002Fpypi.org\u002Fproject\u002Farklex)\n[![Python](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fpyversions\u002Farklex)](https:\u002F\u002Fpypi.org\u002Fproject\u002Farklex)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue.svg)](LICENSE.md)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdiscord-join%20community-7289da?logo=discord)](https:\u002F\u002Fdiscord.gg\u002FkJkefzkRg5)\n![Coverage](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcoverage-48.2%25-green)\n\n🚀 [Quick Start](#-get-started-in-5-minutes) • 📚 [Documentation](https:\u002F\u002Farklexai.github.io\u002FAgent-First-Organization\u002F) • 💡 [Examples](.\u002Fexamples\u002F)\n\n\u003C\u002Fdiv>\n\n---\n\n## 🚀 Get Started in 5 Minutes\n\n### Install & Setup\n\n```bash\n# Install\npip install arklex\n\n# Create .env file\necho \"OPENAI_API_KEY=your_key_here\" > .env\n\n# Clone the repository (required if you want to run example\u002Ftest scripts)\ngit clone https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization.git\ncd Agent-First-Organization\npip install -e .\n\n# Test your API keys (recommended)\npython test_api_keys.py\n\n# Create your first agent\n# The current `main` branch does not include a top-level `create.py` script, even though some older instructions may still reference it.\n# If you are getting started, use one of the prebuilt examples under `examples\u002F` and run the agent with `run.py`.\n\npython create.py \\\n  --config .\u002Fexamples\u002Fcustomer_service\u002Fcustomer_service_config.json \\\n  --output-dir .\u002Fexamples\u002Fcustomer_service \\\n  --llm_provider openai \\\n  --model gpt-4o\n\n# Run agent\npython run.py \\\n  --input-dir .\u002Fexamples\u002Fcustomer_service \\\n  --llm_provider openai \\\n  --model gpt-4o\n\n# For evaluation and testing, you can also use the model API server:\n# 1. Start the model API server (defaults to OpenAI with \"gpt-4o-mini\" model):\npython model_api.py --input-dir .\u002Fexamples\u002Fcustomer_service\n\n# 2. Run evaluation (in a separate terminal):\npython eval.py --model_api http:\u002F\u002F127.0.0.1:8000\u002Feval\u002Fchat \\\n  --config \"examples\u002Fcustomer_service\u002Fcustomer_service_config.json\" \\\n  --documents_dir \"examples\u002Fcustomer_service\" \\\n  --model \"claude-3-haiku-20240307\" \\\n  --llm_provider \"anthropic\" \\\n  --task \"all\"\n```\n\n---\n## 📺 Learn by Example\n\n### ▶️ Build a Customer Service Agent in 20 Minutes\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fyoutu.be\u002Fy1P2Ethvy0I\" target=\"_blank\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Farklexai_Agent-First-Organization_readme_333b355d46fb.png\" alt=\"Watch the video\" width=\"600px\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n👉 **Explore the full tutorial:** [Customer Service Agent Walkthrough](https:\u002F\u002Farklexai.github.io\u002FAgent-First-Organization\u002Fdocs\u002Ftutorials\u002Fcustomer-service)\n\n\n---\n\n## ⚡ Key Features\n\n- **🚀 90% Faster Development** — Deploy agents in days, not months\n- **🧠 Agent-First Design** — Purpose-built for multi-agent orchestration\n- **🔌 Model Agnostic** — OpenAI, Anthropic, Gemini, and more\n- **📊 Built-in Evaluation** — Comprehensive testing suite\n- **🛡️ Enterprise Security** — Authentication and rate limiting\n- **⚡ Production Ready** — Monitoring, logging, auto-scaling\n\n---\n\n## 🏗️ Architecture\n\n```mermaid\ngraph TB\n    A[Task Graph] --> B[Orchestrator]\n    B --> C[Workers]\n    B --> D[Tools]\n    C --> E[RAG Worker]\n    C --> F[Database Worker]\n    C --> G[Custom Workers]\n    D --> I[API Tools]\n    D --> J[External Tools]\n```\n\n**Core Components:**\n\n- **Task Graph** — Declarative DAG workflows\n- **Orchestrator** — Runtime engine with state management\n- **Workers** — RAG, database, web automation\n- **Tools** — Shopify, HubSpot, Google Calendar integrations\n\n---\n\n## 💡 Use Cases\n\n| **Domain** | **Capabilities** |\n|------------|------------------|\n| **Customer service for e-commerce** | RAG chatbots, ticket routing, support workflows |\n| **E-commerce such as shopify sales and customer** | Order management, inventory tracking, recommendations |\n| **Business Process** | Scheduling, CRM operations, document processing |\n\n---\n\n## 📚 Examples\n\n| **Example** | **Description** | **Complexity** |\n|-------------|-----------------|----------------|\n| [Customer Service](.\u002Fexamples\u002Fcustomer_service\u002F) | RAG-powered support | ⭐⭐ |\n| [Shopify Integration](.\u002Fexamples\u002Fshopify\u002F) | E-commerce management | ⭐⭐⭐ |\n| [HubSpot CRM](.\u002Fexamples\u002Fhubspot\u002F) | Contact management | ⭐⭐⭐ |\n| [Calendar Booking](.\u002Fexamples\u002Fcalendar\u002F) | Scheduling system | ⭐⭐ |\n| [Human-in-the-Loop](.\u002Fexamples\u002Fhitl_server\u002F) | Interactive workflows | ⭐⭐⭐⭐ |\n\n---\n\n## 🔧 Configuration\n\n**Requirements:** Python 3.10+, API keys\n\n```env\n# Required: Choose one or more LLM providers\nOPENAI_API_KEY=your_key_here\n# OR ANTHROPIC_API_KEY=your_key_here\n# OR GOOGLE_API_KEY=your_key_here\n\n# Optional: Enhanced features\nMILVUS_URI=your_milvus_uri\nMYSQL_USERNAME=your_username\nTAVILY_API_KEY=your_tavily_key\n```\n\n**Testing API Keys:**\nAfter adding your API keys to the `.env` file, run the test script to verify they work correctly:\n\n```bash\n# Test all configured API keys\npython test_api_keys.py\n\n# Test specific providers only\npython test_api_keys.py --providers openai gemini\npython test_api_keys.py --providers openai anthropic\n```\n\n---\n\n## 📖 Documentation\n\n- 📚 **[Full Documentation](https:\u002F\u002Farklexai.github.io\u002FAgent-First-Organization\u002F)**\n- 🚀 **[Quick Start](docs\u002FQUICKSTART.md)**\n- 🛠️ **[API Reference](docs\u002FAPI.md)**\n- 🏗️ **[Architecture](docs\u002FARCHITECTURE.md)**\n- 🚀 **[Deployment](docs\u002FDEPLOYMENT.md)**\n\n---\n\n## 🤝 Community\n\n- 🐛 [Report Issues](https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization\u002Fissues)\n- 💬 [Discord](https:\u002F\u002Fdiscord.gg\u002FkJkefzkRg5)\n- 🐦 [Twitter](https:\u002F\u002Ftwitter.com\u002Farklexai)\n- 💼 [LinkedIn](https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Farklex)\n- 📧 [Email Support](mailto:support@arklex.ai)\n\n---\n\n## 📄 License\n\nArklex AI is released under the **MIT License**. See [LICENSE](LICENSE.md) for details.\n\nThis means you can:\n\n- ✅ Use Arklex AI for commercial projects\n- ✅ Modify and distribute the code\n- ✅ Use it in proprietary applications\n- ✅ Sell applications built with Arklex AI\n\nThe only requirement is that you include the original license and copyright notice.\n\n---\n\n## 🙏 Acknowledgments\n\nThanks to all our contributors and the open-source community for making this project possible!\n\n### 🌟 Contributors\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Farklexai_Agent-First-Organization_readme_569dc83d1034.png\" \u002F>\n\u003C\u002Fa>\n\n### 🤝 Open Source Dependencies\n\nArklex AI builds on the shoulders of giants:\n\n- **LangChain** — LLM framework and tooling\n- **FastAPI** — Modern web framework\n- **Pydantic** — Data validation\n- **SQLAlchemy** — Database ORM\n- **Milvus** — Vector database\n- **And many more...**\n\n---\n\n\u003Cdiv align=\"center\">\n\n**Made with ❤️ by the Arklex AI Team**\n\n[Website](https:\u002F\u002Farklex.ai) • [Documentation](https:\u002F\u002Farklexai.github.io\u002FAgent-First-Organization\u002F) • [GitHub](https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization) • [Discord](https:\u002F\u002Fdiscord.gg\u002FkJkefzkRg5) • [LinkedIn](https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Farklex)\n\n\u003C\u002Fdiv>\n","# 🧠 Arklex AI · 代理优先框架\n\n\u003Cdiv align=\"center\">\n\n![Arklex AI Logo](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Farklexai_Agent-First-Organization_readme_cb3c44233f64.jpeg)\n\n**以企业级可靠性构建、部署和扩展智能AI代理**\n\n[![发布](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Frelease\u002Farklexai\u002FAgent-First-Organization?logo=github)](https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization\u002Freleases)\n[![PyPI](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Farklex.svg)](https:\u002F\u002Fpypi.org\u002Fproject\u002Farklex)\n[![Python](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fpyversions\u002Farklex)](https:\u002F\u002Fpypi.org\u002Fproject\u002Farklex)\n[![许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue.svg)](LICENSE.md)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdiscord-join%20community-7289da?logo=discord)](https:\u002F\u002Fdiscord.gg\u002FkJkefzkRg5)\n![覆盖率](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcoverage-48.2%25-green)\n\n🚀 [快速入门](#-get-started-in-5-minutes) • 📚 [文档](https:\u002F\u002Farklexai.github.io\u002FAgent-First-Organization\u002F) • 💡 [示例](.\u002Fexamples\u002F)\n\n\u003C\u002Fdiv>\n\n---\n\n## 🚀 5分钟快速入门\n\n### 安装与设置\n\n```bash\n# 安装\npip install arklex\n\n# 创建 .env 文件\necho \"OPENAI_API_KEY=your_key_here\" > .env\n\n# 克隆仓库（如果你想运行示例\u002F测试脚本则需要）\ngit clone https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization.git\ncd Agent-First-Organization\npip install -e .\n\n# 测试你的API密钥（推荐）\npython test_api_keys.py\n\n# 创建你的第一个代理\n# 当前的 `main` 分支并不包含顶层的 `create.py` 脚本，尽管一些旧的说明可能仍然会提到它。\n# 如果你是初学者，请使用 `examples\u002F` 下的预建示例，并用 `run.py` 来运行代理。\n\npython create.py \\\n  --config .\u002Fexamples\u002Fcustomer_service\u002Fcustomer_service_config.json \\\n  --output-dir .\u002Fexamples\u002Fcustomer_service \\\n  --llm_provider openai \\\n  --model gpt-4o\n\n# 运行代理\npython run.py \\\n  --input-dir .\u002Fexamples\u002Fcustomer_service \\\n  --llm_provider openai \\\n  --model gpt-4o\n\n# 对于评估和测试，你也可以使用模型API服务器：\n# 1. 启动模型API服务器（默认为OpenAI，使用“gpt-4o-mini”模型）：\npython model_api.py --input-dir .\u002Fexamples\u002Fcustomer_service\n\n# 2. 在另一个终端中运行评估：\npython eval.py --model_api http:\u002F\u002F127.0.0.1:8000\u002Feval\u002Fchat \\\n  --config \"examples\u002Fcustomer_service\u002Fcustomer_service_config.json\" \\\n  --documents_dir \"examples\u002Fcustomer_service\" \\\n  --model \"claude-3-haiku-20240307\" \\\n  --llm_provider \"anthropic\" \\\n  --task \"all\"\n```\n\n---\n## 📺 通过示例学习\n\n### ▶️ 20分钟内构建一个客服代理\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fyoutu.be\u002Fy1P2Ethvy0I\" target=\"_blank\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Farklexai_Agent-First-Organization_readme_333b355d46fb.png\" alt=\"观看视频\" width=\"600px\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n👉 **探索完整教程：** [客服代理教程](https:\u002F\u002Farklexai.github.io\u002FAgent-First-Organization\u002Fdocs\u002Ftutorials\u002Fcustomer-service)\n\n\n---\n\n## ⚡ 核心特性\n\n- **🚀 开发速度提升90%** —— 数天内即可部署代理，而非数月\n- **🧠 代理优先设计** —— 专为多代理编排而打造\n- **🔌 模型无关** —— OpenAI、Anthropic、Gemini等\n- **📊 内置评估** —— 全面的测试套件\n- **🛡️ 企业级安全** —— 认证与速率限制\n- **⚡ 生产就绪** —— 监控、日志记录、自动扩展\n\n---\n\n## 🏗️ 架构\n\n```mermaid\ngraph TB\n    A[任务图] --> B[编排器]\n    B --> C[工作者]\n    B --> D[工具]\n    C --> E[RAG 工作者]\n    C --> F[数据库工作者]\n    C --> G[自定义工作者]\n    D --> I[API 工具]\n    D --> J[外部工具]\n```\n\n**核心组件：**\n\n- **任务图** —— 声明式DAG工作流\n- **编排器** —— 带状态管理的运行时引擎\n- **工作者** —— RAG、数据库、网页自动化\n- **工具** —— Shopify、HubSpot、Google Calendar集成\n\n---\n\n## 💡 使用场景\n\n| **领域** | **能力** |\n|------------|------------------|\n| **电商客服** | RAG聊天机器人、工单路由、支持工作流 |\n| **Shopify等电商平台销售与客户管理** | 订单管理、库存跟踪、推荐系统 |\n| **业务流程** | 日程安排、CRM操作、文档处理 |\n\n---\n\n## 📚 示例\n\n| **示例** | **描述** | **复杂度** |\n|-------------|-----------------|----------------|\n| [客服](.\u002Fexamples\u002Fcustomer_service\u002F) | RAG驱动的支持 | ⭐⭐ |\n| [Shopify集成](.\u002Fexamples\u002Fshopify\u002F) | 电商管理 | ⭐⭐⭐ |\n| [HubSpot CRM](.\u002Fexamples\u002Fhubspot\u002F) | 联系人管理 | ⭐⭐⭐ |\n| [日历预约](.\u002Fexamples\u002Fcalendar\u002F) | 日程安排系统 | ⭐⭐ |\n| [人工介入](.\u002Fexamples\u002Fhitl_server\u002F) | 交互式工作流 | ⭐⭐⭐⭐ |\n\n---\n\n## 🔧 配置\n\n**要求：** Python 3.10+，API密钥\n\n```env\n# 必需：选择一个或多个LLM提供商\nOPENAI_API_KEY=your_key_here\n# 或 ANTHROPIC_API_KEY=your_key_here\n# 或 GOOGLE_API_KEY=your_key_here\n\n# 可选：增强功能\nMILVUS_URI=your_milvus_uri\nMYSQL_USERNAME=your_username\nTAVILY_API_KEY=your_tavily_key\n```\n\n**测试API密钥：**\n将你的API密钥添加到`.env`文件后，运行测试脚本以验证它们是否正常工作：\n\n```bash\n# 测试所有配置的API密钥\npython test_api_keys.py\n\n# 仅测试特定提供商\npython test_api_keys.py --providers openai gemini\npython test_api_keys.py --providers openai anthropic\n```\n\n---\n\n## 📖 文档\n\n- 📚 **[完整文档](https:\u002F\u002Farklexai.github.io\u002FAgent-First-Organization\u002F)**\n- 🚀 **[快速入门](docs\u002FQUICKSTART.md)**\n- 🛠️ **[API参考](docs\u002FAPI.md)**\n- 🏗️ **[架构](docs\u002FARCHITECTURE.md)**\n- 🚀 **[部署](docs\u002FDEPLOYMENT.md)**\n\n---\n\n## 🤝 社区\n\n- 🐛 [报告问题](https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization\u002Fissues)\n- 💬 [Discord](https:\u002F\u002Fdiscord.gg\u002FkJkefzkRg5)\n- 🐦 [Twitter](https:\u002F\u002Ftwitter.com\u002Farklexai)\n- 💼 [LinkedIn](https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Farklex)\n- 📧 [邮件支持](mailto:support@arklex.ai)\n\n---\n\n## 📄 许可证\n\nArklex AI 采用 **MIT 许可证** 发布。详情请参阅 [LICENSE](LICENSE.md)。\n\n这意味着你可以：\n\n- ✅ 将 Arklex AI 用于商业项目\n- ✅ 修改并分发代码\n- ✅ 在专有应用中使用\n- ✅ 销售基于 Arklex AI 构建的应用程序\n\n唯一的条件是，你需要包含原始许可证和版权声明。\n\n---\n\n## 🙏 致谢\n\n感谢所有贡献者和开源社区，正是你们让这个项目成为可能！\n\n### 🌟 贡献者\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Farklexai_Agent-First-Organization_readme_569dc83d1034.png\" \u002F>\n\u003C\u002Fa>\n\n### 🤝 开源依赖\n\nArklex AI 站在巨人的肩膀上：\n\n- **LangChain** — LLM 框架与工具\n- **FastAPI** — 现代 Web 框架\n- **Pydantic** — 数据验证\n- **SQLAlchemy** — 数据库 ORM\n- **Milvus** — 向量数据库\n- **以及更多...**\n\n---\n\n\u003Cdiv align=\"center\">\n\n**由 Arklex AI 团队用心打造**\n\n[官网](https:\u002F\u002Farklex.ai) • [文档](https:\u002F\u002Farklexai.github.io\u002FAgent-First-Organization\u002F) • [GitHub](https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization) • [Discord](https:\u002F\u002Fdiscord.gg\u002FkJkefzkRg5) • [LinkedIn](https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Farklex)\n\n\u003C\u002Fdiv>","# Arklex AI (Agent-First) 快速上手指南\n\nArklex AI 是一个企业级的智能体优先（Agent-First）框架，旨在帮助开发者快速构建、部署和扩展多智能体协作系统。本指南将帮助你在 5 分钟内完成环境搭建并运行第一个智能体示例。\n\n## 1. 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **操作系统**：Linux, macOS 或 Windows\n*   **Python 版本**：3.10 或更高版本\n*   **依赖项**：\n    *   `pip` (Python 包管理工具)\n    *   `git` (用于克隆代码仓库)\n*   **API Key**：你需要至少一个大语言模型提供商的 API Key（如 OpenAI, Anthropic, Google 等）。\n\n> **提示**：国内开发者若遇到 PyPI 下载缓慢问题，建议使用国内镜像源安装依赖（见下文安装步骤）。\n\n## 2. 安装步骤\n\n### 第一步：安装核心库\n通过 pip 安装 `arklex` 核心包。\n\n```bash\n# 使用官方源\npip install arklex\n\n# 【推荐】国内开发者使用清华镜像源加速安装\npip install arklex -i https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n```\n\n### 第二步：配置 API 密钥\n在项目根目录创建 `.env` 文件并填入你的 API Key。\n\n```bash\n# 创建 .env 文件并写入 OpenAI Key (替换为你自己的 key)\necho \"OPENAI_API_KEY=your_key_here\" > .env\n\n# 如果使用其他模型，可追加写入，例如：\n# echo \"ANTHROPIC_API_KEY=your_key_here\" >> .env\n```\n\n### 第三步：克隆仓库并安装开发依赖\n为了运行示例脚本和测试工具，需要克隆源代码仓库并以编辑模式安装。\n\n```bash\n# 克隆仓库\ngit clone https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization.git\ncd Agent-First-Organization\n\n# 以编辑模式安装本地依赖\npip install -e .\n\n# 【可选】国内加速：若 git 克隆慢，可使用国内镜像\n# git clone https:\u002F\u002Fgitee.com\u002Fmirror\u002FAgent-First-Organization.git (需确认是否有同步镜像)\n```\n\n### 第四步：验证配置\n运行测试脚本确保 API Key 配置正确且网络通畅。\n\n```bash\npython test_api_keys.py\n\n# 仅测试特定提供商（例如只测 OpenAI 和 Gemini）\npython test_api_keys.py --providers openai gemini\n```\n\n## 3. 基本使用\n\n本框架推荐使用预置的示例配置来快速启动智能体。以下以“客户服务智能体”为例。\n\n### 启动智能体\n使用 `run.py` 脚本加载示例配置并启动服务。请确保当前位于项目根目录。\n\n```bash\npython run.py \\\n  --input-dir .\u002Fexamples\u002Fcustomer_service \\\n  --llm_provider openai \\\n  --model gpt-4o\n```\n\n*   `--input-dir`: 指定包含配置文件和文档的示例目录。\n*   `--llm_provider`: 指定大模型提供商（如 `openai`, `anthropic`）。\n*   `--model`: 指定具体模型名称（如 `gpt-4o`, `claude-3-haiku-20240307`）。\n\n### （可选）运行评估测试\n如果你需要对智能体进行自动化评估，可以先启动模型 API 服务器，然后运行评估脚本。\n\n**终端 1：启动 API 服务器**\n```bash\npython model_api.py --input-dir .\u002Fexamples\u002Fcustomer_service\n```\n\n**终端 2：运行评估**\n```bash\npython eval.py --model_api http:\u002F\u002F127.0.0.1:8000\u002Feval\u002Fchat \\\n  --config \"examples\u002Fcustomer_service\u002Fcustomer_service_config.json\" \\\n  --documents_dir \"examples\u002Fcustomer_service\" \\\n  --model \"claude-3-haiku-20240307\" \\\n  --llm_provider \"anthropic\" \\\n  --task \"all\"\n```\n\n---\n**下一步学习**：\n成功运行后，你可以查看 `examples\u002F` 目录下的更多场景（如 Shopify 集成、CRM 管理等），或访问 [官方文档](https:\u002F\u002Farklexai.github.io\u002FAgent-First-Organization\u002F) 深入学习架构设计与自定义开发。","某中型电商企业的技术团队正急需构建一个能处理复杂售后流程（如自动查询订单、检索知识库并生成工单）的智能客服系统。\n\n### 没有 Agent-First-Organization 时\n- **开发周期漫长**：工程师需从零编写多智能体协作逻辑和状态管理代码，原本预计数周的开发工作往往拖延至数月。\n- **模型切换成本高**：业务方想测试 Anthropic 或 Gemini 模型以降低延迟，但硬编码的架构导致每次切换都需重构大量底层代码。\n- **缺乏可靠评估机制**：上线前无法系统化验证代理在复杂场景下的准确率，只能依靠人工抽检，导致生产环境频繁出现“幻觉”或死循环。\n- **运维监控缺失**：代理运行出错时缺乏统一日志和自动扩缩容能力，故障排查如同“盲人摸象”，难以保障企业级稳定性。\n\n### 使用 Agent-First-Organization 后\n- **部署效率飞跃**：利用其声明式任务图（Task Graph）和预置编排引擎，团队仅用 20 分钟便搭建出包含 RAG 检索与工单创建的多智能体工作流，开发速度提升 90%。\n- **灵活适配多模型**：凭借模型无关架构，开发人员只需修改配置参数即可在 OpenAI、Anthropic 等主流大模型间无缝切换，快速找到成本与性能的最优解。\n- **内置自动化评测**：调用框架自带的评估套件，在上线前对数千条历史客诉数据进行回归测试，确保代理回答准确率达标，显著降低生产风险。\n- **企业级可观测性**：原生集成的监控日志与自动扩缩容功能，让团队能实时追踪每个代理节点的运行状态，轻松应对大促期间的流量洪峰。\n\nAgent-First-Organization 将原本繁琐的多智能体系统工程化难题，转化为可配置、可评估且生产就绪的标准流程，让企业真正专注于业务逻辑而非底层基建。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Farklexai_Agent-First-Organization_cb3c4423.jpg","arklexai","Arklex.AI","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Farklexai_4ead313b.png","",null,"https:\u002F\u002Fgithub.com\u002Farklexai",[82,86],{"name":83,"color":84,"percentage":85},"Python","#3572A5",99.4,{"name":87,"color":88,"percentage":89},"Shell","#89e051",0.6,700,99,"2026-03-29T15:07:07","MIT","未说明",{"notes":96,"python":97,"dependencies":98},"该工具主要依赖外部大模型 API（如 OpenAI、Anthropic、Google），无需本地部署大型模型或专用 GPU。运行前需配置 .env 文件并填入相应的 LLM API Key。若使用 RAG 功能，可选配置 Milvus 向量数据库；若使用搜索功能，需配置 Tavily API Key。支持通过 pip install arklex 直接安装，或通过源码克隆后以编辑模式安装。","3.10+",[99,100,101,102,103,104],"arklex","LangChain","FastAPI","Pydantic","SQLAlchemy","Milvus",[13,15],"2026-03-27T02:49:30.150509","2026-04-06T09:46:02.467502",[109,114,119,124,129],{"id":110,"question_zh":111,"answer_zh":112,"source_url":113},14530,"运行脚本时出现 litellm 相关的导入错误或兼容性问题如何解决？","这是由于 litellm 新版本（1.67.4）存在的已知问题导致的。简单的修复方法是降级 litellm 到稳定版本 1.67.2，请运行以下命令：\npip install litellm==1.67.2","https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization\u002Fissues\u002F98",{"id":115,"question_zh":116,"answer_zh":117,"source_url":118},14529,"运行 create.py 时遇到 \"No module named 'agentorg'\" 错误怎么办？","该错误通常是因为加载了过期的缓存文件。解决方法是删除生成的 task_documents.pkl 文件，然后重新运行命令：\nrm .\u002Fexamples\u002Fcustomer_service\u002Ftask_documents.pkl\n或者，如果你之前重命名过文件夹，请确保文件夹名称与代码中的引用一致（例如将 \"arklex\" 文件夹重命名为 \"agentorg\" 也可以解决，但推荐删除缓存文件）。","https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization\u002Fissues\u002F39",{"id":120,"question_zh":121,"answer_zh":122,"source_url":123},14531,"test_api_keys.py 脚本报错 \"No module named 'arklex.utils.provider_utils'\" 是怎么回事？","维护者已移除 provider_utils.py 文件以防止 API Key 硬编码在代码中。现在不应再使用该测试脚本，而应将 API Key 设置为环境变量。该测试文件后续也会被从仓库中移除。","https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization\u002Fissues\u002F341",{"id":125,"question_zh":126,"answer_zh":127,"source_url":128},14532,"如何在配置文件中定义自定义任务（tasks）？","根据最新文档更新，配置文件中的 \"tasks\" 字段应直接填写需要完成的任务列表。原有的 \"step\" 字段已不再需要，因为步骤将由生成器（generator）自动决定。","https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization\u002Fissues\u002F1",{"id":130,"question_zh":131,"answer_zh":132,"source_url":133},14533,"README 文档中关于输出目录的参数写法是 --output-dir 还是 --output_dir？","创建演示（create.py）时使用的是连字符 --output-dir，而评估脚本（eval.py）中可能使用下划线 --output_dir。目前 README 中关于创建命令的示例 --output-dir 是正确的。如果涉及评估命令，建议统一检查 eval.py 中的定义或提交 PR 以保持一致性。","https:\u002F\u002Fgithub.com\u002Farklexai\u002FAgent-First-Organization\u002Fissues\u002F93",[135,140,145,150,155,160,165,170,175,180,185,190,195,200,205,210,215,220,225,230],{"id":136,"version":137,"summary_zh":138,"released_at":139},81435,"v0.1.21","**增强**\n\n- NLU 代理输入护栏","2026-03-09T16:23:23",{"id":141,"version":142,"summary_zh":143,"released_at":144},81436,"v0.1.20","**增强**\r\n\r\n- 升级 `unstructured` 包版本\r\n- 升级 OpenAI 模型版本","2026-02-27T20:43:17",{"id":146,"version":147,"summary_zh":148,"released_at":149},81437,"v0.1.19","**修复**\n\n- 修复 Milvus 包依赖","2026-02-24T22:32:37",{"id":151,"version":152,"summary_zh":153,"released_at":154},81438,"v0.1.18","**修复**\n\n- Milvus 包依赖","2026-02-18T14:46:41",{"id":156,"version":157,"summary_zh":158,"released_at":159},81439,"v0.1.17","**修复**\n\n- 工具调用显示","2026-02-13T19:09:52",{"id":161,"version":162,"summary_zh":163,"released_at":164},81440,"v0.1.16","**修复**\n\n- 修复 pipecat 以及实时工具调用和槽位验证","2026-01-20T16:39:09",{"id":166,"version":167,"summary_zh":168,"released_at":169},81441,"v0.1.15","**修复**\n\n- 升级 `faiss-cpu` 版本","2026-01-12T20:34:35",{"id":171,"version":172,"summary_zh":173,"released_at":174},81442,"v0.1.14","**新功能**\n\n- 语音通话转接摘要及话务事件触发工具","2025-12-04T17:05:01",{"id":176,"version":177,"summary_zh":178,"released_at":179},81443,"v0.1.13","**新功能**\n\n- 基于大语言模型的标签匹配，用于 Milvus 检索器","2025-11-19T15:42:47",{"id":181,"version":182,"summary_zh":183,"released_at":184},81444,"v0.1.12","**增强**\r\n\r\n- 包版本号提升\r\n- HTTP 工具输入校验","2025-11-17T15:47:07",{"id":186,"version":187,"summary_zh":188,"released_at":189},81445,"v0.1.11","**New Feature**\r\n\r\n- Input\u002Foutput guardrail for LLM-based agents\r\n\r\n**Fix**\r\n\r\n- Fix call transfer tool","2025-11-05T19:34:30",{"id":191,"version":192,"summary_zh":193,"released_at":194},81446,"v0.1.10","**Enhancement**\r\n\r\n- Separation of rule-based agent from LLM-based ones","2025-11-03T16:04:58",{"id":196,"version":197,"summary_zh":198,"released_at":199},81447,"v0.1.9","**Enhancement**\r\n\r\n- Validate required slots for HTTP tool\r\n- Agent migration to OpenAI Agent SDK","2025-10-22T20:30:17",{"id":201,"version":202,"summary_zh":203,"released_at":204},81448,"v0.1.9-rc.2","**Enhancement**\r\n\r\n- Agent migration to OpenAI Agent SDK","2025-10-21T21:05:14",{"id":206,"version":207,"summary_zh":208,"released_at":209},81449,"v0.1.9-rc.1","**Enhancement**\r\n\r\n- Validate required slots for HTTP tool","2025-10-15T21:16:00",{"id":211,"version":212,"summary_zh":213,"released_at":214},81450,"v0.1.8","**Enhancement**\r\n\r\n- Move Milvus-related data\r\n- Add integration tests","2025-10-07T20:38:09",{"id":216,"version":217,"summary_zh":218,"released_at":219},81451,"v0.1.7","**Fix**\r\n\r\n- Fix skip node function\r\n\r\n**Enhancement**\r\n\r\n- Single API call for slot filling","2025-09-29T15:37:00",{"id":221,"version":222,"summary_zh":223,"released_at":224},81452,"v0.1.6","**New Feature**\r\n\r\n- Add a output process node for tool execution results\r\n\r\n**Fix**\r\n\r\n- Fix NLU-based slot filling","2025-09-24T19:14:59",{"id":226,"version":227,"summary_zh":228,"released_at":229},81453,"v0.1.5","**Fix**\r\n\r\n- Fix realtime retriever\r\n- Fix realtime agent slots\r\n\r\n**Enhancement**\r\n\r\n- Remove unused packages\r\n- Add prompt variable to the text agent","2025-09-18T15:00:46",{"id":231,"version":232,"summary_zh":233,"released_at":234},81454,"v0.1.5-rc.6","**Fix**\r\n\r\n- Fix a case where start_agent_data is null","2025-09-16T17:09:09"]