- 홈
- /
- 문서
마이크로소프트 코파일럿과 통합하면 웹엑스 미팅 사용자가 마이크로소프트 코파일럿 계정을 데이터 소스 중 하나로 안전하게 연결할 수 있어요.
요약하면
사용자는 웹엑스 앱을 활용하여 Cisco AI Assistant 셰어포인트, 원드라이브, 코파일럿 커넥터 등 마이크로소프트 데이터 소스에서 결과를 검색하고 분석하고 요약할 수 있어요.
아키텍처 개요
마이크로소프트 코파일럿에 연결하면 마이크로소프트 리트리벌 API를 사용하여 마이크로소프트 데이터 소스와 상호작용할 수 있어요. 를 Cisco AI Assistant 사용하면 마이크로소프트 소스에서 실시간으로 데이터를 검색해요.
Webex는 를 통해 귀하에게 반환된 데이터를 저장하거나 보관하지 않아요. Cisco AI Assistant 데이터는 응답을 생성하는 용도로만 사용되므로 개인 정보가 보호됩니다.
세부 데이터 흐름 단계
사용자 관리 및 배정
관리자가 Microsoft Copilot 라이선스 보유한 사용자를 관리하고 Control Hub를 사용하여 조직, 사용자 또는 템플릿 수준의 기능을 켜거나 끌 수 있어요.
사용자 승인 및 연결
-
사용자가 Webex 앱에 로그인해요
-
사용자가 설정 페이지로 이동하여 Microsoft 계정에 연결해요.
사용자가 인증 프로세스를 완료하고 액세스할 소스 (셰어포인트, 원드라이브, 코파일럿 커넥터) 를 선택해요.
질문 및 답변 워크플로
예를 들어 사용자가 질문을 해요. 프로젝트 ABC 상태가 어때요?
다음 단계는 Webex 미팅 서비스에서 여러 하위 단계를 사용하여 실행돼요.
-
암호 해독: 시스템이 요청을 해독해요.
-
컨텍스트 로드: 관련 컨텍스트가 로드됐어요.
-
LLM 추론: LLM은 최적의 검색을 위해 질문을 다시 작성해요.
-
통합 정보 가져오기: 시스템이 다중 경로 검색을 위한 구성과 토큰을 검색해요.
-
다중 경로 검색: 시스템이 지원되는 Microsoft 도구에서 검색을 실행해요.
-
검색: 다중 경로 검색 도구가 상세 콘텐츠를 검색해요.
-
검색 결과 반환: 다중 경로 검색 도구가 검색 결과를 반환해요.
-
-
순위 조정 및 필터링: Webex 미팅 서비스는 LLM을 사용하여 콘텐츠의 순위를 변경하고 관련성을 기준으로 콘텐츠를 필터링해요.
-
제너레이션: LLM은 인용과 함께 최종 답변을 생성해요.
-
답변: Webex 앱에 최종 답변을 게시하세요.
데이터 처리
데이터 처리
이 기능은 다음 데이터 및 서비스 구성 정보를 사용하여 인증을 관리하고, 인증된 Microsoft 365 콘텐츠를 검색하고, Webex 앱에서 응답을 제공해요.
-
마이크로소프트 애플리케이션 등록:
마이크로소프트 애플리케이션 등록은 통합을 위해 마이크로소프트 애저 포털에 등록된 OAuth 2.0 클라이언트 구성 (Entra ID) 을 나타냅니다. Cisco AI Assistant
이 등록은 Microsoft 계정 승인 흐름 중에 필요한 특정 위임된 권한을 정의해요.
-
읽어봤어요. 전체 및 사이트. 모두 읽어봤어요. 모두: 셰어포인트 및 원드라이브 콘텐츠에 액세스하는 데 필요해요.
-
외부 항목.읽기.모두: 코파일럿 커넥터 콘텐츠에 액세스하는 데 필요해요.
Cisco AI AssistantMicrosoft 365 Copilot 검색 API를 호출하기 전에 이 등록을 사용하여 로그인 및 토큰 획득을 위한 올바른 OAuth 설정을 찾아요. 자세한 내용은 “마이크로소프트 Cisco AI Assistant 애저에 등록”을 참조하세요.
-
-
마이크로소프트 OAuth 토큰:
마이크로소프트 OAuth 토큰은 사용자가 웹엑스 앱 설정 페이지를 통해 마이크로소프트 계정에 로그인하고 필요한 권한을 부여하면 마이크로소프트 엔트라 ID로 발행되는 수명이 짧은 위임된 액세스 토큰이에요.
Cisco AI Assistant사용자 대신 이 토큰을 사용하여 마이크로소프트 365 코파일럿 검색 API를 호출해요 . Microsoft Entra ID는 이 토큰을 사용하여 각 요청을 인증하고, 사용자를 식별하고, Microsoft 365 액세스 제어 및 정보 차단 정책을 적용하여 로그인한 사용자가 액세스가 허용된 콘텐츠만 반환되도록 합니다.
토큰 리뉴얼
최초 승인 시 Microsoft Entra ID는 수명이 짧은 액세스 토큰 (약 60~90분 동안 유효) 과 수명이 긴 새로 고침 토큰을 모두 발급해요. 웹엑스는 사용자 웹엑스 ID에 바인딩된 새로고침 토큰을 서버 측에 안전하게 저장해요.
액세스 토큰은 계속 갱신되지 않아요. 대신, 사용자가 요청을 제출하면 Webex는 현재 액세스 토큰이 여전히 유효한지 확인합니다. 만료되면, Webex는 자동으로 새로 고침 토큰을 새 액세스 토큰으로 교환해요. 새로고침 토큰의 유효 기간은 사용할 때마다 연장돼서 기능이 정기적으로 사용되는 한 사용자 개입 없이 세션을 계속 활성 상태로 유지할 수 있어요.
세션 종료
다음 상황에서는 세션이 종료되고 재인증이 필요해요.
-
비활성: 사용자가 장기간 (Microsoft Entra ID 기본 정책과 고객의 테넌트 구성에 따라 보통 90일) 동안 이 기능을 사용하지 않았어요.
-
수동 연결 해제: 사용자가 웹엑스 앱 설정에서 마이크로소프트 계정 연결을 명시적으로 끊었어요.
-
관리: 마이크로소프트 365 관리자가 Entra ID로 애플리케이션 액세스를 취소해요.
-
구성 변경: 부여된 권한 범위가 수정되거나 애플리케이션 등록이 변경돼요.
자세한 내용은 “웹엑스 앱에서의 마이크로소프트 계정 승인”을 참조하십시오.
-
-
프롬프트 텍스트:
프롬프트 텍스트는 사용자가 Microsoft 계정 내에서 프로젝트 상태를 찾거나 문서를 찾으라는 요청과 같이 입력하는 자연어 입력을 의미해요. Cisco AI Assistant 이 텍스트는 사용자가 런타임에 생성해요.
처리 워크플로
프롬프트가 제출되면 다음 Cisco AI Assistant 단계에 따라 정보를 검색하고 표시하세요.
-
해석 및 최적화: 어시스턴트가 프롬프트를 해석하고, 추론을 수행하고, 쿼리 재작성을 실행하여 최적화된 쿼리 문자열을 생성해요.
-
API 호출: 어시스턴트가 하나 이상의 데이터 소스에 대해 마이크로소프트 365 코파일럿 검색 API를 호출해요.
-
필터링: 해당되는 경우 KQL (키워드 쿼리 언어) 필터 표현식이 특정 사이트, 문서 라이브러리, 파일 유형 또는 날짜 범위로 검색 범위를 지정하는 데 적용돼요.
-
순위 조정 및 종합: 어시스턴트가 반환된 텍스트 청크의 순위를 다시 매기고 필터링해요. 그런 다음 원본 프롬프트와 원본 문서에 대한 인용을 포함하여 검색된 내용을 결합한 최종 응답을 생성해요.
-
-
셰어포인트와 원드라이브 콘텐츠: 셰어포인트와 원드라이브 콘텐츠는 마이크로소프트 365 코파일럿 검색 API를 통해 마이크로소프트 365 데이터를 검색해서 사용자 요청에 응답하는 것으로 승인됐어요. 검색 API는 데이터를 복제하거나 내보내거나 별도로 인덱싱하지 않고 Microsoft 365 하이브리드 콘텐츠 인덱스에서 직접 관련 텍스트 청크를 추출해요.
지원되는 파일 유형: .docx, .pptx, .pdf, .aspx, .one. 이미지와 차트 같은 텍스트가 아닌 콘텐츠는 지원되지 않아요.
모든 콘텐츠는 Microsoft 365 신뢰 범위 내에서 검색되며 Microsoft 365의 권한 모델에 따라 로그인한 사용자에게 액세스 권한이 부여된 파일 및 문서로 엄격하게 제한됩니다.
-
요청: 승인 Cisco AI Assistant 헤더에 마이크로소프트 엔트라 ID 위임 액세스 토큰을 가지고 HTTPS POST 요청을 https://graph.microsoft.com/v1.0/copilot/retrieval 으로 보낸대요. 요청 본문에는 다음이 포함돼요.
-
쿼리문자열 - 사용자 프롬프트에서 파생하여 다시 작성된 자연어 쿼리 (최대 1,500자).
-
데이터소스 - SharePoint 또는 OneDrive로 설정돼요 (요청당 하나, 소스마다 개별 호출).
-
필터 표현식 (선택 사항) - 사이트 URL, 경로, 파일 유형 또는 날짜 범위를 기준으로 범위를 지정하는 KQL 표현식이에요.
-
최대 결과 수 - 통화당 최대 25개예요.
-
-
응답: Microsoft 365는 신뢰 범위 내에서 요청을 처리하고 RetrievalHits 배열을 반환해요. 각 항목은 다음을 포함해요.
-
콘텐츠청크—콘텐츠 인덱스에서 추출한 텍스트 스니펫이에요.
-
관련성 점수—쿼리와 청크 사이의 코사인 유사성 점수, 0—1 범위로 정규화됐어요
-
리소스—파일 이름, URL, 작성자, 최종 수정일 등 소스 메타데이터
-
-
데이터 처리: 전체 파일 콘텐츠는 전송되지 않아요. Microsoft 365 하이브리드 인덱스에서 미리 추출한 텍스트 청크만 반환돼요. Cisco AI Assistant순위 변경, 필터링, 응답 생성을 위해 이 청크를 일시적으로 LLM에 전달해요. 소스 메타데이터는 최종 응답에서 인용을 구성하는 데 사용돼요. 요청 기간 이후에는 Webex에서 텍스트 청크를 저장하지 않아요.
-
-
부파일럿 커넥터 콘텐츠: 코파일럿 커넥터 콘텐츠는 마이크로소프트 그래프 커넥터를 통해 마이크로소프트 365 콘텐츠 인덱스로 수집되고 마이크로소프트 365 코파일럿 검색 API를 통해 검색 가능한 타사 또는 사용자 정의 기업 데이터예요. 반환되는 모든 콘텐츠는 Microsoft 365에 구성된 커넥터의 권한에 따라 로그인한 사용자가 액세스할 수 있는 항목으로 제한돼요.
-
요청: 승인 Cisco AI Assistant 헤더에 마이크로소프트 엔트라 ID 위임 액세스 토큰을 가지고 HTTPS POST 요청을 https://graph.microsoft.com/v1.0/copilot/retrieval 으로 보낸대요. 요청 본문에는 다음이 포함돼요.
-
쿼리문자열 - 사용자 프롬프트에서 파생하여 다시 작성된 자연어 쿼리 (최대 1,500자).
-
데이터 소스 - 코파일럿 커넥터로 설정했어요.
-
FilterExpression (선택 사항) - 특정 커넥터 소스나 콘텐츠 유형으로 검색 범위를 지정하는 KQL 표현식이에요.
-
최대 결과 수 - 통화당 최대 25개예요.
-
-
응답: Microsoft 365는 신뢰 범위 내에서 요청을 처리하고 RetrievalHits 배열을 반환해요. 각 항목에는 다음이 포함돼요.
-
콘텐츠청크—인덱싱된 타사 콘텐츠에서 추출한 텍스트 스니펫이에요.
관련성 점수—쿼리와 청크 간의 코사인 유사도 점수로, 0—1 범위로 정규화됐어요. 모든 코파일럿 커넥터 결과에는 관련성 점수가 나타나지 않을 수도 있다는 점을 참고하세요.
리소스—항목 이름, URL, 커넥터 정의 속성을 포함한 소스 메타데이터.
-
-
-
데이터 처리: 전체 소스 콘텐츠는 전송되지 않아요. Microsoft 365 콘텐츠 색인에서 미리 추출한 텍스트 청크만 반환돼요. 검색 API는 호출당 하나의 데이터 소스를 대상으로 하기 때문에 SharePoint, Cisco AI Assistant OneDrive 및 Copilot 커넥터에 대해 별도의 검색 호출을 실행하고 순위 조정 단계에서 결과를 병합해요.
텍스트 청크는 순위 변경, 필터링 및 응답 생성을 위해 LLM에 일시적으로 전달되며 요청 기간 이후에는 Webex에 저장되지 않아요.
인증 및 권한 부여
웹엑스는 마이크로소프트 ID 공급자 (IdP) 가 인증하고 관리하는 마이크로소프트 검색 API를 사용하여 당신의 마이크로소프트 계정 및 콘텐츠와 상호작용해요. 마이크로소프트 IdP 및 검색 API와의 모든 통신은 TLS 보안 연결로 보호돼요.
웹엑스 서비스 인증
Cisco AI Assistant인웨벡스 앱은 표준 OAuth 2.0 플로우를 사용하여 웹엑스 서비스와 상호작용해요:
-
ID 제공자: Webex ID 서비스는 사용자를 인증하고 API 액세스를 승인하는 클라우드 기반 IdP 역할을 해요.
-
베어러 토큰: Webex API에 대한 요청은 Webex ID 서비스에서 발행한 베어러 토큰을 사용하여 승인돼요.
-
보안 통신: 웹엑스AI Assistant, 웹엑스 아이덴티티 서비스 및 웹엑스 API 간의 모든 데이터 교환은 TLS 보안 연결을 통해 진행돼요.
관리 요구 사항
이 통합을 활성화하려면 관리자가 다음 단계를 완료해야 해요.
-
마이크로소프트 365 구성: 관리자가 관련 사용자에게 적절한 마이크로소프트 코파일럿 라이선스를 할당해야 해요.
-
Webex 구성: 관리자가 Control Hub 내에서 조직, 사용자 또는 템플릿 수준에서 직접 기능을 활성화하거나 비활성화할 수 있어요.
사용자가 동의한 권한
설정하는 동안 다음 권한이 요청돼요.
| 허가 필요해요 | 목적 |
|---|---|
| Webex 앱 로그인하고 사용자 프로필 읽기 | 계정으로 Webex 앱에 로그인하세요. |
| 당신의 마이크로소프트 계정에 승인하고 로그인해요 | 당신의 마이크로소프트 계정에 연결할 수 있도록 Webex 앱을 확인하고 승인하세요. |
이러한 권한은 설정 과정에서만 사용되며 저장되지 않아요.
서비스 권한
특정 서비스 허가는 필요 없어요. 관리자가 아래 섹션 세부 정보로 컨트롤 허브에서 기능 및 설정을 관리할 수 있어요.
컨트롤 허브의 부파일럿 통합 기능 관리 및 권한 부여
관리자가 조직의 기능을 켜거나 끌 수 있고, 확인란을 사용하여 허가할 수 있는 소스를 하나 이상 결정할 수 있어요.
자세한 내용은 컨트롤 허브에서 AI 통합 설정 및 Webex App에서 Cisco AI Assistant 검색 소스 켜기 또는 끄기를 참조하십시오.
웹엑스 앱 설정 및 구성
관리자가 Control Hub를 사용하여 승인을 받아 기능을 켜면 사용자는 Webex 앱에 로그인하고 마이크로소프트 계정 연결을 승인할 수 있어요.
자세한 내용은 다음을 사용하여 Microsoft 데이터에 액세스를 참조하세요. Cisco AI Assistant