다음을 통해 공유


Microsoft 에이전트 365 SDK 개요

중요

Microsoft 에이전트 365에 대한 초기 액세스를 얻으려면 프론티어 미리 보기 프로그램의 일부여야 합니다. 프론티어는 Microsoft의 최신 AI 혁신과 직접 연결합니다. 프론티어 미리 보기에는 고객 계약의 기존 미리 보기 조건이 적용됩니다. 이러한 기능은 아직 개발 중이므로 가용성 및 기능은 시간이 지남에 따라 변경 될 수 있습니다.

Microsoft 에이전트 365 SDK는 엔터프라이즈급 ID, 관찰 가능성, 도구 및 거버넌스를 사용하여 에이전트 스택에 빌드된 기존 AI 에이전트를 확장합니다.

에이전트 365 SDK를 사용하면 개발자는 필요에 따라 에이전트 ID를 활용하여 생산성 앱에서 알림을 받고 응답할 수 있습니다. 또한 SDK를 사용하면 에이전트가 Microsoft에서 관리되고 관찰 가능한 MCP(모델 컨텍스트 프로토콜) 서버를 호출할 수 있습니다. 또한 에이전트는 원격 분석을 내보내 IT 관리자에게 에이전트 기능 및 성능에 대한 인사이트를 제공할 수 있습니다.

에이전트 365 SDK란?

에이전트 365 SDK는 필요한 경우 독립적으로 작동하면서 에이전트를 기존 워크플로에 원활하게 맞출 수 있도록 확장하는 포괄적인 소프트웨어 개발 키트입니다. 에이전트는 고유한 ID를 가질 수 있으며, 일반적인 제스처(예: 사용자가 일반적으로 작업하는 앱(예: @mentions) Teams, Word, Outlook 등)를 사용하여 호출할 수 있으며, 관찰 가능한 동작, 신뢰 구축, 감사 가능한 작업 수행 및 도구 및 데이터에 대한 보안 액세스를 통해 모든 작업을 수행할 수 있습니다.

에이전트 ID를 사용하면 관리자에게 제어되고 모니터링되는 액세스 제어를 허용하면서 에이전트에 번창하는 데 필요한 기능을 제공할 수 있습니다. 에이전트는 취득 프로세스를 통해 ID를 획득합니다. 개발 수명 주기 동안 개발자는 에이전트 365 CLI를 사용하여 필요한 MCP 서버로 Microsoft Entra App Blueprint를 가져오고 해당 청사진에서 만든 모든 에이전트 인스턴스에 대한 템플릿을 만들 수 있습니다.

알림을 통해 에이전트의 상호 작용 패턴을 인간에게 더 가깝게 만듭니다. 에이전트는 Teams와 같은 생산성 앱 내에서 컨텍스트에서 사용자에 응답하거나 Word의 의견에 응답할 수 있습니다. 또한 에이전트는 에이전트의 사서함으로 전송된 전자 메일에 응답할 수 있으며 에이전트가 호스트하는 알림 엔드포인트로 배달됩니다. 또한 에이전트는 Acquire 및 UnAcquire같은 수명 주기 작업에 참여하고 해당 시간 동안 에이전트 ID에 대한 설정 및 정리 주기를 수행하도록 선택할 수 있습니다.

Open Telemetry기반으로 구축되고 통합된 Agents 365 SDK는 유추 이벤트, 도구 사용량 및 알림을 포함하여 각 에이전트의 활동에 대한 자세한 원격 분석을 캡처합니다. 관리자는 Purview 및 Defender를 사용하여 에이전트가 사용자, 시스템 및 데이터를 작동하고 상호 작용하는 방법을 완전히 파악할 수있습니다.

에이전트는 Microsoft MCP 서버를 활용하여 전자 메일을 보내고, SharePoint에서 문서를 찾고, 에이전트 코드를 최소한으로 변경하여 문서의 메모에 응답하는 등의 다양한 시나리오를 수행할 수 있습니다. 관리자는 이러한 MCP 서버를 관리하고 점점 늘어나는 도구 목록을 통해 에이전트가 생산성 공간에서 번창할 수 있습니다.

에이전트 365는 Microsoft Agent Framework, Copilot Studio, Azure AI Foundry, 의미 체계 커널, OpenAI 에이전트 SDK, Claude Code SDK 및 LangGraph를 기반으로 구축된 에이전트와 함께 작동합니다.

에이전트 365 SDK는 어떻게 다른가요?

  • 에이전트 365 SDK는 에이전트 스택이 아닙니다. 에이전트를 만들거나 호스트하는 방법은 아니며 Microsoft Agent Framework 또는 Microsoft Copilot Studio 또는 Microsoft Foundry와 반대로 오케스트레이터 또는 워크플로 관리와 함께 제공되지 않습니다.
  • Microsoft 365 에이전트 SDK와 호스팅, 활동 프로토콜 및 ID에 제공하는 기능은 대체되지 않습니다. 반대로 에이전트 365 SDK는 Microsoft 365 에이전트 SDK용 패키지를 사용하여 활동 프로토콜을 통해 알림을 전달하고 에이전트 ID 패키지를 사용하여 해당하는 경우 에이전트에 대한 에이전트 토큰을 가져옵니다.
  • 에이전트 365는 선택한 에이전트 프레임워크에서 사용할 수 있는 경우 개발자에게 기존 에이전트로 시작하도록 요청합니다. 그런 다음 에이전트를 확장하여 디지털 세계에서 에이전트를 제어 가능하고 관찰 가능하며 생산성을 높이는 더 많은 기능을 제공할 수 있습니다.

다이어그램은 기존 에이전트가 에이전트 365를 사용하도록 설정하는 방법을 보여 줍니다.

에이전트 365에서 에이전트의 청사진 이해

에이전트 인스턴스를 만들기 전에 에이전트 365 에이전트의 청사진에서 의미하는 바를 이해하는 것이 도움이 됩니다. 청사진은 에이전트 유형의 IT 승인, 미리 구성된 정의, 기본적으로 모든 규격 에이전트가 만들어지는 엔터프라이즈 "템플릿"입니다. 에이전트의 기능, 필수 MCP 도구 액세스, 보안 및 규정 준수 제약 조건, 감사 요구 사항, 수명 주기 메타데이터 및 DLP, 외부 액세스 제한 또는 로깅 규칙과 같은 연결된 거버넌스 정책 템플릿을 정의합니다. 청사진이 활성화되면 hirable이 되므로 관리자는 Microsoft 365 관리 센터에서 새 에이전트를 인스턴스화할 수 있습니다. 모든 에이전트 인스턴스는 청사진의 규칙을 상속하여 메일, 일정, Teams 메시징, SharePoint 액세스 및 에이전트가 터치하는 다른 모든 Microsoft 365 워크로드 간에 일관된 거버넌스를 보장합니다. 이렇게 하면 "섀도 에이전트"를 방지하고, 관찰 가능성을 적용하고, 보안 Entra 지원 ID 및 권한 모델의 각 에이전트를 고정합니다.

에이전트 365 에이전트 SDK 패키지

지원되는 언어에 대한 패키지 관리자에서 에이전트 365 에이전트 SDK 패키지를 찾습니다.

Python용 에이전트 365 에이전트 SDK 패키지는 PYPI(Python 패키지 인덱스)에 있습니다.

패키지 설명
microsoft-agents-a365-notifications AI 에이전트 애플리케이션에 대한 알림 및 메시징 확장입니다. Microsoft 365 애플리케이션의 여러 채널 및 하위 채널에서 에이전트 알림, 수명 주기 이벤트 및 라우팅을 처리하기 위한 유틸리티를 제공합니다.
microsoft-agents-a365-observability-core OpenTelemetry를 기반으로 하는 AI 에이전트에 대한 원격 분석, 추적 및 모니터링 구성 요소입니다. 컨텍스트 전파 및 플러그형 내보내기를 사용하여 에이전트 호출, 도구 실행 및 LLM 유추에 대한 구조적 범위를 제공합니다.
microsoft-agents-a365-observability-extensions-agent-framework Microsoft 에이전트 프레임워크에 대한 관찰 확장. 에이전트 프레임워크 기반 애플리케이션에 대한 OpenTelemetry 추적 통합을 제공합니다.
microsoft-agents-a365-observability-extensions-openai OpenAI 에이전트 SDK에 대한 관찰 확장. 에이전트 워크플로 및 도구 호출에 대한 자동 계측을 사용하여 OpenAI 에이전트 기반 애플리케이션에 대한 OpenTelemetry 추적 통합을 제공합니다.
microsoft-agents-a365-observability-extensions-langchain LangChain 프레임워크에 대한 관찰성 확장. 체인, 에이전트 및 도구에 대한 자동 계측을 사용하여 LangChain 기반 AI 애플리케이션에 대한 OpenTelemetry 추적 통합을 제공합니다.
microsoft-agents-a365-observability-extensions-semantic-kernel 의미 체계 커널 프레임워크에 대한 관찰성 확장입니다. 커널 함수, 플러그 인 및 플래너에 대한 자동 계측을 사용하여 의미 체계 커널 기반 애플리케이션에 대한 OpenTelemetry 추적 통합을 제공합니다.
microsoft-agents-a365-runtime AI 에이전트 애플리케이션에 대한 핵심 런타임 유틸리티 및 환경 관리. 필수 Power Platform API 검색, 환경 구성 및 인증 범위 확인을 제공합니다.
microsoft-agents-a365-tooling Microsoft 에이전트 365 SDK를 사용하여 빌드된 애플리케이션에서 MCP(모델 컨텍스트 프로토콜) 도구 서버 관리를 위한 핵심 도구 기능입니다. 다양한 AI 프레임워크에서 도구 서버를 검색, 등록 및 관리하기 위한 기반을 제공합니다.
microsoft-agents-a365-tooling-extensions-agentframework AI 에이전트 개발을 위한 에이전트 프레임워크 관련 도구 및 서비스입니다. 에이전트 프레임워크 에이전트에 MCP 서버를 동적으로 추가하기 위한 MCP(모델 컨텍스트 프로토콜) 도구 등록 서비스를 제공합니다.
microsoft-agents-a365-tooling-extensions-openai AI 에이전트 개발을 위한 OpenAI 에이전트 SDK 관련 도구 및 서비스. OpenAI 에이전트 SDK 기반 에이전트에 MCP 서버를 동적으로 추가하기 위한 MCP(모델 컨텍스트 프로토콜) 도구 등록 서비스를 제공합니다.
microsoft-agents-a365-tooling-extensions-semantickernel AI 에이전트 개발을 위한 의미 체계 커널 관련 도구 및 서비스입니다. 의미 체계 커널 기반 에이전트에 MCP 서버를 동적으로 추가하기 위한 MCP(모델 컨텍스트 프로토콜) 도구 등록 서비스를 제공합니다.
microsoft-agents-a365-tooling-extensions-azureaifoundry AI 에이전트 개발을 위한 Azure AI Foundry 특정 도구 및 서비스. Azure AI Foundry 에이전트에 MCP 서버를 동적으로 추가하기 위한 MCP(모델 컨텍스트 프로토콜) 도구 등록 서비스를 제공합니다.

에이전트 365 에이전트의 개략적인 흐름

다음 다이어그램에서는 에이전트의 개발자 흐름을 보여 줍니다.

에이전트 365 에이전트에 대한 게시 흐름 개발

프로그래밍 언어 및 선택한 에이전트 프레임워크를 사용하여 이미 빌드한 에이전트로 시작합니다. 그런 다음 에이전트 365 SDK를 사용하여 이미 만든 에이전트를 확장하여 플랫폼 내에서 실행하는 데 필요한 알림, 관찰 가능성 및 도구 서버 연결과 같은 특수 기능을 추가할 수 있습니다. 기존 에이전트의 구조화 방법에 대한 예제를 원하는 경우 빠른 시작에서는 VS Code용 Microsoft 365 에이전트 도구 키트포함된 샘플 에이전트를 안내합니다. 예제는 사용 가능한 에이전트 365 빠른 시작을 참조하세요.

GitHub 샘플에 제공된 패턴을 사용하여 에이전트가 사용하는 Microsoft MCP 서버를 결정하고, 해당 연결을 구성하고, 에이전트 365 구성 요소(관찰성, 알림 및 도구 서버 연결)를 통합합니다.

그런 다음 에이전트를 나타내고 플랫폼에 연결하는 방법을 정의하는 에이전트 365 청사진을 생성합니다. 청사진을 사용하여 에이전트 플레이그라운드에서 에이전트를 테스트합니다. 이렇게 하면 어디서나 배포하기 전에 알림의 유효성을 검사하고 MCP 상호 작용을 사용해 보고 원격 분석을 검사할 수 있는 공간이 제공됩니다.

모든 것이 제대로 표시되면 테넌트에 에이전트를 게시합니다. 여기에서 관리자는 Microsoft 365 관리 센터 사용하도록 설정하고 관리할 수 있습니다.

에이전트 365 SDK는 언제 필요합니까?

다음을 수행해야 하는 경우 에이전트 365 SDK를 사용합니다.

  • 보안 MCP 커넥터를 통해 Microsoft 365 데이터 또는 도구와 통합
  • 조직 전체에서 여러 에이전트 관리 및 감사
  • 엔터프라이즈급 원격 분석 및 모니터링 제공
  • 에이전트 상호 작용에 대한 알림 사용
  • 추적 가능성 및 수명 주기 관리가 필요한 규제된 환경에 배포

에이전트 365 SDK가 에이전트 에코시스템에 적합한 방법

계층 역할 제공자
엔터프라이즈 기능 ID, 알림, 관찰 가능성, 도구 에이전트 365 SDK
에이전트 논리 프롬프트, 워크플로, 추론 구현 계획
오케스트레이터 런타임 모델 호출 및 도구 오케스트레이션 선택한 프레임워크

개념 한눈에 훑어보기

  • 모든 에이전트의 통합 ID 및 거버넌스
  • 기본 원격 분석 및 추적
  • Microsoft 365 도구에 대한 보안 및 제어 액세스
  • 교차 오케스트레이터 및 다중 클라우드 지원
  • 기존 에이전트에 대한 간소화된 업그레이드 경로

다음 단계: