A set of 23 custom plugins for hermes-agent covering autonomy, model routing, telemetry, cost control, memory and inter-agent messaging.
543+1 this week60PythonMITUpdated 14 days ago
aliyun/ai-agent-handbook
A Chinese-language handbook from Alibaba Cloud on building, running, governing and tuning enterprise AI agents across their lifecycle.
- Stars
- 2,922
- Forks
- 372
- Open issues
- 3
- Last commit
- 12 hours ago
What is it?
This project is a long-form, open-source handbook on enterprise AI agents, organized around the full lifecycle: architecture, build, run, governance and optimization. It collects practical experience from Alibaba Cloud, its enterprise customers and open-source developers on taking agents into production.
The content is organized into parts covering reference architecture, the harness that organizes tasks, context and actions, runtime and sandboxing, AI gateway traffic governance, multi-agent coordination, observability, security, asset management, simulation-based testing, and data-driven optimization with trajectories and golden datasets. It also includes case studies from industries such as automotive, retail, software development and internet platforms, plus a survey report on agent development.
The handbook is published as an online reading site with chapter navigation and Chinese search, and it is maintained in the open with a stated plan to add more cases, cloud-based hands-on exercises and community contributions.
Key features
- 01Covers the full agent lifecycle from architecture and build to runtime, governance and optimization.
- 02Explains harness design, context and state management, tools via MCP and A2A, and permission controls.
- 03Describes runtime and sandbox concerns, AI gateway traffic governance, and multi-agent communication.
- 04Includes observability, security, asset management and simulation-based pre-release validation chapters.
- 05Provides enterprise case studies from automotive, retail, software engineering and internet companies.
- 06Offers an online reading site with chapter navigation and Chinese full-text search.
Use cases
- Architects evaluating how to structure an enterprise agent platform before committing to a design.
- Engineers moving an agent prototype into production and looking for guidance on state, gateways and observability.
- Teams setting up governance, security review and evaluation processes for internal AI agents.
- Educators or students who want a Chinese-language reference on enterprise agent engineering.
Quick start
- 1
Clone the repository
- 2
Install dependencies with Node.js 22 (npm ci)
npm ci - 3
Start the local preview server
npm run dev
Things to know
- This is a Chinese-language handbook, so most content is in Chinese.
- It is a book of reading material rather than a software library or application.
In collections
Topics
FAQ
- What is ai-agent-handbook?
- A Chinese-language handbook from Alibaba Cloud on building, running, governing and tuning enterprise AI agents across their lifecycle. This project is a long-form, open-source handbook on enterprise AI agents, organized around the full lifecycle: architecture, build, run, governance and optimization. It collects practical experience from Alibaba Cloud, its enterprise customers and open-source developers on taking agents into production.
- Is ai-agent-handbook free to use? What license does it have?
- ai-agent-handbook is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
- Is ai-agent-handbook still maintained?
- Actively maintained. The last commit to ai-agent-handbook was on Nov 7, 2026.
- What can I use ai-agent-handbook for?
- Architects evaluating how to structure an enterprise agent platform before committing to a design. Engineers moving an agent prototype into production and looking for guidance on state, gateways and observability. Teams setting up governance, security review and evaluation processes for internal AI agents. Educators or students who want a Chinese-language reference on enterprise agent engineering.
- How do I install ai-agent-handbook?
- Clone the repository Install dependencies with Node.js 22 (npm ci): npm ci Start the local preview server: npm run dev
- Where can I get ai-agent-handbook?
- The source code and installation instructions are on GitHub: https://github.com/aliyun/ai-agent-handbook
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Self-hosted enterprise knowledge hub that compiles company docs into a wiki and serves it to Claude and other LLMs via an MCP server with department-scoped access.
1.5K+6 this week305PythonOtherUpdated 5 months ago
An MIT reference architecture for organizing AI agent teams with reusable role skills, MCP connectors, and human approval gates.
50+28 this week11JavaScriptMITWell maintainedUpdated 10 days ago
Self-hosted, open-source registry for publishing, versioning, and governing agent skill packages inside an organization.
5.4K+28 this week817JavaApache-2.0Updated 2 days ago
Open-source AI gateway giving one OpenAI-compatible API across 23+ LLM providers, with failover, load balancing, semantic caching and virtual keys.
9.4K+173 this week1.5KGoApache-2.0Updated 12 hours ago
A toolkit that turns enterprise architecture governance into AI-assisted workflows, generating draft principles, requirements, risk, and compliance artefacts for AI coding assistants.
Productivity & Apps#enterprise-architecture#ai-agents#architecture-governance#requirements-engineering#compliance
2.3K+8 this week286JavaScriptOtherUpdated 7 hours ago