Microsoft Foundry의 에이전트 개발 수명 주기는 초기 생성부터 프로덕션 모니터링까지입니다. 이 수명 주기에 따라 신뢰할 수 있는 에이전트를 빌드하고, 문제를 조기에 파악하고, 자신 있는 방식으로 배송할 수 있습니다. Foundry 포털 또는 코드를 사용하여 에이전트의 동작을 빌드, 사용자 지정 및 테스트합니다. 그런 다음 추적, 평가 및 모니터링을 반복하여 품질과 안정성을 향상시킵니다. 준비가 되면 에이전트 애플리케이션으로 에이전트를 게시하여 공유하고 앱에 통합합니다.
이 문서는 프로덕션 준비 에이전트를 빌드, 테스트 및 배송하려는 개발자를 위한 것입니다.
필수 조건
- Microsoft Foundry 프로젝트
- 에이전트 플레이그라운드에 대한 친숙함
- 코드 개발: 개발 환경 설정에 대한 숙지
수명 주기 한눈에 보기
에이전트를 빌드하고 배송하는 동안 이 수명 주기를 실제 검사 목록으로 사용합니다.
- 에이전트 유형 선택: 프롬프트 기반 에이전트, 워크플로 또는 호스트된 에이전트로 시작합니다.
- 에이전트를 만들고 테스트를 시작합니다. 플레이그라운드 또는 코드에서 반복합니다.
- 도구 및 데이터 추가: 검색 및 작업을 위한 도구를 연결하고 저장하기 전에 구성의 유효성을 검사합니다.
- 변경 내용을 버전으로 저장: 의미 있는 중요 시점을 캡처하고 버전을 비교합니다.
- 추적을 사용하여 디버그: 추적을 사용하여 도구 호출, 대기 시간 및 엔드투엔드 동작을 확인합니다. 자세한 내용은 에이전트 추적 개요를 참조하세요.
- 품질 및 안전성 평가: 게시하기 전에 반복 가능한 평가를 실행하여 회귀를 catch합니다. 개념 지침은 에이전트 평가자를 참조하세요.
- 게시 및 통합: 안정적인 엔드포인트를 게시하고 애플리케이션에 통합합니다. 단계는 Microsoft Foundry에서 에이전트 게시 및 공유를 참조하세요.
- 모니터링 및 반복: 프로덕션 환경에서 성능 및 품질을 모니터링한 다음 필요에 따라 업데이트하고 다시 게시합니다. 지침은 품질 및 안전 모니터링을 참조하세요.
Microsoft Foundry의 에이전트 유형
다음과 같은 세 가지 유형의 에이전트가 있습니다.
프롬프트 기반: 프롬프트 기반 에이전트는 모델 구성, 지침, 도구 및 자연어 프롬프트를 결합하여 동작을 구동하는 선언적으로 정의된 단일 에이전트입니다. 지식 및 메모리용 도구를 연결하여 확장합니다. Foundry 포털의 에이전트 플레이그라운드 에서 프롬프트 기반 에이전트를 편집, 버전 관리, 테스트, 평가, 모니터링 및 게시합니다.
워크플로: 워크플로를 사용하여 작업 시퀀스를 오케스트레이션하거나 여러 에이전트를 조정하는 고급 워크플로를 빌드합니다. 워크플로에는 포털에 고유한 인터페이스가 있지만 동일한 수명 주기가 적용됩니다. 자세한 내용은 Microsoft Foundry에서 워크플로 빌드를 참조하세요.
호스트됨(미리 보기): 호스트된 에이전트는 지원되는 프레임워크 또는 사용자 지정 코드를 사용하여 코드에서 빌드하는 컨테이너화된 에이전트입니다. Foundry 에이전트 서비스는 이러한 에이전트를 배포하고 관리합니다. 에이전트 빌드 UI에서 호스트된 에이전트를 편집하지는 않지만 여전히 호출, 평가, 모니터링 및 게시할 수 있습니다. 자세한 내용은 호스트된 에이전트란?을 참조하세요.
CLI, SDK 또는 REST API를 사용하여 Foundry 포털 또는 사용자 고유의 개발 환경에서 프롬프트 기반 에이전트 및 워크플로를 만듭니다. 자세한 내용은 빠른 시작을 참조하세요.
프롬프트 기반 에이전트 만들기
만들려는 에이전트 종류를 이미 알고 있는 경우 이름을 지정한 다음 해당 모델 지침 및 도구 구성을 시작합니다.
비고
에이전트 이름을 지정한 후에는 이름을 변경할 수 없습니다. 코드에서 에이전트를 <agent_name>:<version>로 참조합니다.
코드에서 에이전트 개발
코드에서 작업하려는 경우 지원되는 방법을 사용하여 로컬로 테스트한 다음 Azure에 배포할 수 있는 개발 환경으로 에이전트 코드를 가져옵니다.
에이전트 플레이그라운드의 채팅 창에 있는 코드 탭에서 에이전트를 참조하는 코드 조각을 웹 클라우드 환경에 대한 전용 Visual Studio Code로 가져올 수 있습니다. 코드 조각은 필요한 패키지 및 확장과 함께 Foundry 에이전트를 효율적으로 개발하고 Azure에 배포하는 지침과 함께 미리 구성됩니다. 코드 조각을 기본 설정 개발 환경에 직접 복사할 수도 있습니다. 자세한 내용은 플레이그라운드 설명서를 참조하세요.
에이전트 개발 수명 주기에 대한 핵심 기능
에이전트 빌드 환경은 에이전트 개발 수명 주기의 각 핵심 단계에 대한 통합 환경을 제공합니다. 프로덕션 준비 에이전트 애플리케이션을 개발할 때 이러한 핵심 기능을 사용합니다. 각 기능에는 자세히 알아볼 수 있는 자세한 설명서가 있습니다.
변경 내용을 버전으로 저장
프롬프트 기반 에이전트 또는 워크플로의 첫 번째 버전을 만든 후 후속 변경 내용을 새 버전으로 저장합니다. 에이전트 플레이그라운드에서 저장되지 않은 변경 내용을 테스트할 수 있습니다. 그러나 대화 기록을 보거나 에이전트의 성능을 모니터링하거나 전체 평가를 실행하려면 변경 내용을 저장해야 합니다.
에이전트 버전 관리는 에이전트 구성 및 반복을 관리하기 위한 다음 기능을 제공합니다. 이 시스템은 모든 변경 내용을 추적, 테스트 가능 및 버전 간에 비교할 수 있도록 합니다.
버전 불변성: 에이전트를 저장한 후에는 각 버전의 에이전트를 변경할 수 없습니다. 기존 버전을 수정하려면 새 버전을 저장하고 만들어야 합니다. 이 요구 사항은 버전 무결성을 보장하고 우발적인 덮어쓰기를 방지하는 데 도움이 됩니다.
초안 상태 관리: 저장되지 않은 상태에서 에이전트를 테스트하여 실험을 수행할 수 있습니다. Foundry 포털에서 나가면 저장되지 않은 변경 내용이 손실되므로 자주 저장하여 중요한 수정 내용을 유지합니다.
버전 제어 작업: 특정 에이전트 버전으로 요청을 보내 제어된 배포 및 롤백 기능을 사용하도록 설정할 수 있습니다.
버전 기록 탐색: 에이전트의 버전 기록에 액세스하고 특정 버전으로 이동하여 다음 비교를 수행합니다.
비교 유형 Description 에이전트 설정 버전 드롭다운 목록을 사용하여 버전 간 구성 설정 비교 채팅 출력 동일한 입력을 사용하여 에이전트 버전 간의 응답 차이점 분석 YAML 정의 에이전트 정의의 차이점 검토
도구 추가
에이전트에 정보를 제공하거나(특정 파일 또는 인덱스) 작업을 수행하도록 허용하여(외부 API 호출) 에이전트를 더욱 강력하게 만듭니다. 도구는 간단한 파일 업로드에서 MCP(사용자 지정 모델 컨텍스트 프로토콜) 서버 연결에 이르기까지 대부분의 사용 사례에 사용할 수 있습니다. 더 복잡한 도구의 경우, 에이전트에 연결할 때 인증을 구성하거나 연결을 추가해야 할 수 있습니다.
도구가 연결된 에이전트를 저장하려면 도구를 성공적으로 구성해야 합니다. 에이전트에서 구성된 도구를 다시 사용합니다. 사용 가능한 도구에 대한 자세한 내용은 도구 카탈로그를 참조하세요.
추적을 사용하여 디버그 및 유효성 검사(미리 보기)
도구를 추가하고 프롬프트를 반복할 때 추적을 사용하여 엔드 투 엔드 동작의 유효성을 검사합니다.
- 에이전트가 예상한 도구를 호출했는지 확인합니다.
- 도구 입력 및 출력을 검사합니다.
- 모델 및 도구 호출에서 대기 시간 핫스팟을 식별합니다.
자세한 내용은 에이전트 추적 개요를 참조하세요.
품질 및 안전성 평가(미리 보기)
에이전트를 게시하기 전과 의미 있는 변경 후에는 평가를 실행하여 회귀를 찾아내고 버전 간에 일관되게 품질을 측정합니다.
- 에이전트에 대한 주요 평가 차원은 에이전트 평가자를 참조하세요.
- 자동화할 수 있는 코드 우선 워크플로는 AI 에이전트를 로컬로 평가하세요.
게시 후 모니터링
에이전트 애플리케이션을 게시한 후 프로덕션 소프트웨어처럼 처리합니다.
- 품질 및 안전 신호를 모니터링합니다.
- 동작이 변경되면 추적을 검토합니다.
- 문제를 해결하거나 개선할 때 업데이트하고 다시 게시합니다.
지침은 품질 및 안전 모니터링을 참조하세요.
ID 및 권한 계획
도구 및 다운스트림 리소스에는 인증이 필요한 경우가 많습니다. 에이전트를 게시하면 해당 ID 및 권한 모델이 변경됩니다. 게시된 에이전트가 필요한 액세스 권한만 갖추고 있는지 확인하십시오.
자세한 내용은 Microsoft Foundry의 에이전트 ID 개념을 참조하세요.
보안 및 액세스
에이전트 구성을 애플리케이션 코드와 같이 처리합니다. 수명 주기 동안 비밀 및 사용 권한을 보호합니다.
- 키를 포함하는 대신 최소 권한 및 역할 할당을 사용합니다. 자세한 내용은 Foundry 포털에서 역할 기반 액세스 제어를 참조하세요.
- 코드, 구성 파일 또는 프롬프트에서 하드 코딩하는 대신 관리되는 비밀 저장소에 비밀을 저장하고 연결을 통해 참조합니다. 지침은 Key Vault 연결 설정을 참조하세요.
- 게시하기 전에 게시된 에이전트 애플리케이션의 에이전트 ID 및 도구 연결에 필요한 액세스 권한만 있는지 확인합니다. 자세한 내용은 Microsoft Foundry의 에이전트 ID 개념을 참조하세요.
에이전트 또는 워크플로 게시
만족할만한 에이전트 또는 워크플로 버전을 만든 후 에이전트 애플리케이션으로 게시합니다. 브라우저에서 열고 테스트하거나, 다른 사용자와 공유하거나, 기존 애플리케이션에 포함할 수 있는 안정적인 엔드포인트를 얻을 수 있습니다. 사용자와 협력자는 성능의 유효성을 검사하고 구체화가 필요한 항목을 식별할 수 있습니다. 필요한 업데이트를 수행하고 언제든지 새 버전을 다시 게시합니다.
중요합니다
프로젝트 ID에 할당된 사용 권한은 게시된 에이전트로 자동으로 전송되지 않습니다. 게시한 후 필요한 권한을 에이전트 애플리케이션의 ID에 다시 할당합니다.
일반적인 에이전트 개발 문제
- 저장되지 않은 변경은 일시적입니다. 버전을 비교하거나 기록을 보거나 전체 평가를 실행하려면 변경 내용을 버전으로 저장합니다.
- 저장하기 전에 도구를 구성해야 합니다. 도구에 인증 또는 연결이 필요한 경우 저장하기 전에 설정을 완료합니다.
- 게시에는 권한 업데이트가 필요할 수 있습니다. 게시한 후 게시된 에이전트 ID에 대한 리소스 액세스를 다시 확인하고 에이전트에 더 이상 필요하지 않은 액세스를 제거합니다.
관련 콘텐츠
에이전트 유형에 대해 자세히 알아보세요.
에이전트 구성 및 확장:
에이전트 게시 및 모니터링:
디버그 및 평가: