aliyun/ai-agent-handbook

O que é?

Recursos principais

• 01Aborda todo o ciclo de vida dos agentes, da arquitetura e do desenvolvimento ao runtime, à governança e à otimização.
• 02Explica o design de harness, o gerenciamento de contexto e estado, o uso de ferramentas via MCP e A2A e os controles de permissão.
• 03Descreve questões de runtime e sandbox, governança de tráfego com AI gateway e comunicação entre múltiplos agentes.
• 04Inclui capítulos sobre observabilidade, segurança, gestão de ativos e validação pré-lançamento baseada em simulação.
• 05Apresenta estudos de caso empresariais dos setores automotivo, varejista, de engenharia de software e de empresas de internet.
• 06Oferece um site de leitura online com navegação por capítulos e busca de texto completo em chinês.

Casos de uso

• Arquitetos que avaliam como estruturar uma plataforma empresarial de agentes antes de se comprometer com um projeto.
• Engenheiros que estão levando um protótipo de agente para produção e buscam orientações sobre estado, gateways e observabilidade.
• Equipes que estão criando processos de governança, revisão de segurança e avaliação para agentes de IA internos.
• Educadores ou estudantes que procuram uma referência em chinês sobre engenharia de agentes empresariais.

Início rápido

1. 1

   Clone o repositório

2. 2

   Instale as dependências com Node.js 22 (npm ci)

   npm ci
3. 3

   Inicie o servidor de pré-visualização local

   npm run dev

Antes de usar

• !Este é um manual em chinês, por isso a maior parte do conteúdo está nesse idioma.
• !É um livro para leitura, não uma biblioteca de software nem um aplicativo.

Em coleções

Tópicos

Perguntas frequentes

O que é ai-agent-handbook?

Manual em chinês da Alibaba Cloud sobre como criar, operar, governar e otimizar agentes de IA empresariais ao longo de todo o ciclo de vida. Este projeto é um manual extenso e de código aberto sobre agentes de IA empresariais, organizado em torno de todo o ciclo de vida: arquitetura, desenvolvimento, operação, governança e otimização. Reúne experiências práticas da Alibaba Cloud, de seus clientes empresariais e de desenvolvedores de código aberto para colocar agentes em produção.

ai-agent-handbook é gratuito? Qual é a licença?

ai-agent-handbook é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

ai-agent-handbook ainda é mantido?

Manutenção ativa. O último commit de ai-agent-handbook foi em 5 de nov. de 2026.

Para que posso usar ai-agent-handbook?

Arquitetos que avaliam como estruturar uma plataforma empresarial de agentes antes de se comprometer com um projeto. Engenheiros que estão levando um protótipo de agente para produção e buscam orientações sobre estado, gateways e observabilidade. Equipes que estão criando processos de governança, revisão de segurança e avaliação para agentes de IA internos. Educadores ou estudantes que procuram uma referência em chinês sobre engenharia de agentes empresariais.

Como instalar ai-agent-handbook?

Clone o repositório Instale as dependências com Node.js 22 (npm ci): npm ci Inicie o servidor de pré-visualização local: npm run dev

Onde consigo ai-agent-handbook?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/aliyun/ai-agent-handbook