Azure SRE 에이전트의 사용자 지정 에이전트

사용자 지정 에이전트는 요청 시 호출하는 전문 에이전트입니다. 채팅에 입력 /agent 하고, 전문가를 선택하고, 질문을 합니다. 이 프로세스를 통해 SQL 문제에 대한 데이터베이스 전문가와 위협 조사를 위한 보안 감사자에게 액세스할 수 있습니다.

항상 사용할 수 있는 기술과 달리 사용자 지정 에이전트에는 명시적 호출이 필요합니다. 이 요구 사항은 전문 지식을 특정 작업으로 범위 지정합니다.

트리거 및 도구에 연결된 사용자 지정 에이전트를 보여 주는 에이전트 캔버스의 스크린샷

사용자 지정 에이전트의 작동 방식

채팅에서 슬래시 명령을 사용하여 사용자 지정 에이전트를 /agent 호출합니다. 사용자 지정 에이전트는 전체 대화 컨텍스트를 수신하고 집중된 전문 지식을 사용합니다.

다음 예제에서는 기본 사용자 지정 에이전트 정의를 보여줍니다.

name: database_expert
system_prompt: |
  You are a database specialist. Analyze query performance,
  diagnose connection issues, and recommend optimizations.
handoff_description: Handles SQL and database troubleshooting
tools:
  - execute_kusto_query
  - azure_cli
connectors:
  - azure_sql
enable_skills: true  # Can use skills for additional expertise

주요 속성은 다음과 같습니다.

  • system_prompt: 전문가 역할 및 지침.
  • handoff_description: 위임을 결정할 때 오케스트레이터가 보는 내용입니다.
  • tools: 사용 가능한 기능입니다.
  • enable_skills: 이 속성을 사용하면 사용자 지정 에이전트가 동적으로 기술에 액세스할 수 있습니다.

팁 (조언)

기술은 자동입니다. 에이전트는 관련 있을 때마다 그것들을 사용합니다. 사용자 지정 에이전트는 명시적입니다 . 집중된 전문 지식이 필요할 때 사용하여 /agent 호출합니다.

사용자 지정 에이전트를 사용하는 이유

사용자 지정 에이전트를 사용하면 다시 사용할 수 있도록 도메인 전문 지식, 도구 및 지식을 패키지할 수 있습니다. 주 에이전트가 모든 것을 처리하는 대신 전문가에게 위임합니다.

데이터베이스 문제를 고려합니다. 사용자 지정 에이전트가 없으면 주 에이전트가 일반 문제 해결을 시도합니다. "데이터베이스 전문가" 사용자 지정 에이전트를 사용하면 쿼리 분석을 위해 집중된 SQL 전문 지식, 데이터베이스별 Runbook 및 도구를 얻을 수 있습니다.

또한 사용자 지정 에이전트는 핸드오프 체인을 사용하도록 설정합니다. 인시던트 심사 사용자 정의 에이전트는 문제를 분류하여 적절한 도메인 전문가에게 넘기고, 조사를 거쳐 알림 라우터로 넘깁니다. 각 단계는 특수화되어 있습니다.

사용자 지정 에이전트 만들기

Builder > Agent Canvas에서 사용자 지정 에이전트를 만듭니다.

  1. Azure Portal에서 Azure SRE 에이전트로 이동합니다.

  2. 에이전트 캔버스 탭을 선택합니다.

  3. 선택하고생성합니다.

  4. 사용자 지정 에이전트를 선택합니다.

  5. 다음 설정에 대한 값을 제공합니다.

    재산 가치
    이름 사용자 지정 에이전트의 설명이 포함된 이름을 입력합니다.
    지시 사용자 지정 에이전트의 동작 방식을 정의하는 명확한 사용자 지정 지침을 제공합니다.
    전환 설명서 다른 사용자 지정 에이전트가 이 사용자 지정 에이전트로 처리를 전송해야 하는 시나리오와 그 이유를 설명합니다.
    사용자 지정 도구(선택 사항) 작업 중에 사용할 사용자 지정 에이전트에 대해 하나 이상의 사용자 지정 도구를 선택합니다.
    기본 제공 도구(선택 사항) 사용자 지정 에이전트에 액세스할 기본 제공 시스템 도구를 선택합니다.
    핸드오프 에이전트(선택 사항) 이 사용자 지정 에이전트가 작업을 완료한 후 처리를 인수할 사용자 지정 에이전트를 지정합니다.

    필요에 따라 기술 자료 기능을 사용하도록 설정할 수 있습니다. 이 옵션을 사용하면 쿼리에 응답할 때 사용자 지정 에이전트가 참조 자료로 사용할 수 있는 파일을 업로드할 수 있습니다.

기술 자료 관리

설명서, Runbook 및 절차 가이드를 업로드하여 사용자 지정 에이전트의 지식을 향상시킵니다.

에이전트에 추가할 수 있는 파일의 예:

  • 아키텍처 또는 시스템 디자인: 시스템 구성 요소 및 데이터 흐름을 설명하는 다이어그램 및 설명서입니다.
  • 문제 해결 가이드: 일반적인 문제 또는 되풀이 문제를 진단하고 해결하기 위한 단계별 지침입니다.
  • Runbook 및 SOP: 일상적인 작업, 유지 관리 및 인시던트 대응에 대한 자세한 워크플로입니다.
  • 인시던트 보고서 및 사후 분석: 근본 원인 분석 및 학습된 교훈을 포함하여 과거 중단에 대한 설명서입니다.
  • 릴리스 정보 및 변경 로그: 새 기능, 버그 수정 및 변경 내용을 포함한 제품 또는 서비스 업데이트 요약입니다.

지원되는 파일 형식

Markdown() 또는 텍스트.md(.txt) 형식의 운영 프로시저입니다.

파일 관리 워크플로

  1. 기술 자료 파일 설정 > 탭으로 이동하여 기술 > 자료에 액세스합니다.
  2. 파일을 끌어 놓거나 파일 탐색을 통해 업로드하세요(파일당 최대 50MB).
  3. 더 나은 검색을 위해 태그 및 설명을 추가하여 콘텐츠를 구성합니다.
  4. 특정 기술 자료에 액세스할 수 있는 사용자 지정 에이전트를 구성하여 사용자 지정 에이전트 액세스를 사용하도록 설정합니다.
  5. 사용자 지정 에이전트가 응답에 업로드된 지식을 사용하는 방법을 추적하여 사용량을 모니터링합니다.

메모

사용자 지정 에이전트는 자동으로 인덱싱하고 업로드한 파일을 검색할 수 있도록 합니다. 시스템은 사용자 지정 에이전트 인스턴스당 최대 1,000개의 파일을 지원합니다.

에이전트 캔버스 보기

작성기에이전트 캔버스에서 사용자 지정>를 빌드합니다. 다음 보기를 사용할 수 있습니다.

보기 Purpose
캔버스 보기 사용자 지정 에이전트, 도구 및 트리거 연결을 보여 주는 시각적 다이어그램
테이블 보기 빠른 액세스가 있는 모든 사용자 지정 에이전트 목록
테스트 플레이그라운드 대화형 테스트 환경

사용자 지정 에이전트를 사용하는 경우

다음 표에서는 사용자 지정 에이전트가 올바른 선택인지 확인하는 데 도움이 됩니다.

시나리오 사용자 지정 에이전트를 사용하시겠습니까? 왜
필요한 심층 도메인 전문 지식 예 패키지 SQL 전문 지식, 네트워킹 지식, 보안 모범 사례
다단계 워크플로 예 인시던트 심사, 배포 유효성 검사, 백업 확인
특수 도구 집합 예 데이터베이스별 도구, 비용 최적화 도구
간단한 단일 작업 No 간단하고 반복 가능한 작업을 위해 기술을 대신 사용하세요.
읽기 전용 쿼리 No 기본 에이전트는 위임 없이 처리할 수 있습니다.

전체 사용자 지정 에이전트 설정은 응답 자동화에 대한 인시던트 응답을 참조하세요.

사용자 정의 상담원 이관

주 에이전트가 사용자 지정 에이전트에 전달하는 경우 단일 대화 컨텍스트를 공유합니다. 수신 사용자 지정 에이전트는 다음을 확인합니다.

  • 전체 대화 기록: 모든 이전 메시지, 도구 호출 및 결과입니다.
  • 하위 작업 추론: 핸드오프에서 이 사용자 지정 에이전트에 수행할 작업을 요청하는 내용입니다.
  • 사용자의 원래 질문: 핸드오프 체인 전체에서 유지됩니다.

메모

커스텀 에이전트는 "처음부터 다시 시작"을 할 수 없습니다. 동일한 대화 스레드를 계속 유지합니다. 이 방법을 사용하면 각 전문가가 이전 에이전트의 작업을 기반으로 하는 핸드오프 체인을 사용할 수 있습니다.

작업을 완료한 후 사용자 지정 에이전트는 다음 에이전트로 전달하거나 컨트롤을 오케스트레이터에 반환합니다. 대화 컨텍스트는 체인 전체에 걸쳐 계속 누적됩니다.

사용자 지정 에이전트 패턴

다음 표에서는 일반적인 사용자 지정 에이전트 패턴을 설명합니다.

패턴 예제 사용 사례
도메인 전문가 VM 전문가, AKS 전문가, 네트워크 전문가 한 기술에 대한 심층적인 전문 지식(모든 VM 문제, Kubernetes 문제 해결, VNet/NSG/부하 분산 장치)
작업 전문가 로그 분석기, 비용 최적화 도구, 보안 스캐너 특정 작업에 집중(로그 구문 분석, 절감액 찾기, 취약성 식별)
워크플로 실행기 인시던트 심사, 배포 유효성 검사기, 백업 검증 도구 다단계 절차(인시던트 분류, 배포 후 검사, 백업 무결성 테스트)

기술, 사용자 지정 에이전트 및 지식 파일 비교

다음 표에서는 각 확장성 개념을 비교합니다.

특징 기술 사용자 지정 에이전트 지식 파일
Access 자동 /agent 명령 KB 쿼리 도구를 통해
Tools 연결할 수 있습니다. 도구가 있습니다. 도구 없음
컨텍스트 스레드 컨텍스트 사용 스레드 컨텍스트 공유 참조 전용
적합한 대상 Procedures 도메인 전문가 Runbook, 문서

다음 지침을 사용하여 올바른 방법을 선택합니다.

  • 기술: 선택적 실행을 사용하는 팀 차원의 절차(AKS 문제 해결 가이드 + Azure CLI)
  • 사용자 지정 에이전트: 요청 시 호출된 범위 지정 전문가(PostgreSQL 전문가)
  • 지식 파일: 컨텍스트에 대한 참조 콘텐츠(아키텍처 문서)

트리거에 사용자 지정 에이전트 연결

인시던트 또는 예약된 작업은 사용자 지정 에이전트를 자동으로 트리거할 수 있습니다. 캔버스 보기는 이러한 연결을 시각적으로 보여 줍니다. 트리거는 사용자 지정 에이전트에 연결된 노드로 표시되고, 도구는 부모 사용자 지정 에이전트로 그룹화되고, 상태 배지는 활성 또는 비활성 상태를 표시합니다.

설정 세부 정보는 사용자 지정 에이전트를 사고에 연결하기 위한 사고 대응 또는 반복 자동화를 위한 예약된 작업을 참조하세요.

사용자 지정 에이전트 모드

각 사용자 지정 에이전트는 자율성의 정도를 설정하는 모드에서 실행됩니다. 각 응답 계획 또는 예약된 작업에 대한 모드를 설정합니다.

모드 설명
리뷰 작업 제안, 승인 대기
자율 사람의 승인 없이 행동

위험에 따라 모드를 선택합니다.

  • 비용 최적화 권장 사항 검토(사용자 승인 필요)를 사용합니다.
  • 잘 테스트된 자동화? 자율(신뢰할 수 있는 작업)을 사용합니다.

각 응답 계획 또는 예약된 작업에 대한 모드를 구성합니다. 사용자 지정 에이전트 YAML 정의에서 모드를 설정하지 마세요. 자세한 내용은 실행 모드를 참조하세요.

사용자 지정 에이전트 테스트 및 개발

배포하기 전에 테스트 플레이그 라운드에서 사용자 지정 에이전트를 테스트합니다. 빌더>에이전트 캔버스로 이동하여 보기 전환에서 테스트 플레이그라운드를 선택합니다. 분할 화면 레이아웃을 사용하면 왼쪽의 지침을 편집하고 오른쪽의 라이브 채팅에서 테스트할 수 있으며, AI 기반 평가를 통해 구성 점수를 매깁니다.

VS Code 사용자의 경우 SRE 에이전트 MCP 서버 확장을 사용하면 편집기에서 변경 내용이 에이전트와 동기화되는 사용자 지정 에이전트 YAML을 편집할 수 있습니다.

분할 화면 편집기 및 채팅 테스트 패널이 있는 에이전트 플레이그라운드의 스크린샷

자세한 내용은 에이전트 플레이그라운드를 참조하세요.

관련 콘텐츠

Resource 설명
기술 에이전트에 대한 재사용 가능한 절차 및 도구
알림 보내기 Teams, Outlook 등에 조사 결과 보내기
도구를 통해 채팅 Teams, 웹후크 등에서 에이전트와 상호 작용
  • Last updated on