기존 API에서 Microsoft 365 Copilot용 API 플러그 인 빌드

중요

MCP 및 API 플러그인은 선언적 에이전트 내에서 작업을 제공합니다. 독립형 설치 가능한 플러그인 패키지가 아닙니다. 포함된 에이전트만 해당 기능과 도구에 액세스할 수 있습니다. 패키지와 작업 매니페스트 관계에 대한 자세한 내용은 플러그 인 및 선언적 에이전트 작업을 참조하세요.

팁

권장: 지원되는 프로 코드 선언적 에이전트 및 플러그인 시나리오에 대한 Work IQ Dev 도구 로 시작하십시오. WIQD 빠른 시작을 참조하세요. 도구 키트 기반 지침은 이를 필요로 하는 기존 프로젝트 및 워크플로에 계속 사용할 수 있습니다. 도구를 선택하기 전에 기능 및 대상 환경 지원을 확인하세요. WIQD는 사용자 지정 엔진 에이전트를 대상으로 하지 않습니다.

API 플러그 인을 사용하면 선언적 에이전트가 기존 REST API를 호출할 수 있습니다. Microsoft 365 에이전트 도구 키트를 사용하여 API의 OpenAPI 사양에 따라 API 작업 통합이 포함된 에이전트 프로젝트를 만듭니다.

필수 구성 요소

팁

최상의 결과를 얻으려면 OpenAPI 사양이 Copilot을 확장하는 데 OpenAPI 문서를 효과적으로 만드는 방법에 자세히 설명된 지침을 따르는지 확인합니다.

이 가이드를 따르려면 예산 추적기 샘플 API 를 다운로드하고 로컬 개발 컴퓨터에서 실행되도록 구성합니다. 샘플을 한 번 이상 빌드하여 API용 BudgetTracker.json 파일을 생성합니다.

에이전트 및 API 플러그인 만들기

참고

이 문서의 스크린샷 및 사용자 인터페이스 참조는 릴리스 버전의 Microsoft 365 에이전트 도구 키트를 사용합니다. 시험판 버전은 표시된 사용자 인터페이스와 다를 수 있습니다.

API 플러그인의 구성에는 다음이 포함됩니다.

  • REST API에 대한 OpenAPI 사양입니다.
  • 포함된 OpenAPI 사양을 참조하고 사용 가능한 작업, 인증 방법 및 응답 형식을 설명하는 플러그인 매니페스트 입니다.

포함하는 에이전트의 앱 패키지에 앱 매니페스트, 에이전트 정의 및 아이콘과 함께 이러한 파일을 포함합니다. API 플러그인 매니페스트 자체는 설치 가능한 패키지가 아닙니다.

  1. Visual Studio Code를 엽니다. 에이전트 도구 키트가 아직 설치되지 않은 경우 설치 지침은 에이전트 도구 키트 설치 를 참조하세요.

  2. 왼쪽 활동 모음에서 Microsoft 365 에이전트 도구 키트 아이콘을 선택합니다.

  3. 에이전트 도구 키트 작업 창에서 새 에이전트/앱 만들기 를 선택합니다.

    에이전트 도구 키트 인터페이스의 스크린샷

  4. 선언적 에이전트를 선택합니다.

  5. 작업 추가를 선택한 다음 OpenAPI 설명 문서로 시작을 선택합니다.

  6. 예산 추적기 샘플(./openapi/BudgetTracker.json에 있는 )에서 찾아보기를 선택하고 OpenAPI 사양의 위치를 찾아봅니다.

  7. 플러그 인에 대해 사용할 모든 작업을 선택합니다.

    작업을 선택하기 위한 에이전트 도구 키트 UI

  8. 에이전트 프로젝트의 위치를 선택합니다.

  9. 에이전트 프로젝트의 이름으로 입력합니다 Budget Tracker .

이 단계를 완료하면 에이전트 도구 키트에서 에이전트 프로젝트 및 해당 API 플러그인 구성을 생성하고 새 Visual Studio Code 창에서 프로젝트를 엽니다.

참고

PKCE(코드 교환을 위한 증명 키)는 기본적으로 사용하도록 설정됩니다. ID 서버가 PKCE를 지원하지 않는 경우 에이전트 프로젝트의 m365agents.yml 에 다음 줄을 추가하여 PKCE를 비활성화합니다.

isPKCEEnabled: false

에이전트 프로비전 및 사이드로드

사이드로드를 사용하면 포함하는 에이전트 및 해당 API 작업을 개발 테스트에 사용할 수 있습니다. API 플러그인을 독립적인 기능으로 설치하지는 않습니다. 이 절차는 구성된 플러그인 패키지에 대한 일반적인 배포 방법이 아닙니다. 공유 및 게시 경로에 대해서는 플러그 인 게시 및 배포 방법 선택을 참조하세요.

  1. Visual Studio Code에서 에이전트 프로젝트를 엽니다.

  2. 왼쪽 활동 모음에서 Microsoft 365 에이전트 도구 키트 아이콘을 선택합니다.

  3. 계정 창에서 Microsoft 365에 로그인을 선택합니다. (이미 로그인한 경우 다음 단계를 계속 진행합니다.)

  4. Microsoft 365 계정 아래에 사용자 지정 앱 업로드 사용 과 Copilot 액세스 사용이 모두 표시되는지 확인합니다. 그렇지 않은 경우 organization 관리자에게 검사하세요. 자세한 내용은 Copilot 확장성 옵션에 대한 요구 사항을 참조하세요.

  5. 수명 주기 창에서 프로비전을 선택합니다.

  6. OAuth 등록을 위한 클라이언트 ID를 입력하라는 메시지가 표시되면 플러그인 클라이언트 ID를 입력합니다.

  7. OAuth 등록을 위해 클라이언트 암호를 입력하라는 메시지가 표시되면 플러그인 클라이언트 암호를 입력합니다.

  8. 대화 상자에서 메시지를 읽고 확인 을 선택하여 계속합니다.

  9. 도구 키트에서 프로비저닝이 완료되었다고 보고할 때까지 기다립니다.

    프로비저닝 성공을 확인하는 에이전트 도구 키트 메시지

이제 에이전트가 Microsoft Teams의 Microsoft 365 Copilot에서 사용자 계정으로 테스트할 수 있습니다.

에이전트의 API 작업 테스트

  1. 브라우저에서 Teams를 열고 에이전트를 사이드로드하는 데 사용한 Microsoft 365 계정으로 로그인합니다.

  2. 왼쪽 활동 표시줄에서 Chat을 선택합니다.

  3. Chat 창에서 Copilot을 선택합니다.

  4. 오른쪽의 에이전트 목록에서 예산 추적기를 선택합니다. 목록을 사용할 수 없는 경우 오른쪽 위 모서리에 있는 Copilot 채팅 및 기타 아이콘을 선택합니다.

    Microsoft Teams의 에이전트 목록 스크린샷

  5. 예산에 대해 질문합니다. 예를 들어 How much is left in the Fourth Coffee lobby renovation budget?. 메시지가 표시되면 항상 허용 또는 한 번 허용 을 선택하여 계속 진행합니다.

  6. 로그인하라는 메시지가 표시되면 예산 추적기에 로그인을 선택합니다.