이 자습서에서는 에이전트에 도메인 지식 및 작업 플레이북을 추가하는 사용자 지정 기술을 만듭니다. 기술은 특정 서비스 문제 해결 또는 진단 절차 실행과 같이 관련될 때 에이전트가 자동으로 로드하는 모듈식 기능입니다.
이 튜토리얼에서는 다음을 배우게 됩니다:
- 스바젠트 작성기에서 기술 만들기
- SKILL.md 기술 지침 작성
- 지원 파일 및 도구 추가
- 채팅 또는 놀이터에서 기술 테스트
- 기존 기술 편집
예상 시간: 10분
팁 (조언)
기술 및 지식 문서는 함께 작동합니다. 기술은 에이전트에게 작업을 수행하는 방법(절차, 플레이북, 단계별 지침)을 가르칩니다. 지식 문서는 에이전트가 알아야 할 사항(참조 데이터, 아키텍처 문서, Runbook)을 설명합니다. 지원 파일로 기술에 직접 참조 문서를 첨부할 수도 있습니다. 지식 업로드 흐름은 기술 문서 업로드를 참조하세요.
사전 요구 사항
시작하기 전에 다음 필수 조건을 갖추고 있는지 확인합니다.
- Azure SRE 에이전트 포털에서 만든 에이전트입니다.
- 인코딩하려는 프로시저 또는 도메인 지식을 명확하게 이해합니다.
서브에이전트 빌더로 이동합니다.
기술을 만들고 관리하는 스바겐트 작성기를 엽니다.
- SRE 에이전트 포털을 엽니다.
- 에이전트를 선택하세요.
- 왼쪽 네비게이션에서 Builder를 선택합니다.
- 스바겐트 빌더를 선택합니다.
기술 만들기 시작
도구 모음에서 기술 만들기 프로세스를 시작합니다.
- 도구 모음에서 만들기 드롭다운을 선택합니다.
- 기술을 선택합니다.
기술 만들기 대화 상자가 2열 레이아웃으로 열립니다. 한쪽에는 양식 필드가 있고 다른 쪽에는 코드 편집기가 표시됩니다 SKILL.md.
이름 및 설명 입력
에이전트가 이 기술을 사용할 시기를 결정하는 데 도움이 되는 이름과 설명을 제공합니다.
| 분야 | 예제 값 |
|---|---|
| 이름 | high-cpu-troubleshooting |
| 설명 | "컨테이너 앱에서 높은 CPU 경고에 대한 문제 해결 절차입니다. 업스트림 종속성, 연결 풀 및 최근 배포를 확인합니다." |
이름은 귀하의 모든 기술에서 고유해야 합니다. 설명은 기술 목록에 표시되며 에이전트가 이 기술을 사용할 시기를 결정하는 데 도움이 됩니다.
팁 (조언)
설명 텍스트 옆에 있는 편집 을 선택하여 편집 모드로 전환합니다. 완료되면 저장을 선택합니다.
기술 지침 작성
가운데 편집기는 SKILL.md 기술의 지침을 포함하고 있음을 보여줍니다. 파일은 기본 템플릿으로 시작합니다.
---
name:
description:
---
<!-- Add your skill instructions here -->
YAML 프런트 매터(name, description, tools)는 왼쪽의 양식 필드와 동기화된 상태로 유지됩니다. Markdown에서 앞의 문제 아래에 지침을 작성합니다.
---
name: high-cpu-troubleshooting
description: Troubleshooting procedure for high CPU alerts on container apps
tools:
- kusto_query
---
## When to use this skill
Use this skill when you receive a high CPU alert on any container app.
## Steps
1. Check upstream dependencies for cascading failures
2. Query connection pool metrics for the last hour
3. Review deployments in the last 24 hours
4. If a recent deployment correlates with CPU spike, identify the commit
5. Recommend rollback or fix based on findings
## Expected output
Structured report with: affected resource, root cause, recommended action, and evidence.
지원 파일 추가
한쪽의 파일 섹션에는 파일 브라우저가 표시됩니다. 기본값 SKILL.md외에도 참조 데이터, 템플릿 및 예제 쿼리를 추가할 수 있습니다.
- 새 파일 아이콘을 선택하여 파일을 추가합니다.
- 새 폴더 아이콘을 선택하여 파일을 디렉터리로 구성합니다.
- 폴더를 끌어 놓기 영역으로 끌어다 놓거나 폴더 업로드 링크를 선택하여 전체 폴더 구조를 업로드합니다.
브라우저에서 파일을 선택하여 코드 편집기에서 편집합니다. 편집기에서는 Markdown, JSON, YAML, KQL, Python 및 셸 스크립트에 대한 구문 강조 표시를 지원합니다.
도구 선택
필요에 따라 실행 중에 기술이 사용하는 도구를 연결합니다.
- 도구 섹션에서 도구 선택을 선택합니다.
- 도구를 찾아보거나 검색합니다. 형식별로 필터링(사용자 지정 도구, MCP 도구) 또는 이름으로 검색합니다.
- 이 기술에 필요한 도구(예:
kusto_query또는azure_resource_health)를 확인합니다. - 패널을 닫습니다.
선택한 도구는 제거할 수 있는 알약 형태로 표시됩니다. 이러한 도구는 기술이 활성화될 때 동적으로 사용할 수 있습니다.
메모
기술에 추가된 도구는 기술이 활성화될 때 동적으로 사용할 수 있습니다. 보다 일관된 동작을 위해 도구를 서브에이전트에서 직접 구성하십시오.
사용자 지정 도구를 만들려면 Kusto 도구 만들기 또는 Python 도구 만들기를 참조하세요. 도구에 대한 자세한 내용은 도구를 참조 하세요.
스킬 생성
만들기를 선택하여 기술을 저장합니다.
당신의 기술은 스바겐트 작성기에서 기술 탭에 나타납니다. 이제 에이전트는 관련 상황이 발생할 때 자동으로 기술을 사용할 수 있습니다.
기술 테스트
주 에이전트는 기본적으로 기술을 사용할 수 있으므로 먼저 스바겐트를 만들지 않고 채팅에서 직접 테스트할 수 있습니다.
새 채팅에서 테스트
새 채팅 스레드를 사용하여 에이전트가 기술을 활성화했는지 확인합니다.
- 사이드바에서 새 채팅 스레드 를 선택합니다.
- 기능을 작동시키기 위한 프롬프트를 입력하세요. 예를 들어, "저희 컨테이너 앱에서 높은 CPU 사용이 관찰되고 있습니다. 조사해 주실 수 있나요?"
- 에이전트가 기술을 활성화하고 정의한 절차를 따르는지 확인합니다.
놀이터에서 테스트
놀이터를 사용하여 하위 에이전트를 통해 기술을 테스트합니다.
- 서브에이전트를 생성하고 해당 기술을 할당합니다.
- 스바겐트 작성기 도구 모음에서 테스트 플레이그라운드 보기 토글을 선택합니다.
- 하위 에이전트를 선택하고, 테스트 프롬프트를 입력하고, 스킬을 올바르게 사용하는지 확인합니다.
자세한 내용은 에이전트 플레이그라운드를 참조하세요.
스킬 편집
기존 기술을 수정하여 지침, 도구 또는 지원 파일을 업데이트할 수 있습니다.
기술 탭에서 기술 이름을 선택하거나 선택하고 편집을 선택합니다.
편집 대화 상자가 열리고 모든 현재 값이 미리 채워진 상태로 열립니다. 필요한 필드를 변경합니다.
변경할 내용 업데이트할 위치 에이전트가 사용하는 경우 설명 및 SKILL.md 지침 따라야 할 절차 SKILL.md 콘텐츠 편집기에서 사용할 수 있는 도구 도구> 도구 선택 참조 데이터 파일> 파일 추가, 편집 또는 제거 저장을 선택합니다.
효과적인 기술을 작성하기 위한 팁
다음 지침을 사용하여 에이전트가 효과적으로 사용할 수 있는 기술을 만듭니다.
- 사용 시기에 대해 구체적으로 설명합니다. 에이전트는 설명 및 지침을 읽고 관련성을 결정합니다.
- 단계별 프로시저를 포함합니다. 번호가 매겨진 단계는 에이전트에게 명확한 플레이북을 제공합니다.
- 예상 출력을 지정합니다. 에이전트에게 결과 형식을 알려주세요.
- 참조 데이터를 추가합니다. 쿼리 템플릿, 구성 기준 또는 알려진 정상 값을 지원 파일로 업로드합니다.
- 관련 도구를 할당합니다. 기술에 Kusto 쿼리 또는 Azure 작업과 같은 특정 도구가 필요한 경우 추가합니다.