Detalhes
ai / professional
ABCD
Construí o ABCD do zero na Adopt AI como um workspace open-source de agente de código para transformar gravações HAR/API em ações WDL, testes, rascunhos e etapas de publicação.
Arquitetura 3D ao vivo
Use a navegação para alternar entre diagramas e trabalhos relacionados, depois role o painel para ler os detalhes.
Gravações HAR viram ações WDL por meio de um workspace de agente de código e da CLI da plataforma.
Papel e problema
Construí o ABCD do zero para encurtar a autoria de ações da Adopt.
Construído do zero
Construí o ABCD sozinho do zero na Adopt AI.
Por que construí
As ações da Adopt eram escritas em WDL, e novas integrações de clientes podiam travar quando APIs web privadas tinham esquemas errados ou incompletos. Forward-deployed engineers passavam tempo demais traduzindo comportamento gravado em ações confiáveis.
Demo de Odoo
No demo de Odoo, um HAR gravado passou por descoberta de autenticação, ingestão de API/esquema, criação de ação, criação de workflow e publicação em nuvem. Levei aquela tarefa de integração de 7 dias para 2-3 horas.
Mecanismos de implementação
O código organiza contexto do agente, descoberta, testes, rascunhos e publicação.
Workspace do agente
ABCD dá ao Cursor ou Claude Code ferramentas da plataforma, instruções, sub-prompts e documentação WDL. O agente de código edita arquivos locais de ação enquanto a CLI Python resolve contexto e chama o backend da Adopt.
Herança de perfis
Perfis de cliente usam um merge recursivo não vazio de ambiente para agente para ação. Valores de perfil mais específicos sobrescrevem valores herdados, enquanto strings vazias, listas vazias, objetos vazios e null não apagam configurações do nível pai. O carregamento de .env usa uma busca separada do ambiente ativo em direção à raiz do workspace.
Descoberta e cache
A descoberta semântica usa embeddings normalizados de Sentence Transformer com um índice FAISS de produto interno, então a similaridade por cosseno funciona sobre vetores normalizados. A busca híbrida de ações combina candidatos semânticos com matching textual e mantém a pontuação máxima para cada item. O hash estreito do cache cobre id, title e description, não o esquema inteiro da API.
Testes e versões
O test runner pode enviar WDL local para /run-wdl, executar casos multi-turn, inlinar ações filhas sob um pai, usar --remote para ações registradas e usar --compile ou --validate quando solicitado. Um teste bem-sucedido informa status de execução; conferir a saída ainda exige revisar seu conteúdo. Checkout restaura arquivos WDL locais, não efeitos externos de API.
Benefícios de engenharia
Mecanismos concretos que facilitaram a autoria de ações.
Iteração guiada por trace
Engenheiros podiam editar WDL, rodar casos concretos, inspecionar traces, identificar a operação que falhou e preparar rascunhos sem copiar cada detalhe de API manualmente.
Testes de ações compostas
Casos multi-turn e agentes pai com ações filhas inline permitiam testar workflows mais perto de como ações compostas da Adopt rodam.
Conexão com RCE
Depois que a camada de Remote Code Execution existiu, o ABCD podia mirar Lambda ou Sandbox e enviar código Lambda gerado para o registry da plataforma.
Controle de publicação
Rascunhos e publicação no backend são separados. A publicação pede confirmação por padrão, --yes pula o prompt, --dry-run pré-visualiza mudanças, e falhas de publicação de ações filhas geram aviso em vez de agir como uma transação.
Stack e domínios
- Python
- Poetry
- WDL
- HAR analysis
- LLM agents
- FAISS
- Sentence Transformers
- Pydantic
- Playwright