Slack에 연결

온라인에서 편집하기

Slack 통합 기능을 사용하여 에이전트의 커뮤니케이션 채널로 Slack을 활성화하세요. Slack을 사용하는 팀은 Slack 내에서 직접 에이전트와 실시간으로 소통할 수 있습니다.

Slack 앱을 사용하여 에이전트를 Slack과 통합하면 사용자에게 에이전트의 사용 가능한 기능을 제공합니다. Slack 앱은 구성에 따라 채널에서 언급되거나 다이렉트 메시지에서 사용자에게 응답할 수 있습니다. 에이전트를本番 환경에 배포하기 전에 테스트를 위해 드래프트 에이전트를 Slack 앱에 연결할 수도 있습니다. 통합은 앱의 클라이언트 ID, 클라이언트 시크릿 및 서명 시크릿을 사용하여 안전하고 인증된 연결을 설정합니다.

지원되는 상호작용

Slack 통합은 Agentic 워크플로우에서 다음과 같은 상호작용을 리치 엔티티로 지원합니다:

  • 텍스트 입력

  • 숫자 입력

  • 양식

기존 Slack 환경에서 대화형 양식을 사용하려면 ‘Slack 내에서 양식 상호작용 활성화’를 참조하세요.

학습 내용

이 주제에서는 다음을 배우게 됩니다:

  • Slack 통합을 설정하기 전에 필요한 사전 요구 사항을 검토하십시오.

  • Slack 통합을 설정하고, OAuth 범위를 구성하며 리디렉션 URL을 설정합니다.

  • Slack에서 이메일 가시성을 활성화하여 상담원이 사용자 이메일 주소를 조회할 수 있도록 하십시오.

  • Slack 앱을 직접 메시징을 지원하도록 구성하세요.

  • Slack에서 향상된 사용자 경험을 위해 분할 화면 상호작용을 활성화하세요.

시작하기 전에

통합을 시작하려면 다음 필수 조건이 충족되었는지 확인하십시오:

  • 앱 생성 또는 관리 권한이 부여된 Slack 워크스페이스.

  • 워크스페이스 내에서 생성된 Slack 앱. 여기에서 Slack 앱을 만들 수 있습니다.

  • 앱의 인증 자격 증명 정보에 대한 접근 권한, 다음을 포함하여:

    • 클라이언트 ID : Slack 앱의 고유 식별자로, API 요청 인증에 사용됩니다.

    • 클라이언트 시크릿 : 인증 과정에서 Slack 앱의 신원을 확인하는 데 사용되는 기밀 키입니다.

    • 서명 비밀 : 앱으로 들어오는 요청이 Slack에서 비롯되었음을 보장할 수 있는 비밀 토큰입니다.

    • 봇 사용자 ID OAuth 토큰 : 봇을 대신하여 API 호출에 사용되는 봇 액세스 토큰(로 시작).
    • 팀 ID : Slack 워크스페이스 ID(로 시작 T)로, 워크스페이스 URL 또는 설정에서 확인할 수 있습니다.

Slack 앱에서 이러한 인증 정보를 찾으려면:

  • 클라이언트 ID, 클라이언트 시크릿, 서명 시크릿 : 기본 정보 > 앱 자격 증명서로 이동
  • 봇 사용자 OAuth 토큰 : OAuth 로 이동하여 [권한] > [봇 사용자 ] > [ OAuth ] 토큰 xoxb-(로 시작하는)을 확인하세요
  • 팀 ID : Slack ID에서 확인할 수 있습니다(ID는, T로 시작하며, 워크스페이스( URL ) 또는 설정에서 확인 가능)
중요:

드래프트 앱은 데모나 스테이징 환경에서 사용할 수 있도록 미리 구성된 Slack 애플리케이션입니다. 프로덕션에 배포하기 전에 앱 초안을 사용하여 Slack 통합 기능을 테스트하고, 인증을 확인하고, 채널 동작을 살펴보세요.

Slack 통합 설정하기

다음 단계를 따라 Slack을 커뮤니케이션 채널로 통합하세요:

  1. https://api.slack.com/apps 로 이동하여 앱을 선택하세요.
  2. 채널 > Slack 으로 이동하세요.
  3. 환경(초안 또는 라이브)을 선택하고 새로 만들기를 클릭하세요.
  4. 시작 페이지에서 안내 사항을 검토하고 관련 단계를 적용하십시오. 준비되면 다음을 클릭하십시오.
  5. Slack 앱 만들기 페이지에서 제공된 지침을 살펴보고 관련 단계를 적용합니다. 그리고 나서 다음을 클릭하십시오.
  6. Slack 연결 페이지에서, 이전에 저장한, Client secret, Client ID및 Signing secret 을 입력하세요.

    'Slack에 연결' 페이지에서 관련 단계를 완료하세요. 이 과정에는 OAuth 를 활성화하고, 필요한 범위를 구성하며, 적절한 리디렉션 URL을 설정하는 작업이 포함될 수 있습니다:

    • app_mentions:read
    • chat:write
    • im:history
    • im:write
    • users.profile:read

    각 범위에 대한 자세한 내용은 Slack 문서에서 확인하실 수 있습니다

  7. 다음 을 클릭하십시오.
  8. Slack의 설치(상담원, 봇 ) 페이지에서 설정을 클릭하여 워크스페이스에 Slack 앱을 설치합니다. 화면에 표시되는 지시사항에 따르십시오. 설치가 완료되면 다음을 클릭합니다.
    참고: Slack 워크스페이스의 관리자가 아닌 빌더인 경우, 앱을 추가하려고 하면 Slack에서 설치 요청을 제출하라는 메시지가 표시됩니다. 요청을 제출하고 작업 공간 관리자의 승인을 기다리십시오. 앱이 승인된 후 설정 흐름으로 돌아가 동일한 단계를 따라 설치를 완료하십시오.
  9. Slack의 에이전트 구성 페이지에서 안내에 따라 Slack 앱 설정을 업데이트하세요. 권장되는 변경 사항을 적용하고 저장하십시오.
  10. 완료를 누르십시오.
  11. 에이전트를 배포하고 배포 결과에서 이벤트 ID( URL )를 복사하세요.
  12. Slack 앱의 ‘이벤트 구독’ 설정에서 ‘ URL ’ 이벤트를 업데이트하세요.
    중요: 에이전트를 배포한 후, 배포 결과에서 ‘이벤트 구독(Event URL )’을 복사하여 Slack 앱의 ‘이벤트 구독’ 설정에서 해당 값을 업데이트하십시오. URL 이벤트는 배포할 때마다 달라집니다.
  13. 초안 또는 라이브 환경이 연결되어 있는지 확인하십시오. Slack에 로그인하여 새로 생성한 애플리케이션을 작업 공간에 추가하세요. Slack 앱을 통해 에이전트와 소통할 수 있어야 합니다.

통합이 저장된 후에는 필요에 따라 언제든지 편집하거나 삭제할 수 있습니다.

팁:

에이전트가 사용자의 이메일 주소와 이름을 조회할 수 있도록 하려면, Slack 워크스페이스에서 이메일 및 이름 공개 설정이 활성화되어 있는지 확인하세요. 자세한 내용은 ‘Slack에서 이메일 가시성 활성화’ 섹션을 참조하세요.

Slack에서 이메일 가시성 활성화

워크스페이스에서 이메일 표시 설정이 꺼져 있으면 Slack은 사용자 이메일 주소를 숨깁니다. 이 경우 API는 users.profile.get 이메일 값을 반환할 수 없습니다. watsonx Orchestrate 이 기능은 사용자의 이메일 주소를 통해 참가자를 식별하고 컨텍스트 변수를 관리하므로, 통합 기능이 정상적으로 작동하려면 해당 설정을 활성화해야 합니다. 이러한 문제를 방지하려면 Slack 워크스페이스에서 ‘이메일 표시’ 설정이 활성화되어 있는지 확인하십시오. 그래야 상담원이 Slack API를 통해 사용자의 이메일 주소에 접근할 수 있습니다. Slack에서 이메일 가시성을 활성화하려면:

  1. Slack에서 왼쪽 메뉴에 있는 관리 도구 아이콘을 클릭한 후 워크스페이스 설정 옵션을 선택하세요.

  2. ‘설정 및 권한’ 페이지에서 ‘이메일 표시’ 섹션을 찾아 펼치면, ‘누가 _[워크스페이스 이름]_ 구성원의 이메일 주소를 볼 수 있나요? ’에 대한 현재 설정을 확인할 수 있습니다

  3. 다음 옵션 중 하나를 선택하십시오.

    • _[작업 공간 이름]_의 회원 및 방문객 여러분

    • _[작업 공간 이름]_의 구성원 및 게스트, 그리고 귀하가 연결된 외부 조직의 구성원

두 옵션 중 하나를 선택하면 watsonx Orchestrate 이 Slack API를 통해 사용자의 이메일 주소를 가져올 수 있습니다.

참고:

에이전트가 두 이메일 주소와 표시 이름을 모두 확인할 수 있도록 하려면, ‘설정 및 권한’ 페이지에서 ‘이메일 표시’와 ‘이름 표시’ 설정이 모두 활성화되어 있는지 확인하십시오.

Slack에서 앱과 직접 통신 가능

기본적으로 사용자는 앱이 채널에 추가되고 @ 기호를 사용하여 명시적으로 언급될 때만 Slack 앱과 상호작용할 수 있습니다. 사용자가 Slack 앱과 직접 소통할 수 있도록 하려면 앱의 권한 및 구성 설정을 업데이트해야 합니다.

Slack 앱에서 다이렉트 메시지 기능을 활성화하세요

  1. https://api.slack.com/apps 로 이동하여 앱을 선택하세요.

  2. 앱 홈으로 이동한 후, '탭 표시' 섹션까지 스크롤하세요.

  3. 메시지 탭에서 토글을 켜 기로 설정하면 앱을 통한 직접 메시지 전송이 허용됩니다.

  4. 메시지 탭에서 사용자가 슬래시 명령어와 메시지를 보낼 수 있도록 허용을 선택하세요.

이제 앱의 메시지 창에서 상호작용을 시작할 수 있습니다.

분할 화면 상호작용 활성화

사용자가 분할 화면 ↗에서 앱과 상호작용할 수 있도록 하려면 다음 설정을 구성하세요:

  1. https://api.slack.com/apps 로 이동하여 앱을 선택하세요.

  2. 메뉴에서 ' OAuth &Permissions'로 이동하여 범위를 설정하세요:

    • assistant:write

  3. 에이전트 및 AI 앱 섹션에서 에이전트 또는 어시스턴트 옵션을 찾으세요.

  4. 토글을 켜 기로 전환하여 분할 화면 대화 기능을 활성화하세요.

이제 직접 메시지를 통해 Slack 앱과 직접 소통할 수 있으며, 활성화된 경우 분할 화면 상호작용도 가능합니다.

다음에 수행할 작업

Slack용 채널별 컨텍스트 변수를 추가하려면 Slack 컨텍스트 변수에 제공된 지침을 따르십시오.

Slack의 AI 앱에 대한 자세한 내용은 ‘Slack의 AI 앱 이해하기’↗를 참조하세요.