License: Apache-2.0
AWS DevOps Agent
사건 대응(incident response), 근본 원인 분석(root cause analysis), 운영 문제 해결(operational troubleshooting)을 위해 AWS DevOps Agent의 기능을 확장하는 오픈 소스 스킬, 커스텀 에이전트, MCP 서버 및 인프라 템플릿입니다.
⚠️ 중요 공지사항
이 도구들은 샘플 코드로 제공됩니다. 프로덕션 환경에 배포할 계획이라면, 먼저 비(非)프로덕션 환경에서 시작해야 하며, 프로덕션에 배포하기 전에 다음 사항을 확인하십시오:
- 반드시 비(非)프로덕션 환경에서 철저히 테스트합니다.
- 조직의 정책에 따라 IAM 권한 및 보안 구성을 검토합니다.
- 동작 방식이 운영 요구사항을 충족하는지 검증합니다.
사용 조건은 LICENSE 파일을 참조하십시오.
본 저장소에는 다음 내용들이 포함되어 있습니다:
- Skills — 에이전트가 조사 과정에서 따르는 도메인별 지식, 의사 결정 트리(decision trees), 단계별 런북(runbooks)입니다. 이대로 사용하거나 자신만의 것을 작성하기 위한 템플릿으로 활용하십시오. Skills Catalog를 살펴보십시오.
- Custom Agents — 건강 보고서나 운영 검토와 같은 반복적인 운영 워크플로우를 위해 시스템 프롬프트(system prompts) 및 도구 할당이 포함된 사전 구축 에이전트 구성입니다. Custom Agents Catalog를 살펴보십시오.
- MCP Servers — 이 저장소의 스킬 및 커스텀 에이전트와 함께 작동하도록 맞춤 제작된 MCP 서버로, 필요한 정보를 검색하는 기능을 확장합니다. MCP Servers Catalog를 살펴보십시오.
- CloudFormation Templates — 스킬에 필요한 IAM 권한을 프로비저닝하기 위한 Infrastructure-as-code(IaC)입니다.
모든 도구는 contribution guidelines에 따라 기여 및 테스트되었습니다.
Skills, Custom Agents, 그리고 MCP Servers란 무엇인가요?
**스킬(Skills)**은 에이전트가 특정 운영 시나리오를 조사하는 방법을 학습시키는 구조화된 명령어 세트입니다. 이 스킬들은 오픈 Agent Skills 사양을 따르며, Agent Space에 업로드하여 내장 기능 이상의 지식을 에이전트에 확장할 수 있습니다. 자세한 내용은 DevOps Agent 스킬 문서를 참조하십시오.
**사용자 정의 에이전트(Custom agents)**는 사용자가 직접 정의하는 AI 에이전트로, 특정 인프라에 특화된 운영 작업을 자동화합니다. 시스템 프롬프트(system prompt)를 정의하고 도구와 스킬을 할당한 다음, 필요할 때 또는 예약된 일정에 따라 실행할 수 있습니다. 자세한 내용은 DevOps Agent 사용자 정의 에이전트 문서를 참조하십시오.
**MCP 서버(MCP servers)**는 오픈 Model Context Protocol을 구현하여 에이전트를 외부 시스템 및 데이터 소스에 연결합니다. 이 저장소의 서버들은 이곳의 스킬 및 사용자 정의 에이전트와 함께 작동하도록 맞춤 제작되어, 필요한 정보를 검색할 수 있도록 기능을 확장합니다.
시작하기
Agent Space에 스킬과 사용자 정의 에이전트를 배포하는 단계별 지침은 시작 가이드 문서를 참조하십시오.
스킬 권한
각 스킬은 README의 전제 조건(Prerequisites) 섹션에 필요한 IAM 권한을 문서화합니다. 스킬이 완벽하게 작동하려면 Agent Space와 연결된 DevOps Agent 역할이 이러한 권한을 가지고 있어야 합니다.
대부분의 권한은 AWS 관리형 정책인 AIDevOpsAgentAccessPolicy에 의해 이미 처리됩니다. 추가 권한이 필요한 스킬의 경우, 포함된 CloudFormation 템플릿을 사용하여 자동으로 해당 권한을 프로비저닝할 수 있습니다.
aws cloudformation deploy \
--template-file cloudformation/devops-agent-skill-policies.yaml \
--stack-name devops-agent-skill-policies \
...
이 템플릿은 스킬별 정책 활성화/비활성화, 선택적 리전 제한을 지원하며, 기존 역할에 연결하거나 새 역할을 생성할 수 있습니다. 자세한 내용은 cloudformation/devops-agent-skill-policies.yaml를 참조하십시오.
기여 (Contributing)
새로운 스킬의 기여와 기존 스킬 개선을 환영합니다. 가이드라인은 CONTRIBUTING를 참조하십시오.
지원 (Support)
도움이 필요하거나 버그를 발견했거나 새로운 도구를 제안하고 싶으신가요? 지원을 받는 방법과 이슈를 제출할 곳은 SUPPORT를 참조하십시오.
참고 자료 (References)
AWS 문서 (AWS Documentation)
블로그 게시물 및 기사
라이선스 (License)
이 라이브러리는 Apache-2.0 라이선스에 따라 라이선스가 부여되었습니다. LICENSE 파일을 참조하십시오.
