aptible/unpage

현대 인프라는 복잡합니다. 에이전트가 효과적이려면 컨텍스트와 개발 도구에 대한 안전한 접근 권한이 필요합니다.

Unpage를 사용하면 몇 분 만에 프로덕션 레디(production-ready) SRE 에이전트를 구축할 수 있습니다:

• YAML에서 에이전트 정의: 이벤트에 어떻게 응답할지 구성합니다.
• 지능형 라우팅: 알림과 요청을 올바른 에이전트에 매칭시킵니다.
• 에이전트에 컨텍스트 제공: 플러그인 및 지식 그래프를 사용하여 인프라를 매핑합니다.
• 안전하게 통합: MCP(Managed Connectivity Platform) 또는 셸 액세스를 통해 로그, 메트릭, 트레이스, 인프라 프로바이더 및 외부 도구에 에이전트를 연결합니다.

참고

Unpage는 어리지만 프로덕션 레디하며 커뮤니티 피드백을 통해 빠르게 진화하고 있습니다.

Unpage 에이전트는 YAML 파일에서 자연어로 정의됩니다. 다음은 SSL/TLS 연결 실패를 조사하고 해당 인시던트에 대한 요약을 제공하는 예시 에이전트입니다:

# SSL-connection-failure-agent.yaml
# Description: 라우터가 어떤 에이전트를 사용할지 결정하는 데 사용됩니다.
description: Investigate SSL/TLS connection failures
...

Description: Unpage가 실행되고 알림 도구로부터 인시던트 페이로드(incident payload)를 수신하면, 라우터는 에이전트 설명을 사용하여 어떤 에이전트가 해당 인시던트에 조치해야 하는지 결정합니다.

Unpage의 라우터에 대해 더 자세히 알아보기.

Prompt: 선택된 에이전트는 프롬프트에 나열된 조사 단계를 따릅니다. 이는 종종 특정 유형의 알림을 위한 런북(runbook)과 유사할 것입니다.

Tools: 조사를 수행하기 위해 에이전트는 인프라를 이해하고 필요한 경우 알림에 대한 자세한 정보를 검색하는 도구를 사용합니다. 이 섹션에서 명시적으로 지정하여 에이전트가 접근할 수 있는 도구를 제한할 수 있습니다.

참고: 다음 명령을 실행하여 사용할 수 있는 모든 도구를 나열할 수 있습니다:

unpage mcp tools list

플러그인 및 도구 연결에 대해 더 자세히 알아보기.

Response: 이 경우, CPU 알림 에이전트는 인시던트에 댓글을 남깁니다:

근본 원인 파악: 도메인 ‘expired-rsa-dv.ssl.com’의 SSL 인증서가 만료되었습니다. 이 인증서는 2016년 8월 2일 GMT에 만료되었으며 (8년 이상 경과), 이것이 SSL 연결 실패의 원인입니다. 즉각적인 조치 필요: SSL 연결성을 복구하려면 영향을 받는 도메인에 대한 인증서 갱신이 필요합니다.

사용자의 에이전트를 맞춤 설정하여 다양한 유형의 알림에 자동으로 응답하고 이를 해결하기 위한 다른 작업을 수행할 수 있습니다. 더 많은 예시는 여기를 참조하세요.

첫 번째 에이전트를 생성하려면 Unpage를 설치하고 Quickstart를 실행하십시오. 시작할 수 있는 몇 가지 예제 에이전트가 제공되거나, 직접 만들 수도 있습니다!

# Unpage 설치
curl -fsSL https://install.unpage.ai | bash

# Quickstart
unpage agent quickstart

도움이 필요하면 Unpage Slack 커뮤니티에서 저희를 찾거나 이 데모를 따라가세요:

macOS의 경우:

curl -fsSL https://install.unpage.ai | bash

다른 플랫폼의 경우, 먼저 공식 uv 설치 가이드를 사용하여 uv를 설치한 다음 위의 명령을 실행하십시오.

시작하려면 다음을 실행하세요:

unpage agent quickstart

이렇게 하면 첫 번째 에이전트로 바로 작동할 수 있으며, 이 에이전트는 PagerDuty(또는 선호하는 알림 제공업체)의 알림을 자동으로 조사하고 컨텍스트를 추가합니다. 또한 인프라 지식 그래프를 설정하여 에이전트에 더 많은 컨텍스트를 제공할 기회도 얻게 됩니다.

• 에이전트 테스트 및 실행
• 지식 그래프 설정
• 사용자 정의 스크립트로 에이전트의 지식 확장

Unpage 팀에 요청할 사항이 있습니까? Slack 또는 GitHub에서 알려주세요.

자세한 문서는 docs/에 있으며, Mintlify를 통해 docs.unpage.ai에도 게시됩니다.

LICENSE.md를 참조하세요.

Copyright (c) 2025 Aptible. 모든 권리 보유.