Microsoft Teams 에 연결 중
미리보기
Microsoft Teams 강력한 커뮤니케이션 및 협업 플랫폼입니다. 하나의 통합된 작업 공간에서 채팅, 미팅, 파일 공유 및 앱 통합 기능을 제공합니다. Microsoft Teams 에 에이전트를 연결하면 사용자가 에이전트와 상호작용하여 워크플로를 간소화하고, 작업을 자동화하며, 생산성을 향상시킬 수 있는 중앙 집중식 허브를 구축할 수 있습니다.
시작하기 전에
통합을 시작하기 전에 다음 사전 요구 사항을 충족해야 합니다:
Microsoft Teams 에 에이전트를 연결하려면 다음을 수행해야 합니다:
프로시저
Microsoft Teams 에 연결하려면 다음 단계를 수행하십시오:
에이전트 설정 페이지 로 이동하세요.
채널 > 팀으로 이동합니다.
환경(초안 또는 라이브)을 선택하고 새로 만들기를 클릭합니다.
시작하기 페이지의 지침을 검토하고 다음을 클릭합니다.
‘앱 등록’ 섹션의 안내 사항을 확인해 주세요.
앱 등록 페이지에서 애플리케이션(클라이언트) ID, 테넌트 ID 및 클라이언트 시크릿 을 입력하세요.
다음 을 클릭하십시오.
Microsoft Teams 구성 페이지에서 '봇 만들기'와 관련된 단계를 검토하고 완료하세요. 자세한 내용은 봇 만들기를 참조하세요.
‘Tenant ID’ 아래에 있는 메시징 엔드포인트 필드를 복사하세요. ‘봇 만들기 ’의 7단계로 이동하여 해당 내용을 붙여넣으세요.
Microsoft Teams 구성 페이지에서 'Teams 앱 만들기'와 관련된 단계를 검토하고 완료하세요. 자세한 내용은 Teams 앱 만들기를 참조하세요.
마침을 클릭하여 설정을 완료합니다.
해당 환경 아래에서 성공적으로 연결된 Microsoft Teams 를 확인할 수 있습니다. 해당 에이전트 환경에서 ‘ Microsoft Teams ’을 편집하거나 삭제하려면 오버플로 메뉴 버튼을 클릭하세요.
다음에서 앱을 등록하세요 Microsoft Azure
관리자 자격 증명을 사용하여 Microsoft Azure 포털에 로그인하십시오.
앱 등록 > 새 등록 으로 이동하세요.
신청서 등록 페이지에서 이름을 입력하고 적절한 테넌트 유형을 선택한 다음 등록을 클릭합니다.
앱의 개요 페이지에서 애플리케이션(클라이언트) ID 와 디렉터리(테넌트) ID 값을 복사하세요. watsonx Orchestrate ( Microsoft Teams ) 설정에 애플리케이션(클라이언트) ID 값을 붙여넣으세요.
- ‘관리’ > ‘인증서 및 시크릿 ’으로 이동하여 해당 앱의 클라이언트 시크릿을 생성하세요. ‘클라이언트 시크릿’ 탭에서 ‘새 클라이언트 시크릿’을 클릭하여 새로운 클라이언트 시크릿을 생성합니다. 값을 복사하여 저장하세요.
봇 만들기
IBM E5 개발자 계정을 사용할 경우, 봇 서비스에 대한 접근이 제한됩니다. 이 서비스는 IBM 에서 승인하지 않은 Azure 계정과만 호환됩니다. 개인 계정(예: Gmail 또는 Outlook)은 E5 이상의 계정에 대한 액세스 권한을 부여받지 못합니다. 기업 계정만 사용할 수 있습니다. 또는 개발자는 라이선스를 구매하여 필요한 액세스 권한을 얻을 수 있습니다.
Microsoft Azure 포털에 로그인하세요. 관리자 자격 증명을 사용합니다.
Azure 서비스 목록에서 ‘Bot Services’를 선택하고 ‘Create’를 클릭하여 새 봇을 생성합니다. Azure 의 구독 및 요금제를 선택하세요. 해당 구독이 없는 경우, Azure 구독을 생성해야 합니다.
- 봇 핸들, 구독 및 리소스 그룹을 입력하세요. 리소스 그룹이 없는 경우, 새 리소스 그룹을 생성해야 합니다. 새 리소스 그룹을 만들려면 ‘검토 및 생성’을 클릭하세요.
- ‘생성 ’ 유형에서 ‘기존 앱 등록 사용’을 선택합니다. App ID 에 앞서 저장해 둔 클라이언트 ID 값을 붙여넣으세요. ‘앱 테넌트 ID ’ 필드에 앞서 저장해 둔 테넌트 ID 값을 붙여넣으세요. ‘검토 및 생성’을 클릭하세요.
- 작성을 클릭하십시오.
‘설정( Settings )’ > ‘구성(Configuration)’ > ‘메시징 엔드포인트(Messaging endpoint) ’로 이동한 후, watsonx Orchestrate Microsoft Teams 봇 설정 페이지의 ‘봇 만들기(Create your bot)’ 섹션에서 복사해 둔 생성된 엔드포인트를 붙여넣으세요. 적용을 누르십시오.
- 봇을 Microsoft Teams 에 연결하려면 ‘채널 ’로 이동하여 ‘ Microsoft Teams ’을 선택하세요. ‘메시징’ 탭에서 ‘ Microsoft Teams Commercial’을 선택하고 ‘적용’을 클릭합니다.
Microsoft Teams 앱 생성
Microsoft Teams 개발자 포털 로 이동하여 관리자 자격 증명으로 로그인하십시오.
‘앱’ > ‘새 앱 만들기’를 클릭하세요.
앱 이름을 입력하고 추가를 클릭합니다.
‘기본 정보 ’ 항목에서 모든 필수 입력란을 작성하십시오. ‘앱 등록’ 절차의 4단계에서 확인한 앱 ID를 복사하여 ‘애플리케이션(클라이언트) ID ’ 필드에 붙여넣으세요.
저장 을 클릭하십시오.
구성 > 앱 기능 > 봇을 선택합니다.
‘봇 확인’ 섹션으로 이동하세요. ‘봇 ID 입력’ 필드에 ‘앱 등록’의 4단계에서 생성한 클라이언트 ID 값을 붙여넣으세요.
사람들이 이 명령을 사용할 수 있는 범위 선택에서 개인, 팀 및 그룹 채팅을 선택합니다.
‘저장’을 클릭한 다음 봇을 배포하세요.
- ‘앱 패키지 다운로드’를 클릭하여 ZIP 파일을 다운로드하세요.
- Microsoft Teams 으로 이동하여 ‘앱’을 클릭하세요.
- ‘앱’ 페이지에서 ‘앱 업로드’를 클릭한 다음, 10단계에서 다운로드한 ZIP 파일을 업로드하세요.
- 더보기 메뉴(...)를 클릭한 다음, 추가한 앱을 검색하세요. 이제 Microsoft Teams 을 통해 watsonx Orchestrate 상담원과 소통하실 수 있습니다.
Microsoft Teams 에서 세션을 새로 고치려면 ‘세션 새로 고치기’를 참조하십시오.
Microsoft Teams 에서 세션 새로 고침
Teams에서 언제든지 대화 세션을 새로 고침하여 이전 내용을 지우고 처음부터 다시 시작할 수 있습니다. 봇이 혼란스러워하거나 멈춰버렸을 때, 혹은 단순히 새로운 작업을 시작하고 싶을 때 유용합니다.
세션을 새로 고치는 방법
대화를 초기화하거나 이전 대화 내용을 지우고 싶다면, 아래 옵션 중 하나를 사용하여 세션을 새로 고칠 수 있습니다.
방법 1: 채팅 명령어 사용하기
봇과 Teams에서 대화를 나눌 때 다음을 입력하세요:
/refreshSession
이렇게 하면 현재 세션이 즉시 종료되고 대화 내용이 초기화됩니다.
옵션 2: UI 기반 옵션을 사용합니다
세션을 새로 고치려면 UI 기반 옵션을 사용할 수 있습니다. 이를 사용하려면 먼저 Teams 앱 매니페스트에서 compose 확장 기능을 정의해야 합니다. 이 UI 구성 요소가 활성화되면 세션을 새로 고칠 수 있는 또 다른 방법이 제공됩니다. 기존 세션을 식별해야 하므로, 먼저 메시지를 전송해야 합니다. 활성 세션이 발견되지 않으면 사용자에게 알림이 전송됩니다.
"composeExtensions": [
{
"botId": "d1b6b6b7-7ae3-4c51-b05e-1316b7ff5c41",
"commands": [
{
"id": "refreshSession",
"botId": "d1b6b6b7-7ae3-4c51-b05e-1316b7ff5c41",
"type": "action",
"title": "Refresh Session",
"description": "Refresh the conversation session's context",
"initialRun": false,
"fetchTask": false,
"context": [
"commandBox",
"compose"
]
}
]
}
]
botId 에는 APP 매니페스트에서 확인할 수 있는 해당 Microsoft 봇 ID를 입력하세요.
이 설정을 완료하면, 다음을 입력할 때 상단 바에 ‘세션 새로 고침’ 옵션이 표시됩니다:
/YOUR_APP_NAME
세션 갱신은 자동으로 이루어집니다. 설정이 필요하지 않습니다. 새로 고침을 선택하기 전까지는 현재 세션이 평소와 같이 계속 유지됩니다.
다음에 수행할 작업
Microsoft Teams 에 채널별 컨텍스트 변수를 추가하려면 Teams 컨텍스트 변수에 제공된 지침을 따르십시오.