이 자습서에서는 자체 지침, 도구 및 기술을 사용하여 스바겐트 작성기에서 특수한 스바겐트를 만듭니다. Subagent는 상태 보고, 경고 심사 또는 알림 배달과 같은 포커스가 있는 작업을 처리합니다. 스바겐트의 작동 방식에 대한 자세한 내용은 스바겐트를 참조하세요.
예상 시간: 5분
이 튜토리얼에서는 다음을 배우게 됩니다:
- 스바겐트 작성기에서 사용자 지정 지침이 포함된 스바겐트 만들기
- 기술, 도구 및 후크를 스바젠트에게 할당
- 대화 상자와 플레이그라운드에서 서브에이전트를 테스트하세요.
- 양식 또는 YAML을 사용하여 스바겐트 구성 편집 및 관리
사전 요구 사항
- Azure SRE 에이전트 포털에서 만든 에이전트입니다.
- 스바겐트가 외부 도구를 사용하도록 하려면 하나 이상의 커넥터가 구성되었습니다.
서브에이전트 만들기
포털에서 새 스바겐트를 만들려면 다음 단계를 수행합니다.
SRE 에이전트 포털을 열고 에이전트를 선택합니다.
Builder>Subagent Builder를 선택합니다.
도구 모음에서 만들기 드롭다운을 선택한 다음 사용자 지정 에이전트를 선택합니다.
만들기 대화 상자는 폼 과 YAML이라는 두 개의 탭으로 열립니다.
필수 필드를 입력합니다.
분야 예제 값 사용자 지정 에이전트 이름 (필수) health-check-reporter지침 (필수) "당신은 건강 검사 기자입니다. 프로덕션 리소스 그룹의 컨테이너 앱에 대한 Azure 리소스 상태를 확인합니다. 정상, 경고, 심각 상태의 수를 요약합니다. 전자 메일을 통해 요약을 보냅니다." 팁 (조언)
지침 필드 위에 있는 AI로 구체화 를 선택하여 에이전트가 자동으로 지침을 개선할 수 있도록 합니다. AI 제안 보기를 선택하여 지침, 도구 및 기술 향상을 위한 권장 사항을 확인합니다.
(선택 사항) 대화 상자에서 나머지 섹션을 구성합니다. 이러한 섹션을 건너뛰면 서브에이전트는 기본적으로 모든 전역 기술과 도구를 상속합니다.
기술: 기술 선택을 선택하고 특정 기술을 서브에이전트에게 할당합니다. 특정 기술을 선택하면 전역 기본값이 새로 설정됩니다. 모든 전역 기술을 허용하려면 선택 영역을 비워 둡니다. 자세한 내용은 기술을 참조하세요.
도구: 도구 선택 패널을 열려면 도구 선택을 선택합니다. 범주별로 구성된 도구(예: Kusto 도구 또는 알림 도구)를 찾아보거나 검색합니다. 하위 에이전트에서 사용할 도구를 선택합니다. 사용자 지정 도구를 먼저 만들려면 Kusto 도구 만들기 또는 Python 도구 만들기를 참조하세요. 자세한 내용은 도구를 참조하세요.
후크: 후크 관리를 선택하여 안전 및 거버넌스 컨트롤을 추가합니다. 후크는 작업(프롬프트 후크) 또는 도구 사용 후(명령 후크) 전에 실행됩니다. 설정 단계는 포털에서 후크 만들기 및 관리를 참조하세요. 자세한 내용은 에이전트 후크를 참조하세요.
선택하고생성합니다.
연결된 도구를 포함한 서브에이전트는 서브에이전트 작성기 캔버스에서 노드로 표시됩니다.
팁 (조언)
도구를 할당하기 전에 테스트 플레이그라운드에서 개별적으로 테스트하여 예상한 데이터를 반환하는지 확인합니다.
하위 에이전트를 테스트하세요.
스바겐트를 만든 후 테스트하여 예상대로 작동하는지 확인합니다.
대화 상자에서 테스트
만들기 또는 편집 대화 상자에서 오른쪽 위 모서리에 있는 테스트 아이콘을 선택하여 테스트 라이브 에이전트 패널을 엽니다. 프롬프트를 입력하고 현재 지침 및 도구를 사용하여 스바겐트가 어떻게 응답하는지 확인합니다.
놀이터에서 테스트
분할 화면 레이아웃을 사용하여 대화형 테스트 환경을 위한 플레이그라운드를 사용합니다.
- 스바겐트 작성기 도구 모음에서 테스트 플레이그라운드 보기 토글을 선택합니다.
- 분할 화면 레이아웃은 한 쪽에 스바겐트의 구성을 표시하고 다른 쪽에는 라이브 채팅을 표시합니다.
- 하위 에이전트를 선택하고, 테스트 프롬프트를 입력한 후, 그것이 예상대로 작동하는지 확인합니다.
- 지침을 편집하거나 도구를 교환하여 반복한 다음 출력이 예상과 일치할 때까지 다시 테스트합니다.
자세한 내용은 에이전트 플레이그라운드 또는 플레이그라운드의 도구 테스트를 참조하세요.
하위 에이전트를 편집
기존 스바젠트를 수정하려면 스바겐트 작성기 캔버스에서 해당 구성을 엽니다.
하위 노드를 선택한 다음 편집 을 선택하거나 노드를 두 번 클릭합니다. 편집 대화 상자가 열리고 모든 현재 값이 미리 채워진 상태로 열립니다.
| 변경할 내용 | 업데이트할 필드 |
|---|---|
| 용도 | 지침 |
| 어떤 기술을 사용하는가? | 기술> 기술 선택 |
| 어떤 도구를 사용하는지 | 도구> 도구 선택 |
| 안전 제어 | 후크> 후크 관리 |
완료되면 저장을 선택합니다.
YAML을 사용하여 편집
구성을 복사하거나 구성을 코드로 관리하기 위한 YAML로 스바겐트의 구성을 보거나 편집할 수 있습니다.
만들기 또는 편집 대화 상자 맨 위에 있는 YAML 탭을 선택하여 YAML 모드로 전환합니다. YAML 모드의 변경 내용은 양식 보기로 다시 동기화됩니다.