팁
권장: 지원되는 프로 코드 선언적 에이전트 및 플러그인 시나리오에 대한 Work IQ Dev 도구 로 시작하십시오. WIQD 빠른 시작을 참조하세요. 도구 키트 기반 지침은 이를 필요로 하는 기존 프로젝트 및 워크플로에 계속 사용할 수 있습니다. 도구를 선택하기 전에 기능 및 대상 환경 지원을 확인하세요. WIQD는 사용자 지정 엔진 에이전트를 대상으로 하지 않습니다.
이 연습에서는 도구 키트의 동기화된 연결선 템플릿을 유지합니다. WIQD 플러그인에서 사용하는 원격 MCP 커넥터 구성이 아니라 수집 서비스를 빌드합니다.
Microsoft 365 Copilot 커넥터를 사용하면 기간 업무 데이터를 Microsoft Graph로 수집하여 Microsoft 365 Copilot에서 사용할 수 있습니다. 데이터를 수집하면 Copilot은 데이터를 추론하고 이를 사용하여 사용자 프롬프트에 응답할 수 있습니다.
이 연습에서는 Microsoft 365 Copilot 플러그 인의 구성 요소로 외부 데이터 액세스를 제공할 수 있는 동기화된 Copilot 커넥터를 만듭니다. 완전한 플러그인을 만들거나 패키징하지 않습니다.
Microsoft 365 에이전트 도구 키트에는 Copilot 커넥터를 빌드하는 데 사용할 수 있는 템플릿이 포함되어 있습니다. Copilot 커넥터 템플릿은 Microsoft Graph에서 Copilot 커넥터 API를 사용하여 커넥터를 빠르게 빌드할 수 있도록 설계되었습니다. 템플릿은 GitHub API에서 Microsoft Graph로 데이터를 가져오는 커넥터를 스캐폴딩합니다. 커넥터를 빌드한 후 F5 환경을 통해 로컬로 실행하거나 Azure Functions를 통해 배포할 수 있습니다.
이 문서에서는 Visual Studio Code에서 Microsoft 365 에이전트 도구 키트를 사용하여 첫 번째 Copilot 커넥터를 빌드하는 단계에 대한 연습을 제공합니다.
시작하기 전에 구성 요소 계획에서 동기화된 커넥터를 적절한 모델로 식별하고 Microsoft 365 에이전트 도구 키트가 대상 환경을 지원하는지 확인합니다. 계획 지침은 플러그 인 기능으로서의 커넥터를 참조하세요.
참고
이 연습에서는 동기화된 커넥터를 빌드합니다. 페더레이션 커넥터, MCP 플러그 인, MCP 서버 또는 에이전트 커넥터를 빌드하지 않습니다.
빌드하는 항목
이 연습에서 에이전트 도구 키트는 GitHub 문제를 검색하는 동기화된 커넥터 구현을 스캐폴딩합니다. 프로젝트를 실행하면 도구 키트는 Microsoft Entra 애플리케이션을 프로비전하고, Microsoft Graph에서 외부 연결 및 스키마를 만들고, 구성된 GitHub 리포지토리에서 외부 항목을 수집합니다.
커넥터는 솔루션의 한 구성 요소입니다. 추가 플러그인 구성 요소를 별도로 완료한 다음 구성 요소를 함께 통합하고 테스트합니다.
필수 구성 요소
이 문서의 단계를 완료하려면 다음과 같은 필수 구성 요소가 필요합니다.
Node.js, 지원되는 버전: 18, 20, 22
Microsoft 365 Copilot 라이선스 또는 사용자 지정 앱 업로드가 활성화된 Microsoft 365 개발자 테넌트.
참고
Microsoft 365 Copilot Chat에서 커넥터를 테스트하려면 Microsoft 365 Copilot 라이선스가 필요합니다.
Microsoft Entra 관리 센터에서 관리자 동의를 받을 수 있어야 합니다. 전역 관리자이거나 이 단계를 완료해야 합니다. 필요한 역할에 대한 애플리케이션에 테넌트 전체 관리자 동의 부여 를 참조하세요.
Microsoft Microsoft 365 관리 센터에서 커넥터를 보려면 사용자에게 검색 관리자, 클라우드 애플리케이션 개발자 역할이 있어야 합니다.
첫 번째 사용자 지정 커넥터 빌드
다음 단계를 사용하여 첫 번째 커넥터를 빌드합니다.
Visual Studio Code의 사이드바에서 Microsoft 365 에이전트 도구 키트 > 새 에이전트/앱 만들기를 선택합니다.
Copilot 커넥터를 선택합니다.
커넥터 이름으로 입력합니다
Github Issues.커넥터에 대한 테넌트 전체의 고유 ID를 만듭니다. 커넥터 ID의 요구 사항에 대한 자세한 내용은 externalConnection 리소스의 id 속성을 참조하세요.
기본 폴더를 선택하여 프로젝트 루트 폴더를 기본 위치에 저장합니다.
파일의 필드를
CONNECTOR_REPOS사용하여 문제를 가져올 리포지토리를 구성합니다.env.local.
F5 키를 눌러 커넥터를 로컬에서 실행합니다. 도구 키트는 커넥터용 Microsoft Entra 앱을 만들고 프로비저닝 프로세스를 시작합니다.
터미널의 링크를 따라 Microsoft Entra 관리 센터로 이동하고 관리자 동의 부여를 선택합니다.
참고
이 단계를 완료하려면 organization의 전역 관리자여야 합니다.
앱에서 연결을 만들고 스키마를 등록한 다음 전체 크롤링을 수행하여 항목을 수집합니다.
참고
스키마를 등록하는 데 최대 10분이 걸릴 수 있습니다.
전체 크롤링이 완료된 후 Microsoft 365 관리 센터에서:
왼쪽 창에서 설정>검색 & 인텔리전스>데이터 원본으로 이동합니다.
연결 ID를 찾습니다.
커넥터 결과 포함을 선택합니다.
참고
이 단계를 완료하려면 검색 관리자여야 합니다. 이 단계에서는 커넥터의 결과를 Microsoft 365 Copilot Chat에서 사용할 수 있습니다. 이 커넥터를 선언적 에이전트에 대한 지식 원본으로만 사용하려는 경우 이 단계는 필요하지 않습니다.
팁
관리 센터 대신 프로그래밍 방식으로 연결 ID를 조회해야 하는 경우 scope를 사용하여 Graph Explorer에서 기존 커넥터를 쿼리할 수 있습니다
ExternalConnection.Read.All.항목이 인덱싱되었는지 확인하려면 관련 커넥터 이름을 선택합니다. 인 덱싱된 항목 필드를 확인하여 인덱싱된 문제 수를 확인합니다.
Microsoft 365 Copilot Chat을 열고 "두 가지 최신 GitHub 문제는 무엇인가요?"와 같은 샘플 프롬프트를 테스트합니다. 페이지 아래쪽에 있는 외부 항목 인용을 확인합니다. 이러한 인용은 Copilot 커넥터의 데이터입니다.
이 테스트는 커넥터가 독립적으로 작동하는지 확인합니다. 전체 플러그인 패키지의 유효성을 검사하거나 커넥터가 다른 플러그인 구성 요소와 함께 작동하는지 확인하지 않습니다.
데이터 원본에 대한 템플릿 사용자 지정
사용자 지정 데이터에 대해 이 템플릿을 사용자 지정하려면 다음 폴더의 콘텐츠를 업데이트하면 됩니다.
src/custom: Microsoft Graph로 수집할 데이터를 수집하고 변환하는 사용자 지정 코드가 포함되어 있습니다. 이 예제에서는 GitHub 문제 API를 사용하지만 다른 API로 바꿀 수 있습니다.src/references: 커넥터의 스키마 정의를 포함합니다. 수집하려는 데이터 및 메타데이터와 일치하도록 조정합니다.src/models: 데이터 및 구성의 내부 표현에 대한 모델 정의를 포함합니다. 두 모델 모두 필요에 맞게 사용자 정의할 수 있습니다.
이러한 폴더 외에도 시나리오에 따라 코드의 다른 부분을 사용자 지정할 수 있습니다. 코드에서 문자열로 [Customization point] 시작하는 주석을 검색할 수 있습니다. 이러한 주석은 잠재적인 사용자 지정 영역을 나타냅니다.
다음 단계
커넥터 통합 검사를 사용하여 인증, 스키마, 인덱싱, 새로 고침 및 권한을 확인합니다. 만료된 인증, 거부된 액세스, 사용할 수 없는 연결 또는 데이터 원본에 대한 오류 및 경계 테스트를 포함합니다.
연결 ID, 스키마, 환경, 권한, 테스트 증거 및 커넥터 소유자를 구현 레코드에 기록합니다. 플러그인에 다른 구성 요소가 포함되어 있는 경우 플러그인 구성 요소를 통합하고 테스트하기 전에 해당 구성 요소를 빌드합니다.