Hacker News • 2일 전

오픈 엔벨로프: AI 에이전트 팀 정의 오픈 스키마

IMP

7/10

핵심 요약

AI 에이전트 팀 구성을 표준화된 JSON Schema로 정의할 수 있는 오픈소스 프로젝트가 공개되었습니다. 역할, 권한, 승인 게이트 등을 포함해 팀을 한 번 정의하면 Docker처럼 다양한 런타임에서 실행할 수 있도록 이식성을 확보하는 것이 핵심입니다.

번역된 본문

AI 에이전트 팀을 정의하기 위한 오픈 JSON Schema를 구축했습니다.

다중 에이전트 시스템이 실제 배포 패턴으로 자리잡고 있습니다. 단일 어시스턴트가 아니라 역할, 작업 인계, 인간의 검토 체크포인트를 갖춘 팀 형태죠. 하지만 이를 프레임워크에 상관없이 공통으로 정의할 방법이 없었습니다. 모든 구현이 분산되어 처음 선택한 도구에 종속되곤 했습니다. 이 문제를 해결하기 위해 이 스키마를 만들었습니다.

스키마는 schema.openenvelope.org에 있으며, SchemaStore에 등록되어 있습니다. 따라서 VS Code에 .envelope.json 파일을 추가하면 별도 설치 없이도 자동완성과 유효성 검사를 사용할 수 있습니다. 프로그래밍 방식으로 유효성을 검사하려면 npm의 @openenvelope/schema를 사용할 수 있습니다.

이 사양은 에이전트 정의(역할, 프롬프트, 모델, 접근 정책), 감독자/하위 에이전트 계층 구조, 휴먼 인 더 루프(Human-in-the-loop) 게이트, 파이프라인, 스케줄, 배포 시 주입되는 시크릿/변수 등을 다룹니다. 접근 정책을 통해 각 에이전트가 호출할 수 있는 호스트를 명확하게 선언할 수 있으며, 런타임은 이를 프롬프트가 아닌 네트워크 수준에서 강제합니다.

목표는 이식 가능한 정의 형식을 만드는 것입니다. 팀을 한 번 정의하면 호환되는 모든 런타임에서 실행할 수 있어야 합니다. Dockerfile이 특정 호스트에 종속되지 않고 컨테이너를 설명하는 것과 비슷합니다. openenvelope.org에 관리형 런타임이 있지만, 스키마 자체는 Apache 2.0 라이선스이므로 누구나 구현할 수 있습니다.

사양의 어떤 부분에 대해든 질문에 기꺼이 답변드리겠습니다. 특히 다중 에이전트 시스템을 구축해 보셨고 무엇이 빠져 있는지 의견이 있으신 분들의 피드백에 매우 관심이 있습니다.

원문 보기

원문 보기 (영어)

Built an open JSON Schema for defining AI agent teams.Multi-agent systems are becoming a real deployment pattern — not single assistants, but teams with roles, handoffs, and human checkpoints. But there's no shared way to define one that travels across frameworks. Every implementation is scattered, locked to whichever tool you picked first. Built the schema to fix that.The schema lives at schema.openenvelope.org and is registered in SchemaStore, so if you drop a .envelope.json file in VS Code you get autocomplete and validation without installing anything. It's also on npm as @openenvelope/schema if you want to validate programmatically.The spec covers: agent definitions (role, prompt, model, access policy), supervisor/sub-agent hierarchy, human-in-the-loop gates, pipelines, schedules, and secrets/variables that get injected at deploy time. Access policies let you declare exactly which hosts each agent can call — the runtime enforces this at the network level, not in the prompt.The goal is a portable definition format — define a team once, any compatible runtime can execute it. Similar to how Dockerfiles describe a container without being tied to a specific host. There's a managed runtime at openenvelope.org but the schema is Apache 2.0 and anyone can implement it.Happy to answer questions on any part of the spec — especially interested in feedback from people who've built multi-agent systems and have opinions on what's missing.

에이전트 다중 에이전트 오픈소스 스키마 오케스트레이션