Visual Studio Code Microsoft Foundry Toolkit에서 에이전트 작성기를 사용하여 프롬프트 에이전트의 모델, 지침 및 도구를 구성합니다. 플레이그라운드에서 에이전트를 테스트하고, 변경 내용을 버전으로 저장하고, 애플리케이션에서 호출하는 클라이언트 코드를 생성합니다.
이 문서는 Foundry에 저장된 프롬프트 에이전트로 시작합니다. 에이전트 작성기에서는 스토리지, 도구 및 평가 옵션이 서로 다른 로컬로 저장된 프롬프트도 지원합니다. 코드 기반 대안은 에이전트 만들기를 참조하세요.
사전 요구 사항
- Visual Studio Code Microsoft Foundry 도구 키트를 설치합니다.
- Foundry 프로젝트를 선택합니다. 에이전트를 만들고 프로젝트의 모델 및 도구를 사용할 수 있는 권한이 필요합니다. Foundry 역할 기반 액세스 제어를 참조하세요.
- 해당 프로젝트의 모델 배포입니다. Foundry 리소스 설정을 참조하세요.
Foundry 리소스를 사용하지 않는 한 로컬 프롬프트 개발에는 Foundry 프로젝트가 필요하지 않습니다.
프롬프트 에이전트 만들기
모델 및 지침으로 시작한 다음, 도구를 추가하기 전에 에이전트를 저장하고 테스트합니다.
Foundry 도구 키트 보기에서 개발자 도구>빌드>에이전트 만들기를 선택합니다.
에이전트 빌드를 선택하여 에이전트 작성기를 엽니다.
기본 정보에서 에이전트 이름을 입력합니다. 이름을 문자나 숫자로 시작하고 종료합니다. 그 사이에 하이픈을 사용할 수 있습니다.
모델에서 Foundry 호스팅 모델을 선택합니다. 모델을 추가해야 하는 경우 모델 찾아보 기를 사용합니다.
지침에서 작업, 필수 동작 및 예상 응답을 설명 합니다. 예를 들어 보고된 문제, 재현 단계 및 예상 동작을 식별하여 에이전트에 소프트웨어 문제를 요약하도록 요청합니다. 세부 정보를 발명하는 대신 누락된 정보를 요청하도록 지시합니다.
Foundry에 저장을 선택합니다.
플레이그라운드 탭에서 요청을 입력하고 메시지 보내기를 선택합니다. 후속 질문을 하여 대화를 테스트합니다.
응답이 지침을 따르는지 검토합니다. 필요에 따라 지침을 구체화하고 저장하고 반복합니다.
개발자 도구에서 Group by Resource를 사용하는 경우 에이전트 만들기 는 빌드 대신 에이전트 개발 도구 아래에 있습니다. 또 다른 경로는 내 리소스>에이전트>프롬프트 에이전트>프롬프트 에이전트 추가입니다. 해당 목록에서 기존 에이전트를 선택하여 편집합니다.
저장할 위치 선택
사용 가능한 저장 작업은 선택한 모델 및 도구에 따라 달라집니다.
| 구성 / 설정 | 대상 저장 |
|---|---|
| 도구가 없는 Foundry 호스팅 모델입니다. | Foundry에 저장, 저장 메뉴에서 로컬에 저장도 사용할 수 있습니다. |
| Foundry 도구를 사용하는 Foundry 호스팅 모델입니다. | Foundry에 저장합니다. |
| 다른 공급자의 모델 또는 로컬 도구가 있는 구성입니다. | 로컬에 저장합니다. |
Microsoft Foundry 및 로컬 배지는 에이전트가 저장되는 위치를 표시합니다. 로컬로 저장된 프롬프트는 여전히 클라우드 모델을 호출할 수 있습니다. 로컬 스토리지가 머신에서 유추가 실행된다는 의미는 아닙니다.
초안 및 버전 저장
에이전트 작성기에서 로컬 복구 초안을 저장된 에이전트 버전과 구분합니다.
| 조치 | Result |
|---|---|
| 구성을 편집합니다. | 에이전트 작성기에서 로컬 복구 초안을 저장합니다. 이 작업은 Foundry 버전을 만들지 않습니다. |
| 저장되지 않은 새 에이전트를 실행합니다. | 에이전트 작성기에서 에이전트 이름과 모델의 유효성을 검사하고 첫 번째 실행 전에 에이전트를 저장합니다. 구성에서 해당 대상을 지원하는 경우 Foundry를 선호합니다. |
| 저장된 Foundry 에이전트를 편집한 후 Foundry에 저장을 선택합니다. | 에이전트 작성기에서 구성을 프로젝트에 새 버전으로 저장합니다. |
에이전트 작성기에서 복구 초안을 찾으면 초안 복원 또는 취소를 선택합니다. 에이전트 또는 버전을 전환하기 전에 중요한 변경 내용을 명시적으로 저장합니다.
기존 Foundry 에이전트에 저장되지 않은 변경 내용을 테스트할 수 있습니다. 이 실행은 저장된 에이전트 버전 참조 대신 편집된 구성을 사용합니다. 버전 연결 대화, 추적 또는 생성된 클라이언트 코드에 의존하기 전에 저장합니다.
중요합니다
Foundry에 저장 하면 에이전트 버전이 저장됩니다. 안정적인 애플리케이션 엔드포인트를 사용하여 에이전트 애플리케이션을 게시하지 않습니다. 별도의 작업에 대해서는 에이전트 애플리케이션 게시를 참조하세요.
에이전트 버전 선택
에이전트 이름 옆에 있는 버전 선택기를 사용하여 저장된 버전을 로드합니다. Foundry 에이전트 버전은 변경할 수 없습니다. 이전 버전에서 편집한 내용을 유지하려면 Foundry에 저장을 선택하여 새 버전을 만듭니다.
선택한 버전은 에이전트 작성기에서 표시된 대화 기록과 생성된 클라이언트 코드에서 참조하는 버전을 결정합니다. 서비스 버전 관리 세부 정보는 변경 내용을 버전으로 저장을 참조하세요.
Foundry 에이전트에 도구 추가
도구는 에이전트를 모델 외부의 정보 및 작업에 연결합니다. 사용 가능한 도구는 프로젝트의 모델, 사용 권한 및 리소스에 따라 달라집니다. 도구 카탈로그를 사용하여 공유 연결 및 인증을 구성한 다음 에이전트 작성기에서 연결합니다.
- 플레이그라운드 탭에서 저장된 Foundry 에이전트를 엽니다.
- 도구에서 도구 추가를 선택합니다+>.
- 도구 선택에서 구성된 연결을 선택하거나 카탈로그를 사용하여 도구를 찾습니다.
- 필요한 구성을 완료한 다음 도구 추가를 선택합니다.
- Foundry에 저장을 선택합니다.
- 도구가 필요한 요청을 보내고 해당 입력 및 결과를 검토합니다. 에이전트가 승인을 요청하는 경우 해당 호출에 대해 승인 또는 거부 를 선택합니다.
MCP 도구에 대한 도구 호출 승인 설정을 검토하려면 해당 옵션을 열고 구성을 선택합니다. 승인을 요구하거나, 모든 도구를 자동으로 승인하거나, 특정 도구를 자동으로 승인할 수 있습니다. 저장하기 전에 선택 사항을 검토합니다.
승인 설정은 기본 서비스에 대한 액세스 권한을 부여하지 않습니다. 서비스 권한은 에이전트 ID 개념을 참조하세요.
도구 상자 사용(미리 보기)
도구 상자는 관리형 MCP 엔드포인트 뒤에 재사용 가능한 도구를 그룹화합니다. 기술 및 도구 검색은 미리 보기 기능입니다.
메모
프롬프트 에이전트의 도구 상자 통합은 기본적으로 미리 보기 및 해제되어 있습니다.
Visual Studio Code 설정에서 도구 상자 첨부 파일 컨트롤을 표시하도록 설정합니다windowsaistudio.enableToolboxInPromptAgent.
에이전트는 도구 상자 또는 개별 Foundry 도구를 사용합니다. 도구상자를 첨부하면 개별 도구를 대체합니다. 도구 상자가 연결된 상태에서 도구 추가 는 해당 도구 상자 내에 도구를 추가합니다.
툴박스 편집 내용은 에이전트를 저장할 때까지 임시로 보관되며, 저장하면 새 툴박스 버전이 생성됩니다. 도구 상자는 공유 리소스입니다. 저장하기 전에 도구 상자와 에이전트 변경 내용을 모두 검토합니다.
저장된 Foundry 에이전트를 엽니다.
도구에서 도구 상자 찾아보기를 선택합니다+>.
도구 상자를 선택하고 해당 버전, 도구 및 기술을 검토합니다.
추가를 선택합니다.
도구 상자 카드를 확장하여 내용을 검사하고 승인 설정을 검토합니다.
Foundry에 저장을 선택한 다음 해당 도구를 사용하는 요청을 테스트합니다.
도구 상자 리소스 목록에서 프롬프트 에이전트에 추가 를 선택할 수도 있습니다. 도구 상자 만들기 및 공유 연결은 도구 카탈로그를 참조하세요.
연결된 도구 상자 관리
도구 상자 카드의 기타 옵션 메뉴를 사용한 다음 변경한 후 에이전트를 저장합니다.
| 조치 | Effect |
|---|---|
| Configure | 이 에이전트에 대한 도구 호출 승인 설정을 변경합니다. |
| 스위치 버전 | 연결된 도구 상자의 다른 버전을 선택합니다. |
| Replace | 다른 도구 상자를 선택합니다. |
| Remove | 이 에이전트에서 도구 상자를 분리합니다. |
| 옵트아웃 | 해당 도구를 개별 에이전트 도구로 유지하세요. 에이전트는 더 이상 툴박스 기술, 도구 검색, 그리고 버전 관리 및 세트 단위 재사용에 액세스할 수 없습니다. |
A2A를 사용하여 다른 에이전트 연결(미리 보기)
A2A(에이전트-에이전트) 연결을 사용하면 프롬프트 에이전트가 A2A 호환 에이전트를 도구로 호출할 수 있습니다. 직접 또는 도구 상자를 통해 연결할 수 있습니다. 직접 첨부 파일에는 도구 상자 옵트인 설정이 필요하지 않습니다.
저장된 Foundry 에이전트를 엽니다.
도구에서 에이전트 추가(A2A)를 선택합니다+>.
A2A 에이전트 연결에서 적절한 탭을 선택합니다.
Tab 제공할 내용 구성됨 기존 A2A 연결을 선택합니다. 구성된 연결이 있으면 이 탭이 나타납니다. 카탈로그 Foundry 계정 카탈로그에서 에이전트를 선택합니다. 메시지가 표시되면 에이전트 카드 및 인증 단계를 완료합니다. 사용자 지정 이름, 유효한 HTTPS 엔드포인트 및 에이전트 카드 경로를 입력합니다. 필요한 경우 에이전트 카드를 검색할 때 인증을 선택합니다. 대화 상자를 완료하여 에이전트를 연결하거나 추가합니다.
Foundry에 저장을 선택한 다음 연결이 필요한 요청을 테스트합니다.
엔드포인트 설정, 에이전트 카드, ID 옵션 및 사용 권한은 A2A 엔드포인트 사용을 참조하세요.
대화 검토 및 에이전트 전환
플레이그라운드에는 현재 테스트 대화가 포함되어 있습니다. 모든 메시지 지우기를 선택하여 새 대화를 시작합니다.
저장된 Foundry 에이전트의 경우 대화를 선택하여 선택한 버전의 기록을 검토합니다. 대화를 선택하여 메시지 및 응답 세부 정보를 검사합니다. 기록을 열어도 playground에서 해당 대화가 다시 이어지지 않습니다.
에이전트 작성기 맨 위에 있는 에이전트 선택기를 사용하여 로컬 프롬프트와 Foundry 프롬프트 에이전트 간에 전환합니다. 전환 후 스토리지 배지 및 버전을 확인합니다. 대화 탭은 로컬 프롬프트가 아니라 저장된 Foundry 에이전트에 사용할 수 있습니다.
지침 생성 및 개선
Generate를 사용하여 작업 설명의 지침 초안을 작성하거나 기존 지침을 수정할 수 있습니다. 필드가 비어 있으면 영감을 주세요를 통해 시작할 아이디어를 얻을 수 있습니다.
- 명령 생성을 지원하는 모델을 선택합니다.
- 지침에서 필드가 비어 있으면 생성을 선택하거나 지침이 포함된 경우 [개선]을 선택합니다.
- 작업 또는 변경에 대해 설명합니다. 기존 Foundry 에이전트의 경우 개선 제안은 선택 사항입니다.
- 대화 상자에서 생성 또는 개선을 선택합니다.
- 수정된 지침을 검토하고 담당자 요청을 테스트합니다.
- Foundry에 저장을 선택하여 구성을 유지합니다.
저장된 Foundry 에이전트의 경우 이러한 작업은 Foundry 프롬프트 최적화 관리자를 사용합니다. 최적화 API가 모델을 지원하지 않는 경우 도구 키트는 지원되는 경우 표준 프롬프트 생성으로 돌아갑니다. 새 초안에서 Foundry 모델을 선택하는 것 자체가 초안을 저장된 Foundry 에이전트로 만들지는 않습니다.
Foundry 프롬프트 에이전트 평가하기
평가하려는 구성을 저장한 다음 평가를 선택합니다.
- 스캐폴드 평가 코드를 선택하여 로컬 Python 평가 프로젝트를 생성합니다. 생성된 지침에 따라 구성하고 실행합니다.
- 안내에 따라 평가를 설정하려면 Foundry 링크를 선택하세요.
생성된 평가 구성을 실행하기 전에 검토합니다. 스캐폴드는 이름으로 에이전트를 식별합니다. 에이전트 작성기에서 선택한 버전을 고정하는 것으로 가정하지 마세요.
이 탭은 로컬 프롬프트 데이터 세트 보기와 다릅니다. 서비스 평가 지침은 에이전트 평가를 참조하세요.
클라이언트 코드 생성
Foundry 에이전트를 저장한 후 코드 보기 메뉴를 사용하여 애플리케이션에서 호출합니다.
| 조치 | 출력 |
|---|---|
| 코드 보기 | 기존 에이전트를 호출하는 Python 프로젝트입니다. 폴더를 선택한 다음 종속성, 구성 및 인증을 위한 해당 README.md에 따르세요. |
| 코드 조각 보기 | 기존 에이전트를 호출하는 편집기에서 Python 코드 조각입니다. |
두 출력 모두 선택한 저장된 버전을 참조합니다. 애플리케이션에 수정된 구성이 필요한 경우 코드를 생성하기 전에 편집 내용을 저장합니다.
클라이언트 코드는 프롬프트 에이전트를 호스트된 에이전트로 변환하지 않습니다. 직접 SDK를 사용하려면 프롬프트 에이전트 빠른 시작을 참조하세요.
로컬 프롬프트 작업
로컬 스토리지를 선택하여 다른 공급자의 모델을 사용하거나 로컬 도구를 테스트합니다. 모델을 선택하고, 지침을 입력하고, 로컬에 저장을 선택합니다. Foundry 모델을 사용하면 로컬 스토리지를 사용할 수 있는 경우 저장 메뉴를 사용합니다.
로컬에 저장을 사용하여 로컬 변경 내용을 유지합니다. 로컬 저장은 Foundry 버전 또는 Foundry 대화 기록 레코드를 만들지 않습니다.
로컬 도구 연결
로컬 프롬프트의 경우 도구>+>MCP 서버를 선택하여 서버 및 해당 도구를 선택합니다. 구성 및 런타임 요구 사항은 로컬 MCP 서버 연결을 참조하세요.
외부 서비스를 구현하지 않고 함수 스키마를 테스트하려면 다음을 수행합니다.
- 도구>+>사용자 지정 도구를 선택합니다.
- 예제로 선택하거나 기존 스키마를 업로드합니다.
- 스키마, 이름 및 설명을 입력한 다음 도구를 추가합니다.
- 도구 카드에 모의 응답을 입력합니다.
- 프롬프트를 실행하고 모델이 응답을 사용하는 방법을 검사합니다.
모의 응답은 외부 API를 호출하지 않습니다. 구성된 MCP 서버는 해당 도구를 실행할 수 있습니다.
구조적 출력 구성
구조적 출력을 지원하는 모델이 있는 로컬 프롬프트의 경우:
- 모델 선택기 옆에 있는 설정을 엽니다.
-
구조 출력에서 .를 선택합니다
json_schema. - JSON 스키마 선택에서 예제 사용 또는 파일 업로드를 선택합니다.
- 스키마를 검토하고 선택을 선택합니다.
- 로컬 프롬프트를 저장하고 요청을 실행하여 출력을 검사합니다.
사용 가능한 형식은 모델에 따라 달라집니다. 이러한 단계는 저장된 Foundry 프롬프트 에이전트의 응답 스키마가 아니라 로컬 프롬프트 실행에 적용됩니다.
데이터 세트 변수를 사용하여 로컬 프롬프트 평가
저장된 로컬 프롬프트의 경우 평가 탭은 데이터 세트 기반 평가를 제공합니다. 지침의 변수를 사용하여 다른 데이터 세트 값으로 동일한 프롬프트를 실행합니다.
예를 들어 Summarize the issue for {{audience}}. .라는 audience데이터 세트 열을 사용합니다. 각 테스트 사례에 대한 값을 제공합니다. 로컬 일괄 처리 실행기는 프롬프트를 실행할 때 해당 값을 대체합니다.
에이전트 작성기 플레이그라운드에는 별도의 변수 패널이 없습니다. 데이터 세트 가져오기, 평가기 및 결과 비교는 모델, 프롬프트 및 에이전트 평가를 참조하세요.
로컬 프롬프트에 대한 코드 생성
모델 통합 코드를 생성하려면 코드 보기를 선택합니다. 사용 가능한 SDK, 인증 및 언어 선택은 공급자 및 모델에 따라 달라집니다. 이러한 옵션은 Foundry 에이전트 클라이언트 프로젝트 및 코드 조각 작업과 다릅니다.
관련 콘텐츠
다음 가이드를 사용하여 에이전트를 개발하고 게시합니다.