에이전트 배포
연결된 에이전트를 Telegram 또는 MS Teams로 배포하는 노드입니다.
설명
에이전트 배포 노드는 캔버스에 연결된 에이전트를 외부 메시징 채널에서 사용할 수 있도록 배포합니다. 배포가 완료되면 노드 본문에 배포 상태와 웹훅 URL이 표시됩니다.
채널 자격증명은 사용자별 Secret Store에 저장합니다. 노드에는 자격증명 값 자체가 저장되지 않고, 등록된 자격증명을 가리키는 참조만 저장됩니다.
포트 구성
입력 포트
- Agent (필수): 배포할 에이전트 노드를 연결합니다
출력 포트
없음
속성
플랫폼
에이전트를 배포할 메시징 플랫폼을 선택합니다.
- Telegram: Telegram 봇으로 배포합니다
- MS Teams: Microsoft Teams 봇으로 배포합니다
기본값은 Telegram입니다.
자격증명
선택한 플랫폼에서 사용할 봇 토큰 또는 클라이언트 시크릿을 선택합니다.
노드의 자격증명 선택 영역에서 다음 작업을 수행할 수 있습니다.
- 자격증명 등록: 이름과 자격증명 값을 입력해 사용자 계정의 Secret Store에 등록합니다
- 선택 자격증명 삭제: 현재 선택한 자격증명을 삭제합니다
등록한 자격증명 값은 등록 이후 다시 표시되지 않습니다. 활성 배포에서 사용 중인 자격증명은 삭제할 수 없습니다.
Bot App ID (Microsoft App ID)
플랫폼을 MS Teams로 선택했을 때 표시됩니다. Microsoft Bot의 애플리케이션 ID를 입력합니다.
Tenant ID
플랫폼을 MS Teams로 선택했을 때 표시됩니다. Microsoft Entra 테넌트 ID를 입력합니다.
DM 정책
개인 메시지를 처리하는 방식을 설정합니다.
- 페어링:
허용 사용자에 등록된 사용자만 개인 메시지를 보낼 수 있습니다 - 허용 목록:
허용 사용자에 등록된 사용자 또는 범위만 개인 메시지를 보낼 수 있습니다 - 허용: 모든 개인 메시지를 허용합니다
- 사용 안 함: 개인 메시지를 처리하지 않습니다
기본값은 허용입니다.
그룹 정책
그룹 대화에서 메시지를 처리하는 방식을 설정합니다.
- 허용 목록:
허용 사용자에 등록된 사용자 또는 범위만 허용합니다 - 허용: 모든 그룹 대화를 허용합니다
- 사용 안 함: 그룹 대화를 처리하지 않습니다
기본값은 사용 안 함입니다.
멘션 필수
그룹 대화에서 봇이 멘션된 메시지만 처리할지 설정합니다. 활성화하면 그룹 대화에서 봇을 멘션하지 않은 메시지는 처리하지 않습니다.
기본값은 비활성화입니다.
허용 사용자
DM 정책 또는 그룹 정책이 페어링이나 허용 목록일 때 메시지를 허용할 사용자 또는 범위의 식별자를 입력합니다.
사용 방법
- 에이전트 노드를 캔버스에 추가합니다
- Agent 입력 포트에 에이전트 노드를 연결합니다
- 에이전트 배포 노드의 속성에서 플랫폼을 선택합니다
- 자격증명에서 자격증명 등록을 클릭하고 이름과 해당 플랫폼의 봇 토큰 또는 클라이언트 시크릿을 입력합니다
- 등록한 자격증명을 선택합니다
- MS Teams를 선택했다면 **Bot App ID (Microsoft App ID)**와 Tenant ID를 입력합니다
- 필요한 경우 DM 정책, 그룹 정책, 멘션 및 허용 사용자 설정을 조정합니다
- 노드 본문의 배포 버튼을 클릭합니다
- 배포가 성공하면 상태가 활성으로 바뀌고 웹훅 URL이 표시됩니다
주의사항
자격증명 값을 노드 파라미터, 캔버스 메모, 코드 또는 외부 문서에 직접 입력하지 않습니다. 노드에서 자격증명 등록으로 Secret Store에 저장한 뒤 참조를 선택합니다.
자격증명은 등록한 사용자에게 귀속됩니다. 다른 사용자가 등록한 자격증명은 조회하거나 배포에 사용할 수 없습니다.
현재 에이전트 배포 노드 본문에는 배포 버튼만 제공됩니다. 활성 배포를 중단하는 별도 버튼은 제공되지 않습니다.