COSMO 봇(미리 보기)
COSMO 봇은 일상 생활에서 효율성을 높여 비즈니스 성공을 향상합니다. 오늘 표준 질문에 대답하면 시간을 낭비하고 있습니다. 고객과의 접촉에서 이것은 종종 서로를 알아가고 관계를 맺을 수있는 좋은 기회입니다. 그러나 내부적으로, 직원에서 직원에 이르기까지, 또는 단순히 할 일이 너무 많을 때, 모두가 자신을 허용 할 수있는 사치입니다. 이 커넥터를 사용하면 봇의 기능을 확장하고 다른 시스템을 통합할 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | COSMO 컨설팅 지원 |
| URL | https://de.cosmoconsult.com/service/support/ |
| 전자 메일 | support.west@cosmoconsult.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | COSMO CONSULT GmbH |
| 웹 사이트 | https://cosma.link/cc-bot |
| 개인 정보 보호 정책 | https://www.cosmoconsult.com/data-protection/ |
| 카테고리 | AI; 통신 |
필수 조건
이 커넥터를 사용하려면 COSMO Bot Instance에 대한 관리 액세스 권한이 있어야 합니다. COSMO 봇이란?COSMO 봇 인스턴스를 얻으려면 어떻게 해야 하나요?
자격 증명을 가져오는 방법
COSMO Bot Instance에 대한 관리 액세스 권한이 있으면 채팅 인터페이스(예 https://cosma.cosmoconsult.com/: )로 이동하여 오른쪽 위 모서리에 있는 "관리"를 클릭하여 "관리" 탭으로 전환합니다. "API 키"로 이동하여 새 키를 만들거나 기존 키를 복사합니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| Bot Instance URL | 문자열 | 봇 인스턴스에 연결할 수 있는 URL | 진실 |
| API 키 | 시큐어스트링 (보안 문자열) | 이 봇 인스턴스에 액세스하기 위한 API 키 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| COSMO 봇 스크립트 변환 |
COSMO 봇 스크립트 파서에서 지정된 텍스트를 실행합니다. |
| COSMO 봇에 질문하기 |
봇은 기술 자료를 검색하고 가장 일치하는 답변을 반환합니다. 또한 점수를 반환합니다. |
| 기존 질문-답변 집합 편집 |
연결된 인스턴스에서 기존 질문-답변 집합을 편집합니다. |
| 기존 항목 이름 바꾸기 |
연결된 인스턴스에서 기존 토픽의 이름을 바꿉니다. |
| 모든 질문-답변 집합 가져오기 |
연결된 인스턴스에서 모든 답변을 가져옵니다. |
| 모든 항목 가져오기 |
연결된 봇 인스턴스에서 모든 항목을 가져옵니다. |
| 번역(markdown friendly) |
COSMO 봇 방언 Markdown 구문을 준수하면서 지정된 텍스트를 번역합니다. |
| 새 질문 답변 집합 추가 |
연결된 인스턴스에 새 질문 답변 집합을 추가합니다. |
| 새 항목 추가 |
연결된 인스턴스에 새 항목을 추가합니다. |
| 오픈 티켓 가져오기 |
연결된 인스턴스에서 열려 있는 모든 티켓을 가져옵니다. |
| 전역 설정 가져오기 |
연결된 인스턴스에서 전역 설정을 가져옵니다. |
| 주제에 대한 전문가 얻기 |
연결된 인스턴스에서 모든 지수를 가져옵니다. |
| 주제에 전문가 추가 |
봇은 제공된 항목에 전문가를 추가합니다. |
| 질문-답변 집합 삭제 |
연결된 인스턴스에서 기존 질문-답변 집합을 삭제합니다. |
| 질문-답변 집합의 섀도 복사본 만들기 |
간단한 설명으로 지정된 질문-답변 집합에 대한 새 섀도 복사본을 추가합니다. 조심하다! 답변이 업데이트되면 이러한 섀도 복사본이 삭제됩니다. 따라서 "질문-답변 집합이 업데이트되는 경우" 트리거를 사용하여 이 작업을 자동으로 호출하는 것이 좋습니다. |
| 토픽에서 전문가 제거 |
봇은 제공된 항목에서 전문가를 제거합니다. 주제가 지정되지 않으면 전문가가 모든 항목에서 제거됩니다. |
| 티켓 닫기 |
연결된 인스턴스에서 열린 티켓을 닫습니다. |
| 티켓 열기(질문) |
연결된 인스턴스에서 새 티켓을 엽니다. |
| 티켓 열기(피드백) |
연결된 인스턴스에 대한 형식 피드백의 새 티켓을 엽니다. |
| 항목 가져오기 |
연결된 인스턴스에서 특정 항목을 가져옵니다. |
COSMO 봇 스크립트 변환
COSMO 봇 스크립트 파서에서 지정된 텍스트를 실행합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
입력 텍스트
|
inputText | True | string | |
|
출력 형식
|
outputFormat | True | string |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
출력 텍스트
|
outputText | string |
COSMO 봇 스크립트 파서에서 반환된 구문 분석된 텍스트입니다. |
COSMO 봇에 질문하기
봇은 기술 자료를 검색하고 가장 일치하는 답변을 반환합니다. 또한 점수를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Question
|
question | True | string | |
|
점수 임계값
|
scoreThreshold | integer |
반환할 답변의 최소 점수입니다. |
|
|
사용자 Email
|
userEmail | string |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
찾은 답변
|
foundAnswer | boolean |
COSMO 봇이 질문과 일치하는 답변을 찾았는지 여부입니다. |
|
Shadow-Answer
|
isSubAnswer | boolean |
반환된 답변이 하위 답변인지 여부입니다. |
|
질문이 번역되었습니다.
|
isTranslated | boolean |
질문과 반환된 답변이 번역되었는지 여부입니다. |
|
답변
|
answer | Answer | |
|
Score
|
score | integer |
봇이 반환된 답변이 정확하다고 얼마나 확신하는지 확인합니다. |
기존 질문-답변 집합 편집
연결된 인스턴스에서 기존 질문-답변 집합을 편집합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
기존 집합에 대한 간단한 설명
|
shortDescription | True | string | |
|
업데이트된 항목
|
newTopic | string | ||
|
업데이트된 간단한 설명
|
newShortDescription | string | ||
|
업데이트된 질문
|
newQuestions | array of string | ||
|
업데이트된 답변 텍스트
|
newAnswerText | string | ||
|
사용자 Email
|
userEmail | string |
기존 항목 이름 바꾸기
연결된 인스턴스에서 기존 토픽의 이름을 바꿉니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
토픽 이름
|
name | True | string |
이름을 바꿀 기존 토픽의 이름입니다. |
|
새 토픽 이름
|
newName | True | string |
토픽의 이름을 바꿀 이름입니다. |
모든 질문-답변 집합 가져오기
연결된 인스턴스에서 모든 답변을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
항목별 필터링(포함)
|
filterByTopic | string |
항목별 필터링(포함) |
|
|
간단한 설명으로 필터링(포함)
|
filterByShortDescription | string |
간단한 설명으로 필터링(포함) |
|
|
질문 텍스트로 필터링(포함)
|
filterByQuestionText | string |
질문 텍스트로 필터링(포함) |
|
|
답변 텍스트로 필터링(포함)
|
filterByAnswerText | string |
답변 텍스트로 필터링(포함) |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Answers
|
answers | array of Answer |
모든 항목 가져오기
연결된 봇 인스턴스에서 모든 항목을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
전문가별 필터링
|
filterByExpert | string |
전문가별 필터링 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
토픽
|
topics | array of string |
번역(markdown friendly)
COSMO 봇 방언 Markdown 구문을 준수하면서 지정된 텍스트를 번역합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
대상 언어
|
targetLanguageCode | True | string |
대상 언어 코드(예: fr)입니다. |
|
문자 메시지
|
inputText | True | string |
번역할 텍스트입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
번역 결과
|
outputText | string |
새 질문 답변 집합 추가
연결된 인스턴스에 새 질문 답변 집합을 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제
|
topic | True | string | |
|
간단한 설명
|
shortDescription | True | string | |
|
질문
|
questions | True | array of string | |
|
답변 텍스트
|
answerText | True | string | |
|
사용자 Email
|
userEmail | string |
새 항목 추가
연결된 인스턴스에 새 항목을 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
토픽 이름
|
name | True | string | |
|
Description
|
description | True | string | |
|
전문가 이메일
|
expertEmails | True | array of string |
오픈 티켓 가져오기
연결된 인스턴스에서 열려 있는 모든 티켓을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
여는 기간(최소)으로 필터링
|
filterByHoursSinceOpened | integer |
x 시간 이상 열려 있는 티켓만 가져옵니다. |
|
|
열려 있는 기간(최대)으로 필터링
|
filterByHoursSinceOpenedMax | integer |
x시간 미만 동안 열려 있는 티켓만 가져옵니다. |
|
|
항목별로 필터링
|
filterByTopic | string |
항목별로 필터링 |
|
|
전문가별 필터링
|
filterByExpertEmail | string |
전문가별 필터링 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
티켓
|
tickets | array of Ticket |
전역 설정 가져오기
연결된 인스턴스에서 전역 설정을 가져옵니다.
반환
주제에 대한 전문가 얻기
연결된 인스턴스에서 모든 지수를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제
|
topic | True | string |
주제 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
전문가
|
expertEmails | array of string |
주제에 전문가 추가
봇은 제공된 항목에 전문가를 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
주제
|
topic | True | string | |
|
전문가 전자 메일
|
expertEmail | True | string |
질문-답변 집합 삭제
연결된 인스턴스에서 기존 질문-답변 집합을 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
간단한 설명
|
shortDescription | True | string |
질문-답변 집합의 섀도 복사본 만들기
간단한 설명으로 지정된 질문-답변 집합에 대한 새 섀도 복사본을 추가합니다. 조심하다! 답변이 업데이트되면 이러한 섀도 복사본이 삭제됩니다. 따라서 "질문-답변 집합이 업데이트되는 경우" 트리거를 사용하여 이 작업을 자동으로 호출하는 것이 좋습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
원래 답변의 간단한 설명
|
shortDescription | True | string | |
|
섀도 복사본의 간단한 설명
|
subShortDescription | True | string | |
|
질문
|
subQuestions | True | array of string | |
|
답변 텍스트
|
subAnswerText | True | string |
토픽에서 전문가 제거
봇은 제공된 항목에서 전문가를 제거합니다. 주제가 지정되지 않으면 전문가가 모든 항목에서 제거됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
전문가 전자 메일
|
expertEmail | True | string | |
|
주제
|
topic | string |
티켓 닫기
연결된 인스턴스에서 열린 티켓을 닫습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
고유 티켓 ID
|
ticketId | True | string | |
|
티켓을 처리한 사용자의 전자 메일
|
editorEmail | True | string | |
|
사용자에게 전송될 주석
|
editorComment | True | string |
티켓 열기(질문)
연결된 인스턴스에서 새 티켓을 엽니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 Email
|
userEmail | True | string | |
|
사용자가 질문한 질문
|
queryText | True | string | |
|
이 질문이 속할 가능성이 있는 항목
|
topic | string |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
표
|
ticket | Ticket |
티켓 열기(피드백)
연결된 인스턴스에 대한 형식 피드백의 새 티켓을 엽니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 Email
|
userEmail | True | string | |
|
사용자가 질문한 질문
|
queryText | True | string | |
|
답변에 대한 간단한 설명
|
answerShortDescription | True | string | |
|
답변에 대한 피드백
|
feedbackText | True | string |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
표
|
ticket | Ticket |
항목 가져오기
연결된 인스턴스에서 특정 항목을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
토픽 이름
|
topicName | True | string |
토픽 이름 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
이름
|
topic.name | string | |
|
Description
|
topic.description | string |
트리거
| 사용자가 질문을 할 때 |
사용자가 질문을 할 때 |
| 새 질문-답변 집합이 만들어지는 경우 |
새 질문-답변 집합이 만들어지는 경우 |
| 새 티켓이 만들어지는 경우 |
새 티켓이 만들어지는 경우 |
| 질문 답변 집합을 만들거나 수정하는 경우 |
질문-답변 집합을 만들거나 수정하는 경우 |
| 티켓의 토픽이 업데이트되는 경우 |
기존 티켓의 토픽이 업데이트되는 경우 |
| 티켓이 확인되면 |
기존 티켓이 확인되면 |
사용자가 질문을 할 때
사용자가 질문을 할 때
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자 Email
|
userEmail | string | |
|
사용자가 질문한 질문
|
queryText | string | |
|
찾은 답변
|
foundAnswer | boolean |
COSMO 봇이 사용자의 질문과 일치하는 답변을 찾았는지 여부입니다. |
|
답변
|
answer | Answer |
새 질문-답변 집합이 만들어지는 경우
새 질문-답변 집합이 만들어지는 경우
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
답변
|
answer | Answer |
새 티켓이 만들어지는 경우
새 티켓이 만들어지는 경우
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
표
|
ticket | Ticket |
질문 답변 집합을 만들거나 수정하는 경우
질문-답변 집합을 만들거나 수정하는 경우
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
답변
|
answer | Answer |
티켓의 토픽이 업데이트되는 경우
기존 티켓의 토픽이 업데이트되는 경우
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
표
|
ticket | Ticket |
티켓이 확인되면
기존 티켓이 확인되면
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
표
|
ticket | Ticket | |
|
편집기 전자 메일
|
editorEmail | string | |
|
편집기 주석
|
editorComment | string | |
|
원래 쿼리에 대한 딥 링크
|
queryUrl | string |
정의
답변
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
주제
|
topic | string | |
|
간단한 설명
|
shortDescription | string | |
|
질문
|
questions | array of string | |
|
답변 텍스트
|
answerText | string | |
|
이 답변이 마지막으로 수정된 날짜 및 시간입니다.
|
modifiedAt | date-time | |
|
수정한 사람:
|
modifiedBy | string |
표
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
고유 티켓 ID
|
ticketId | string | |
|
주제
|
topic | string | |
|
티켓을 처리하는 딥 링크
|
ticketUrl | string | |
|
요청자 전자 메일
|
requesterEmail | string | |
|
전문가 이메일
|
expertEmails | array of string | |
|
사용자가 질문한 질문
|
queryText | string | |
|
사용자가 제출한 피드백
|
feedbackText | string |
이 티켓이 피드백이 아닌 경우 비어 있습니다. |
|
사용자가 질문을 한 후 받은 대답에 대한 간단한 설명
|
answerShortDescription | string |
이 티켓이 피드백이 아닌 경우 비어 있습니다. |
|
사용자가 질문을 한 후 받은 답변
|
answerText | string |
이 티켓이 피드백이 아닌 경우 비어 있습니다. |
|
티켓이 생성된 날짜 및 시간
|
createdAt | date-time |