6.2. 메신저 연결
개요
메신저를 연결하면 CogentAI AAS(이하 AAS) 화면에 들어오지 않아도 메신저에서 내 AI 에이전트와 대화할 수 있습니다. 연결할 수 있는 메신저는 텔레그램, 디스코드, 슬랙, Mattermost 입니다. 이동 중이거나 메신저를 주로 쓸 때, 예약 작업의 결과를 메신저로 받고 싶을 때 연결합니다.
메신저를 연결하는 일은 프로파일(작업공간 안의 AI 에이전트 한 명의 설정 묶음, 4.2. 프로파일 개요와 모델) 단위로 합니다. 이 장은 필요한 값, 연결 방법, 허용 사용자 정하기, 연결 상태 확인을 설명합니다.
권한: 메신저를 연결하고 끄는 일은 AI 에이전트 작업공간의 주인, 팀 관리자, 관리자가 합니다. 권한이 없으면 주인이나 관리자에게 연결을 요청합니다. 게이트웨이를 켜고 끄는 일은 관리자가 합니다.
용어
전체 낱말은 A.1. 용어 사전에 있습니다.
| 용어 | 뜻 |
|---|---|
| AI 에이전트 작업공간 | 사용자마다 하나씩 만들어지는 AI 에이전트의 일터입니다. 설정, 스킬, 기억, 파일이 들어 있습니다. 4.1. AI 에이전트 작업공간을 봅니다. |
| 채널 | 프로파일에 연결한 메신저 하나입니다. 화면에서는 「채널」과 「메신저」를 같은 뜻으로 씁니다. |
| 봇 | 메신저 안에서 내 AI 에이전트 대신 말하는 계정입니다. 메신저마다 봇을 따로 만들어야 합니다. |
| 봇 토큰 | 메신저가 봇마다 발급하는 비밀 문자열입니다. AAS 는 입력한 값을 다시 보여 주지 않습니다. |
| 게이트웨이 | AI 에이전트가 메신저와 예약 작업을 받는 통로입니다. 게이트웨이가 실행 중이어야 메신저가 동작합니다. 켜고 끄는 일은 관리자가 합니다. |
| 허용 사용자 | 봇과 대화할 수 있는 사람입니다. 메신저 앱에서 쓰는 사용자 ID 로 정합니다. AAS 로그인 아이디가 아닙니다. |
| 페어링 요청 | 허용되지 않은 사람이 봇에게 처음 말을 걸면 생기는 승인 요청입니다. |
연결에 필요한 값
메신저마다 필요한 값이 다릅니다. 연결 창에서 「필수 값」으로 표시된 칸이 필수 값입니다. 칸의 이름은 아래 표와 같습니다.
| 메신저 | 필수 값(칸 이름) | 값이 무엇인가 |
|---|---|---|
| 텔레그램 | TELEGRAM_BOT_TOKEN | 텔레그램의 봇 만들기 기능으로 만든 봇의 토큰입니다. 숫자, 콜론, 비밀 문자열이 이어진 글 전체를 넣습니다. |
| 디스코드 | DISCORD_BOT_TOKEN | 디스코드 개발자 포털에서 만든 봇의 토큰입니다. |
| 슬랙 | SLACK_BOT_TOKEN, SLACK_APP_TOKEN | 봇 토큰(xoxb- 로 시작)과 앱 토큰(xapp- 로 시작) 두 가지입니다. 앱을 만들어 워크스페이스에 설치해야 받습니다. |
| Mattermost | MATTERMOST_URL, MATTERMOST_TOKEN | 회사 Mattermost 의 접속 주소와, 봇 토큰 또는 개인 접근 토큰입니다. |
값을 얻는 큰 흐름은 네 메신저가 같습니다.
- 메신저 쪽에서 봇(슬랙은 앱)을 만들고 필요한 권한을 줍니다.
- 메신저가 발급한 토큰을 받습니다.
- AAS 연결 창의 해당 칸에 붙여 넣습니다.
1단계와 2단계는 각 메신저 서비스 쪽 작업이라 이 매뉴얼에서 화면 단계를 설명하지 않습니다. 회사에서 쓰는 봇이 있거나 봇을 만들 권한이 없으면, 관리자나 해당 메신저 서비스 담당자에게 토큰을 받습니다. 요청 문장 예시는 다음과 같습니다.
AAS 에 연결할 슬랙 봇이 필요합니다. 봇 토큰(
xoxb-)과 앱 토큰(xapp-)을 알려 주세요. 연결할 프로파일은○○입니다.
토큰은 비밀번호와 같습니다. 채팅이나 메신저 대화에 적지 않고, 받은 곳에서 바로 연결 창에 붙여 넣습니다. 이미 다른 프로파일이 쓰는 봇의 토큰은 다시 쓰지 않습니다.
메신저 연결하기
봇 하나는 프로파일 하나에만 연결합니다. 같은 봇을 두 프로파일에 넣으면 서로 연결을 빼앗 습니다.
연결 화면 열기
방법은 두 가지입니다.
그림 6.2-1. 메신저 연결 화면
- 「자동화 › 메신저 연결」 화면에서 「메신저 연결」(더하기 버튼)을 누릅니다. 프로파일이 여럿이면 프로파일을 먼저 고릅니다.
- 「내 AI 에이전트 › 프로파일」에서 프로파일을 열고 「메신저 연결」 탭을 엽니다.
연결 절차
- 「메신저 연결」을 눌러 「연결할 메신저 고르기」 창을 엽니다.
- 연결할 메신저를 누릅니다. 이미 연결한 메신저에는 「이미 연결했습니다」 안내가 나오고, 누르면 설정이 열립니다.
- 위 표의 필수 값을 칸에 넣습니다. 필수 값은 칸 아래에 「필수 값」으로 표시됩니다. 비어 있으면 「저장하고 켜기」가 눌리지 않습니다.
- 「허용 사용자」 칸에 사용자 ID 를 넣습니다. 비워 두는 방법은 아래 「허용 사용자 정하기」를 봅니다.
- 「저장하고 켜기」를 누릅니다.
- 저장이 끝나면 AAS 가 연결 시험을 이어서 합니다. 결과 문장이 칸 아래에 나옵니다.
그림 6.2-2. 「연결할 메신저 고르기」 창
성공하면 「저장하고 연결을 확인했습니다.」가 나오고 카드에 「연결됨」이 표시됩니다. 실패하면 「저장했지만 연결에 실패했습니다.」와 원인이 나옵니다. 이때는 A.3. 문제 해결의 「메신저 연결」 표를 봅니다.
저장한 비밀 값은 다시 보이지 않습니다. 값을 바꾸려면 「새 값 (비우면 그대로)」 칸에 새 값을 넣고 다시 저장합니다.
Mattermost 는 회사 Mattermost 접속 주소도 필요합니다. 주소는 http 또는 https 로 시작해야 합니다.
메신저 끄기
연결한 메신저 카드의 「설정」을 열고 「끄기」를 누릅니다.
허용 사용자 정하기
허용 사용자 칸이 비어 있으면 아무도 봇과 대화할 수 없습니다. 방법은 두 가지입니다.
방법 1. 페어링 요청 승인
이 방법이 가장 쉽습니다. 외부 봇으로 ID 를 찾지 않아도 되므로 먼저 권합니다.
- 허용 사용자 칸을 비운 채로 메신저를 켭니다.
- 메신저 앱에서 봇에게 먼저 말을 겁니다.
- 「페어링 요청과 허용된 사용자」 구역에 요청이 나옵니다. 칸 바로 아래에도 사용자 이름이 붙은 승인 버튼이 나옵니다.
- 「승인」을 누릅니다.
- 메신저 앱에서 봇에게 다시 말을 걸어 답이 오는지 봅니다. 답이 오면 끝입니다.
승인한 사람은 「허용된 사용자」로 바뀝니다. 허용을 거두려면 그 사람 줄의 「해제」를 누릅니다.
방법 2. 사용자 ID 직접 넣기
「허용 사용자」 칸에 허용할 사람의 메신저 사용자 ID 를 넣습니다. ID 를 찾는 방법은 메신저마다 다릅니다.
| 메신저 | 사용자 ID 찾는 방법 |
|---|---|
| 텔레그램 | 숫자입니다. 봇에 말을 걸어 요청을 승인하면 자동으로 들어갑니다. 직접 알아보려면 텔레그램에서 @userinfobot 에게 말을 겁니다. 외부 봇이라 회사 보안 규정에 맞는지 먼저 확인하고, 되도록 위의 방법 1 을 씁니다. |
| 디스코드 | 디스코드 설정 › 고급에서 개발자 모드를 켭니다. 내 프로필에서 「사용자 ID 복사」를 고릅니다. |
| 슬랙 | 슬랙에서 내 프로필 › 점 세 개 모양의 더보기 메뉴 › 「멤버 ID 복사」를 고릅니다. U 로 시작하는 값입니다. |
| Mattermost | 내 아바타 › 「프로필」을 엽니다. 사용자 ID(영문·숫자 26자)가 보입니다. @이름과 다릅니다. |
허용 사용자가 비어 있는 채로 「저장하고 켜기」를 누르면 확인 창이 나옵니다. 켠 뒤 봇에 말을 걸어 승인하려는 경우에만 계속합니다.
연결 상태 확인
메신저별 상태
연결한 메신저 카드에 상태가 표시됩니다.
| 상태 | 뜻 |
|---|---|
| 연결됨 | 메신저가 정상으로 연결되었습니다. |
| 꺼짐 | 사용자가 끈 상태입니다. |
| 설정 필요 | 필수 값이 비어 있습니다. |
| 반영 대기 | 저장했지만 아직 반영되지 않았습니다. 잠시 뒤 「연결 시험」을 누릅니다. |
| 게이트웨이 중지됨 | 이 프로파일의 게이트웨이가 꺼져 있습니다. 관리자에게 시작을 요청합니다. |
| 시작 실패 | 연결을 시작하지 못했습니다. 봇 토큰이 맞는지 확인합니다. 슬랙은 앱 토큰도 확인합니다. |
게이트웨이를 켜 달라고 요청하는 문장은 6.1. 예약 작업의 「게이트웨이가 중지되어 있을 때」에 있습니다.
「연결 시험」을 누르면 지금 상태를 다시 확인합니다. 허용 사용자 승인을 기다리는 요청이 있으면 카드에 「승인 대기」와 건수가 나옵니다.
전체 상태 화면
「자동화 › 메신저 연결」 화면에서 프로파일별 게이트웨이와 채널 상태를 한눈에 봅니다.
- 「연결된 채널」 카드: 연결된 채널의 수입니다.
- 「주의 채널」 카드: 재시도 기록이 있는 채널의 수입니다.
- 표의 「게이트웨이」 칸: 「실행 중」, 「중지됨」, 「사용하지 않음」, 「알 수 없음」 중 하나입니다.
- 표의 「확인할 것」 칸: 확인해야 할 문제의 첫 줄입니다. 「확인할 것」 보기에서 문제가 있는 프로파일만 모아 봅니다.
- 「활성 예약 작업」 칸: 게이트웨이가 중지되어 있으면 예약 작업이 실행되지 않으므로, 이 숫자와 함께 봅니다.
이 화면에서는 토큰 값을 읽지 않습니다. 행을 누르면 상세 서랍에서 채널별 상태, 마지막 갱신 시각, 오류 글을 볼 수 있습니다.