Azure SRE 에이전트의 커넥터

에이전트에는 Azure 서비스에 대한 기본 제공 액세스 권한이 제공됩니다. Azure Monitor, Application Insights, Log Analytics 및 Azure Resource Graph 쿼리할 수 있습니다. 커넥터는 Kusto 클러스터, 소스 코드 리포지토리, 협업 도구 및 사용자 지정 API와 같은 외부 시스템에 도달하도록 확장합니다.

커넥터 없이 에이전트가 수행할 수 있는 작업

구성된 커넥터가 없더라도 에이전트는 관리 ID 및 AZURE RBAC 권한을 통해 기본 제공 기능을 제공합니다.

Azure Resource Graph 및 ARM 작업은 App Services, Container Apps, VM, 네트워킹, 스토리지 등 모든 Azure 리소스 유형에서 작동합니다. 로그 및 메트릭이 Azure Monitor 및 Application Insights에 있는 경우 에이전트는 커넥터 설정이 필요하지 않은 문제를 즉시 조사할 수 있습니다. 커넥터는 에이전트가 시스템 outside Azure에 연결해야 할 때 유용합니다.

커넥터에서 제공하는 기능

커넥터는 에이전트에 제공하는 항목에 따라 4가지 범주로 분류됩니다.

데이터 원본

데이터 저장소에서 로그, 메트릭 및 원격 분석을 쿼리합니다.

소스 코드 및 지식

코드, 위키 및 설명서와 같은 시스템에 대한 에이전트 컨텍스트를 제공합니다.

이러한 커넥터를 사용하면 에이전트가 코드에서 오류 패턴을 검색하고, 위키 설명서를 읽고, 문제 해결 중에 API 문서를 참조하고, 인시던트를 관련 끌어오기 요청에 연결할 수 있습니다.

공동 작업 도구

에이전트가 팀에서 이미 사용하는 채널을 통해 결과를 전달하도록 합니다.

사용자 지정 커넥터(MCP 서버)

MCP(모델 컨텍스트 프로토콜)를 사용하면 관찰성 플랫폼, 소스 코드 리포지토리, 티켓팅 시스템 및 사용자 지정 API를 비롯한 모든 시스템에 에이전트를 연결할 수 있습니다. 에이전트는 연결된 서버에서 도구를 자동으로 검색하고, 60초 하트비트를 사용하여 연결 상태를 모니터링하며, 일시적인 오류로부터 자동으로 복구합니다.

두 가지 전송 유형은 모든 배포 모델, 즉 원격 클라우드 서비스용 Streamable-HTTP 와 에이전트와 함께 실행되는 로컬 프로세스에 대한 stdio 를 다룹니다. GitHub, Datadog, Splunk, New Relic 등에 대해 미리 구성된 파트너 커넥터는 원클릭 설정을 제공합니다.

MCP 아키텍처, 전송 유형, 파트너 커넥터, 상태 모니터링 및 도구 관리에 대한 전체 가이드는 MCP 커넥터 및 도구를 참조하세요.

첫 번째 MCP 커넥터를 설정하려면 MCP 커넥터 설정을 참조하세요.

커넥터 찾아보기 및 관리

커넥터 페이지(Builder > Connectors)를 열어 커넥터가 축소 가능한 범주 그룹으로 구성되어 있는지 확인합니다. 모든 그룹은 기본적으로 확장됩니다.

각 범주 헤더는 해당 그룹의 커넥터 수를 보여 줍니다. 범주를 축소하면 해당 그룹의 커넥터에 연결 문제가 있는 경우 빨간색 배지가 나타납니다. 모든 섹션을 확장하지 않고도 문제를 한 눈에 확인할 수 있습니다. 도구 모음 컨트롤을 사용하여 보기를 관리합니다.

• 모두 펼치기 / 모두 접기를 클릭하면 모든 카테고리 그룹을 한 번에 전환할 수 있습니다.
• 특정 범주의 커넥터만 표시하는 범주 필터입니다.
• 이름으로 커넥터를 찾으려면 검색합니다(키워드 조회를 위해 플랫 목록으로 전환).

하나 이상의 커넥터를 포함하는 범주만 표시됩니다. 이름으로 커넥터를 검색하면 페이지가 더 빠른 필터링을 위해 플랫 목록 보기로 전환됩니다.

커넥터를 구성할 수 있는 사용자

커넥터 관리에는 에이전트에 대한 쓰기 권한이 필요합니다. 실제로:

설치하는 동안 일부 커넥터는 외부 시스템에 올바른 권한이 있는 사용자(예: GitHub 커넥터의 GitHub 조직 구성원 또는 Outlook/Teams의 Azure AD 관리자)로부터 OAuth 동의가 필요합니다. 이 동의는 SRE 에이전트 역할이 아닌 외부 서비스의 권한에 관한 것입니다.

에이전트의 관리 ID(예: Azure Data Explorer)를 사용하는 커넥터의 경우 외부 시스템의 관리자가 ID 목록을 허용해야 합니다.

커넥터를 구성하면 모든 에이전트 사용자가 커넥터를 자동으로 활용할 수 있습니다. 그들은 단지 에이전트에게 질문을 하고, 무대 뒤에서 사용 가능한 커넥터를 사용합니다.

커넥터 및 사용자 지정 에이전트

특수한 사용자 지정 에이전트에 특정 MCP 도구를 할당할 수 있습니다. 데이터베이스 문제 해결 사용자 지정 에이전트는 Kusto 도구를 가져올 수 있지만 배포 사용자 지정 에이전트는 GitHub 액세스 권한을 얻습니다. 이 방법은 각 사용자 지정 에이전트에 초점을 맞추고 너무 많은 도구로 과부하를 방지합니다.

포털 도구 선택기에서 개별적으로 도구를 할당하거나 YAML에서 와일드카드 패턴(connection-id/*)을 사용하여 서버의 모든 도구를 한 번에 추가합니다. 도구 할당 및 와일드카드 구문에 대한 자세한 내용은 MCP 커넥터 및 도구를 참조하세요.

포털에서 작성기>사용자 지정 에이전트 작성기로 이동하여 사용자 지정 에이전트를 만들거나 편집하고 고급 설정에서 도구 선택을 선택합니다. 도구 선택기는 MCP 연결별로 그룹화된 도구를 표시합니다. 사용자 지정 에이전트에 필요한 것을 선택합니다.

YAML에서 각 도구를 전체 이름으로 나열합니다.

mcp_tools:
  - azure-data-explorer_kusto_query
  - azure-data-explorer_kusto_table_list
  - azure-data-explorer_kusto_table_schema

MCP 서버의 모든 도구 추가(와일드카드)

적용 대상: 버전 26.2.9.0 이상

MCP 서버가 많은 도구를 노출하고 사용자 지정 에이전트에 모두 필요한 경우 각 도구를 개별적으로 나열하는 대신 와일드카드 패턴을 사용합니다.

mcp_tools:
  - azure-data-explorer/*

이 패턴은 {connection-id}/* 해당 MCP 연결의 모든 도구를 추가합니다. 에이전트는 시작할 때 와일드카드를 확장합니다. 예를 들어 azure-data-explorer/*는 azure-data-explorer라는 연결에 등록된 모든 도구로 해석됩니다 (릴리스 26.4.16.0에서 Kusto 커넥터가 포함된 Azure MCP의 미리 채워진 기본값). 커넥터에 지정한 이름을 대체합니다.

와일드카드를 개별 도구 이름과 결합할 수 있습니다.

mcp_tools:
  - azure-data-explorer/*  # All tools from the Kusto connection
  - grafana-mcp_dashboard  # One specific tool from Grafana

다음 표에서는 개별 도구 선택 및 와일드카드 방법을 비교합니다.

와일드카드를 사용하는 이유는 무엇인가요? MCP 서버가 새 도구를 추가하면 와일드카드는 사용자 지정 에이전트를 다시 구성하지 않고 자동으로 선택합니다. 개별 도구를 선택하면 정확한 제어가 됩니다. 와일드카드는 자동 적용 범위를 제공합니다.

MCP 도구가 아직 준비되지 않은 경우

에이전트가 시작될 때 MCP 서버가 준비되지 않은 경우 에이전트는 해당 서버의 도구에 액세스할 수 없습니다. 에이전트가 이 조건을 정상적으로 처리합니다. 해결되지 않은 와일드카드나 누락된 도구로 인해 사용자 지정 에이전트의 로드를 연기하고, 에이전트가 MCP 연결을 수립하면 자동으로 로드합니다. 수동 작업을 수행할 필요가 없습니다.

자세한 내용은 사용자 지정 에이전트를 참조하세요.

다음 단계:

관련 콘텐츠