Microsoft Teams 에 연결 중

미리보기

Microsoft Teams 강력한 커뮤니케이션 및 협업 플랫폼입니다. 하나의 통합된 작업 공간에서 채팅, 미팅, 파일 공유 및 앱 통합 기능을 제공합니다. Microsoft Teams 에 에이전트를 연결하면 사용자가 에이전트와 상호작용하여 워크플로를 간소화하고, 작업을 자동화하며, 생산성을 향상시킬 수 있는 중앙 집중식 허브를 구축할 수 있습니다.

시작하기 전에

통합을 시작하기 전에 다음 사전 요구 사항을 충족해야 합니다:

Microsoft Teams 에 에이전트를 연결하려면 다음을 수행해야 합니다:

  1. 다음에서 앱을 등록하세요 Microsoft Azure

  2. 봇 만들기

  3. Microsoft Teams 앱 생성

프로시저

Microsoft Teams 에 연결하려면 다음 단계를 수행하십시오:

  1. 에이전트 설정 페이지 로 이동하세요.

  2. 채널 > 팀으로 이동합니다.

  3. 환경(초안 또는 라이브)을 선택하고 새로 만들기를 클릭합니다.

  4. 시작하기 페이지의 지침을 검토하고 다음을 클릭합니다.

  5. ‘앱 등록’ 섹션의 안내 사항을 확인해 주세요.

  6. 앱 등록 페이지에서 애플리케이션(클라이언트) ID, 테넌트 ID클라이언트 시크릿 을 입력하세요.

  7. 다음 을 클릭하십시오.

  8. Microsoft Teams 구성 페이지에서 '봇 만들기'와 관련된 단계를 검토하고 완료하세요. 자세한 내용은 봇 만들기를 참조하세요.

  9. ‘Tenant ID’ 아래에 있는 메시징 엔드포인트 필드를 복사하세요. ‘봇 만들기 ’의 7단계로 이동하여 해당 내용을 붙여넣으세요.

  10. Microsoft Teams 구성 페이지에서 'Teams 앱 만들기'와 관련된 단계를 검토하고 완료하세요. 자세한 내용은 Teams 앱 만들기를 참조하세요.

  11. 마침을 클릭하여 설정을 완료합니다.

해당 환경 아래에서 성공적으로 연결된 Microsoft Teams 를 확인할 수 있습니다. 해당 에이전트 환경에서 ‘ Microsoft Teams ’을 편집하거나 삭제하려면 오버플로_메뉴 오버플로 메뉴 버튼을 클릭하세요.

다음에서 앱을 등록하세요 Microsoft Azure

  1. 관리자 자격 증명을 사용하여 Microsoft Azure 포털에 로그인하십시오.

  2. 앱 등록 > 새 등록 으로 이동하세요.

  3. 신청서 등록 페이지에서 이름을 입력하고 적절한 테넌트 유형을 선택한 다음 등록을 클릭합니다.

  4. 앱의 개요 페이지에서 애플리케이션(클라이언트) ID디렉터리(테넌트) ID 값을 복사하세요. watsonx Orchestrate ( Microsoft Teams ) 설정에 애플리케이션(클라이언트) ID 값을 붙여넣으세요.

  5. ‘관리’ > ‘인증서 및 시크릿 ’으로 이동하여 해당 앱의 클라이언트 시크릿을 생성하세요. ‘클라이언트 시크릿’ 탭에서 ‘새 클라이언트 시크릿’을 클릭하여 새로운 클라이언트 시크릿을 생성합니다. 값을 복사하여 저장하세요.

봇 만들기

참고:

IBM E5 개발자 계정을 사용할 경우, 봇 서비스에 대한 접근이 제한됩니다. 이 서비스는 IBM 에서 승인하지 않은 Azure 계정과만 호환됩니다. 개인 계정(예: Gmail 또는 Outlook)은 E5 이상의 계정에 대한 액세스 권한을 부여받지 못합니다. 기업 계정만 사용할 수 있습니다. 또는 개발자는 라이선스를 구매하여 필요한 액세스 권한을 얻을 수 있습니다.

  1. Microsoft Azure 포털에 로그인하세요. 관리자 자격 증명을 사용합니다.

  2. Azure 서비스 목록에서 ‘Bot Services’를 선택하고 ‘Create’를 클릭하여 새 봇을 생성합니다. Azure 의 구독요금제를 선택하세요. 해당 구독이 없는 경우, Azure 구독을 생성해야 합니다.

  3. 봇 핸들, 구독리소스 그룹을 입력하세요. 리소스 그룹이 없는 경우, 새 리소스 그룹을 생성해야 합니다. 새 리소스 그룹을 만들려면 ‘검토 및 생성’을 클릭하세요.
  4. ‘생성 ’ 유형에서 ‘기존 앱 등록 사용’을 선택합니다. App ID 에 앞서 저장해 둔 클라이언트 ID 값을 붙여넣으세요. ‘앱 테넌트 ID ’ 필드에 앞서 저장해 둔 테넌트 ID 값을 붙여넣으세요. ‘검토 및 생성’을 클릭하세요.
  5. 작성을 클릭하십시오.
  6. ‘설정( Settings )’ > ‘구성(Configuration)’ > ‘메시징 엔드포인트(Messaging endpoint) ’로 이동한 후, watsonx Orchestrate Microsoft Teams 설정 페이지의 ‘봇 만들기(Create your bot)’ 섹션에서 복사해 둔 생성된 엔드포인트를 붙여넣으세요. 적용을 누르십시오.

  7. 봇을 Microsoft Teams 에 연결하려면 ‘채널 ’로 이동하여 ‘ Microsoft Teams ’을 선택하세요. ‘메시징’ 탭에서 ‘ Microsoft Teams Commercial’을 선택하고 ‘적용’을 클릭합니다.

Microsoft Teams 앱 생성

  1. Microsoft Teams 개발자 포털 로 이동하여 관리자 자격 증명으로 로그인하십시오.

  2. ‘앱’ > ‘새 앱 만들기’를 클릭하세요.

  3. 앱 이름을 입력하고 추가를 클릭합니다.

  4. ‘기본 정보 ’ 항목에서 모든 필수 입력란을 작성하십시오. ‘앱 등록’ 절차의 4단계에서 확인한 앱 ID를 복사하여 ‘애플리케이션(클라이언트) ID ’ 필드에 붙여넣으세요.

  5. 저장 을 클릭하십시오.

  6. 구성 > 앱 기능 > 봇을 선택합니다.

  7. ‘봇 확인’ 섹션으로 이동하세요. ‘봇 ID 입력’ 필드에 ‘앱 등록’의 4단계에서 생성한 클라이언트 ID 값을 붙여넣으세요.

  8. 사람들이 이 명령을 사용할 수 있는 범위 선택에서 개인, 그룹 채팅을 선택합니다.

  9. ‘저장’을 클릭한 다음 봇을 배포하세요.

  10. ‘앱 패키지 다운로드’를 클릭하여 ZIP 파일을 다운로드하세요.
  11. Microsoft Teams 으로 이동하여 ‘앱’을 클릭하세요.
  12. ‘앱’ 페이지에서 ‘앱 업로드’를 클릭한 다음, 10단계에서 다운로드한 ZIP 파일을 업로드하세요.
  13. 더보기 메뉴(...)를 클릭한 다음, 추가한 앱을 검색하세요. 이제 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 컨텍스트 변수에 제공된 지침을 따르십시오.