Microsoft 365 에이전트 도구 키트를 사용하여 Visual Studio Code에서 JavaScript 에이전트 만들기

이 문서에서는 Microsoft 365 에이전트 도구 키트를 사용하여 Visual Studio에서 새 에이전트 SDK JavaScript 프로젝트를 만드는 방법을 알아봅니다.

필수 조건

Visual Studio Code용 에이전트 도구 키트 확장을 설치합니다.
Azure AI Foundry 포털에서 Azure 모델이 필요합니다. 모델에 대한 다음 데이터가 필요합니다.
- 이름
- 대상 URI
- 키
Azure AI Foundry 모델에 모델을 추가하고 구성하는 방법 알아보기

에이전트 도구 키트는 에이전트 빌드를 시작하는 데 도움이 되는 프로젝트 템플릿을 제공합니다. 도구 키트의 템플릿 또는 에이전트 SDK의 샘플에서 시작할 수 있습니다.

비고

다음 절차는 현재 JavaScript 및 TypeScript에 대해서만 작동합니다. Python에 대한 지원이 계획되어 있습니다.

Microsoft 365 에이전트 도구 키트에서 새 에이전트/앱 만들기 를 선택하여 새 에이전트 프로젝트를 빌드할 수 있습니다. 도구 키트의 템플릿 또는 에이전트 SDK의 샘플에서 시작할 수 있습니다. 이 가이드에서는 에이전트 도구 키트부터 시작합니다.

에이전트 도구 키트 확장의 시작 페이지

에이전트 SDK를 사용하여 에이전트 빌드를 시작하려면 첫 번째 메뉴에서 사용자 지정 엔진 에이전트 를 선택합니다.

생성할 에이전트 유형 선택

사용자 지정 엔진 에이전트를 옵션으로 선택하면 사용자 고유의 AI 서비스에 추가할 일련의 프롬프트를 안내합니다.

기본 사용자 지정 엔진 에이전트 또는 날씨 에이전트의 두 가지 템플릿 중에서 선택할 수 있습니다. 기본 사용자 지정 엔진 에이전트는 미리 빌드된 항목이 없는 에이전트입니다. AI 오케스트레이터로서 의미 체계 커널이나 LangChain과 같은 도구를 추가하고, 귀하의 지식도 함께 더해야 합니다.
이 예제에서는 날씨 에이전트 를 선택하여 선택한 언어에 따라 LangChain 및 Azure AI Foundry를 사용하는 에이전트를 만듭니다.
모델에 대해 Azure OpenAI 를 선택합니다.

Azure AI Foundry 포털에서 키, 대상 URI 및 Azure 모델의 이름을 묻는 메시지가 표시됩니다. 이러한 정보는 Foundry 포털의 내 자산 및 모델 및 엔드포인트 에서 찾을 수 있습니다.
세부 정보를 입력하십시오, 키부터 시작합니다.
JavaScript 또는 TypeScript를 선택하고, 기본 폴더를 선택하고, 애플리케이션 이름을 입력하여 프로젝트 루트 폴더를 기본 위치에 저장합니다.

새 프로젝트가 열립니다.
Visual Studio Code의 도구 모음에서 Microsoft 365 로고를 선택하여 확장을 사용하여 로그인되어 있는지 확인합니다. 연결하려는 테넌트에 로그인되어 있는지 확인합니다.

도구 키트에서 사용할 수 있는 새 Microsoft 365 에이전트 플레이그라운드를 사용하여 코드를 디버그하고 테스트할 수 있습니다. 플레이그라운드를 사용하면 전체 배포 주기를 거치지 않고도 코드를 쉽게 디버그할 수 있습니다.

Microsoft 365 에이전트 플레이그라운드에서 디버그를 선택합니다.

플레이그라운드를 선택하면 필요한 구성 요소를 사용하여 로컬 컴퓨터를 준비하는 동안 잠시 기다립니다. 준비는 몇 분 정도 걸립니다.
배포를 기다리는 동안 폴더에서 코드를 확인하고 검토하여 숙지합니다.
디버그 및 테스트용 플레이그라운드가 로드를 마치면 브라우저가 열리고 플레이그라운드를 사용하여 에이전트와 상호 작용할 준비가 된 것입니다. 가이드를 따르고 LangChain 및 Azure AI Foundry와 함께 미리 빌드된 템플릿을 사용한 경우 "내일 {your location}의 날씨는 무엇인가요?"라고 물어볼 수 있습니다. 에이전트는 선택한 AI 서비스를 사용하여 날씨와 함께 적응형 카드로 응답합니다.

에이전트 플레이그라운드에서 로컬로 테스트를 완료하면 Azure Bot Service에 배포하고 Microsoft 365 Copilot 채널에 대해 구성할 수 있습니다. Microsoft 365 Copilot에 대한 액세스 권한이 있는 테넌트에 로그인했는지 확인합니다.

Microsoft 365 Copilot를 사용하여 디버그할 수 있도록 디버그 대상을 Copilot로 변경합니다. F5 또는 디버그를 선택하여 테스트합니다. Microsoft 365에서 에이전트를 사용할 수 있도록 준비하는 데 몇 분 정도 걸립니다. 이 도구 키트는 백그라운드에서 Azure Bot Service에서 앱 등록 및 Bot Service 레코드를 만들고 매니페스트와 함께 테넌트에 프로젝트를 배포합니다.
이렇게 하면 Microsoft 365 Copilot 로드가 표시되고 필요에 따라 Microsoft 365 Copilot에서 직접 질문을 하고 중단점을 추가하고 디버그할 수 있습니다.

이제 성공적으로 다음을 수행했습니다.

이 페이지가 도움이 되었나요?