Udostępnij przez

COSMO Bot (wersja zapoznawcza)

COSMO Bot zwiększa swój sukces biznesowy dzięki większej wydajności w codziennym życiu. Jeśli odpowiadasz na standardowe pytanie dzisiaj, marnujesz czas. W kontaktach z klientami często jest to dobra okazja do poznania siebie i ustanowienia relacji. Ale wewnętrznie, od pracownika do pracownika, lub gdy jest po prostu zbyt wiele do zrobienia, to luksus, który nie każdy może pozwolić sobie. Ten łącznik umożliwia rozszerzenie funkcjonalności bota i zintegrowanie innych systemów.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name POMOC TECHNICZNA COSMO CONSULT
adres URL https://de.cosmoconsult.com/service/support/
Email support.west@cosmoconsult.com
Metadane łącznika
Publisher COSMO CONSULT GmbH
Witryna internetowa https://cosma.link/cc-bot
Zasady ochrony prywatności https://www.cosmoconsult.com/data-protection/
Kategorie AI; Komunikacja

Wymagania wstępne

Aby użyć tego łącznika, musisz mieć dostęp administracyjny do wystąpienia bota COSMO. Co to jest BOT COSMO?Jak uzyskać wystąpienie bota COSMO?

Jak uzyskać poświadczenia?

Po uzyskaniu dostępu administracyjnego do wystąpienia bota COSMO przejdź do interfejsu czatu (tj. https://cosma.cosmoconsult.com/) i przejdź do karty "Administracja", klikając pozycję "Administracja" w prawym górnym rogu. Przejdź do pozycji "Klucze interfejsu API" i utwórz nowy lub skopiuj istniejący.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Adres URL wystąpienia bota ciąg Adres URL, pod którym można uzyskać dostęp do wystąpienia bota Prawda
Klucz interfejsu API securestring Klucz interfejsu API na potrzeby uzyskiwania dostępu do tego wystąpienia bota Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Dodawanie eksperta do tematu

Bot doda eksperta do podanego tematu.
Dodawanie nowego tematu

Dodaje nowy temat do połączonego wystąpienia.
Dodawanie nowego zestawu odpowiedzi na pytania

Dodaje nowy zestaw pytań i odpowiedzi do połączonego wystąpienia.
Edytowanie istniejącego zestawu odpowiedzi na pytania

Edytuj istniejący zestaw pytań i odpowiedzi z połączonego wystąpienia.
Konwertowanie skryptu bota COSMO

Uruchom dany tekst za pomocą analizatora skryptów bota COSMO.
Otwieranie biletu (opinia)

Otwórz nowy bilet opinii o typie dla połączonego wystąpienia.
Otwórz bilet (pytanie)

Otwórz nowy bilet w połączonym wystąpieniu.
Pobieranie tematu

Pobiera określony temat z połączonego wystąpienia.
Pobieranie ustawień globalnych

Pobiera ustawienia globalne z połączonego wystąpienia.
Pobieranie wszystkich zestawów odpowiedzi na pytania

Pobiera wszystkie odpowiedzi z połączonego wystąpienia.
Pobierz wszystkie tematy

Pobiera wszystkie tematy z połączonego wystąpienia bota.
Tworzenie kopii w tle zestawu odpowiedzi na pytania

Dodaje nową kopię w tle dla zestawu pytań i odpowiedzi określonych przez krótki opis. Ostrożny! Te kopie w tle są usuwane po zaktualizowaniu odpowiedzi. Dlatego zaleca się automatyczne wywoływanie tej akcji przy użyciu wyzwalacza "po zaktualizowaniu zestawu odpowiedzi na pytania".
Tłumaczenie (przyjazne dla języka Markdown)

Tłumaczenie danego tekstu przy jednoczesnym poszanowaniu składni języka Markdown dialektu COSMO Bot.
Usuwanie eksperta z tematu

Bot usunie eksperta z podanego tematu. Jeśli nie podano żadnego tematu, ekspert zostanie usunięty ze wszystkich tematów.
Usuwanie zestawu odpowiedzi na pytania

Usuń istniejący zestaw pytań i odpowiedzi z połączonego wystąpienia.
Uzyskiwanie ekspertów dla tematu

Pobiera wszystkie wykładniki z połączonego wystąpienia.
Uzyskiwanie otwartych biletów

Pobiera wszystkie otwarte bilety z połączonego wystąpienia.
Zadaj pytanie botowi COSMO

Bot przeszuknie bazę wiedzy i zwróci odpowiedź z najlepszym dopasowaniem. Zwraca również wynik.
Zamykanie biletu

Zamyka otwarty bilet w połączonym wystąpieniu.
Zmienianie nazwy istniejącego tematu

Zmień nazwę istniejącego tematu z połączonego wystąpienia.

Dodawanie eksperta do tematu

Identyfikator operacji:
AddExpert

Bot doda eksperta do podanego tematu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Temat
 topic True string
Wiadomość e-mail eksperta
 expertEmail True string

Dodawanie nowego tematu

Identyfikator operacji:
AddTopic

Dodaje nowy temat do połączonego wystąpienia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa tematu
 name True string
Description
 description True string
Wiadomości e-mail ekspertów
 expertEmails True array of string

Dodawanie nowego zestawu odpowiedzi na pytania

Identyfikator operacji:
AddAnswer

Dodaje nowy zestaw pytań i odpowiedzi do połączonego wystąpienia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Temat
 topic True string
Krótki opis
 shortDescription True string
Pytania
 questions True array of string
Tekst odpowiedzi
 answerText True string
Adres e-mail użytkownika
 userEmail string

Edytowanie istniejącego zestawu odpowiedzi na pytania

Identyfikator operacji:
EditAnswer

Edytuj istniejący zestaw pytań i odpowiedzi z połączonego wystąpienia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Krótki opis istniejącego zestawu
 shortDescription True string
Zaktualizowany temat
 newTopic string
Zaktualizowany krótki opis
 newShortDescription string
Zaktualizowane pytania
 newQuestions array of string
Zaktualizowany tekst odpowiedzi
 newAnswerText string
Adres e-mail użytkownika
 userEmail string

Konwertowanie skryptu bota COSMO

Identyfikator operacji:
ParseText

Uruchom dany tekst za pomocą analizatora skryptów bota COSMO.

Parametry

Nazwa Klucz Wymagane Typ Opis
Tekst wejściowy
 inputText True string
Format danych wyjściowych
 outputFormat True string

Zwraca

Nazwa Ścieżka Typ Opis
Tekst wyjściowy
 outputText string

Przeanalizowany tekst zwracany przez analizator skryptów bota COSMO.

Otwieranie biletu (opinia)

Identyfikator operacji:
OpenTicketFeedback

Otwórz nowy bilet opinii o typie dla połączonego wystąpienia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres e-mail użytkownika
 userEmail True string
Pytanie, które zostało zadane przez użytkownika
 queryText True string
Krótki opis odpowiedzi
 answerShortDescription True string
Opinia dotycząca odpowiedzi
 feedbackText True string

Zwraca

Nazwa Ścieżka Typ Opis
Bilet
 ticket Ticket

Otwórz bilet (pytanie)

Identyfikator operacji:
OpenTicketQuestion

Otwórz nowy bilet w połączonym wystąpieniu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Adres e-mail użytkownika
 userEmail True string
Pytanie, które zostało zadane przez użytkownika
 queryText True string
Temat, do którego prawdopodobnie należy to pytanie
 topic string

Zwraca

Nazwa Ścieżka Typ Opis
Bilet
 ticket Ticket

Pobieranie tematu

Identyfikator operacji:
GetTopic

Pobiera określony temat z połączonego wystąpienia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa tematu
 topicName True string

Nazwa tematu

Zwraca

Nazwa Ścieżka Typ Opis
Name
 topic.name string
Description
 topic.description string

Pobieranie ustawień globalnych

Identyfikator operacji:
GetGlobalSettings

Pobiera ustawienia globalne z połączonego wystąpienia.

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Pobieranie wszystkich zestawów odpowiedzi na pytania

Identyfikator operacji:
GetAllAnswers

Pobiera wszystkie odpowiedzi z połączonego wystąpienia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Filtruj według tematu (zawiera)
 filterByTopic string

Filtruj według tematu (zawiera)
Filtruj według krótkiego opisu (zawiera)
 filterByShortDescription string

Filtruj według krótkiego opisu (zawiera)
Filtruj według tekstu pytania (zawiera)
 filterByQuestionText string

Filtruj według tekstu pytania (zawiera)
Filtruj według tekstu odpowiedzi (zawiera)
 filterByAnswerText string

Filtruj według tekstu odpowiedzi (zawiera)

Zwraca

Nazwa Ścieżka Typ Opis
Answers
 answers array of Answer

Pobierz wszystkie tematy

Identyfikator operacji:
GetAllTopics

Pobiera wszystkie tematy z połączonego wystąpienia bota.

Parametry

Nazwa Klucz Wymagane Typ Opis
Filtruj według eksperta
 filterByExpert string

Filtruj według eksperta

Zwraca

Nazwa Ścieżka Typ Opis
Tematy
 topics array of string

Tworzenie kopii w tle zestawu odpowiedzi na pytania

Identyfikator operacji:
AddSubAnswer

Dodaje nową kopię w tle dla zestawu pytań i odpowiedzi określonych przez krótki opis. Ostrożny! Te kopie w tle są usuwane po zaktualizowaniu odpowiedzi. Dlatego zaleca się automatyczne wywoływanie tej akcji przy użyciu wyzwalacza "po zaktualizowaniu zestawu odpowiedzi na pytania".

Parametry

Nazwa Klucz Wymagane Typ Opis
Krótki opis oryginalnej odpowiedzi
 shortDescription True string
Krótki opis kopii w tle
 subShortDescription True string
Pytania
 subQuestions True array of string
Tekst odpowiedzi
 subAnswerText True string

Tłumaczenie (przyjazne dla języka Markdown)

Identyfikator operacji:
Translate

Tłumaczenie danego tekstu przy jednoczesnym poszanowaniu składni języka Markdown dialektu COSMO Bot.

Parametry

Nazwa Klucz Wymagane Typ Opis
Język docelowy
 targetLanguageCode True string

Kod języka docelowego (na przykład: fr).
Tekst
 inputText True string

Tekst do tłumaczenia.

Zwraca

Nazwa Ścieżka Typ Opis
Tłumaczenie tekstu
 outputText string

Usuwanie eksperta z tematu

Identyfikator operacji:
RemoveExpert

Bot usunie eksperta z podanego tematu. Jeśli nie podano żadnego tematu, ekspert zostanie usunięty ze wszystkich tematów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Wiadomość e-mail eksperta
 expertEmail True string
Temat
 topic string

Usuwanie zestawu odpowiedzi na pytania

Identyfikator operacji:
DeleteAnswer

Usuń istniejący zestaw pytań i odpowiedzi z połączonego wystąpienia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Krótki opis
 shortDescription True string

Uzyskiwanie ekspertów dla tematu

Identyfikator operacji:
GetExperts

Pobiera wszystkie wykładniki z połączonego wystąpienia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Temat
 topic True string

Temat

Zwraca

Nazwa Ścieżka Typ Opis
Eksperci
 expertEmails array of string

Uzyskiwanie otwartych biletów

Identyfikator operacji:
GetOpenTickets

Pobiera wszystkie otwarte bilety z połączonego wystąpienia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Filtruj według otwartego czasu trwania (minimum)
 filterByHoursSinceOpened integer

Uzyskaj bilety, które były otwarte dłużej niż x godzin.
Filtruj według otwartego czasu trwania (maksimum)
 filterByHoursSinceOpenedMax integer

Uzyskaj tylko bilety, które zostały otwarte przez mniej niż x godzin.
Filtruj według tematu
 filterByTopic string

Filtruj według tematu
Filtruj według eksperta
 filterByExpertEmail string

Filtruj według eksperta

Zwraca

Nazwa Ścieżka Typ Opis
Bilety
 tickets array of Ticket

Zadaj pytanie botowi COSMO

Identyfikator operacji:
AskQuestion

Bot przeszuknie bazę wiedzy i zwróci odpowiedź z najlepszym dopasowaniem. Zwraca również wynik.

Parametry

Nazwa Klucz Wymagane Typ Opis
Question
 question True string
Próg oceny
 scoreThreshold integer

Minimalny wynik odpowiedzi, która ma zostać zwrócona.
Adres e-mail użytkownika
 userEmail string

Zwraca

Nazwa Ścieżka Typ Opis
Znaleziono odpowiedź
 foundAnswer boolean

Czy bot COSMO znalazł odpowiedź zgodną z pytaniem.
Jest Shadow-Answer
 isSubAnswer boolean

Czy zwrócona odpowiedź jest odpowiedzią podrzędną.
Czy przetłumaczono pytanie
 isTranslated boolean

Czy pytanie i zwrócona odpowiedź została przetłumaczona.
Odpowiedź
 answer Answer
Score
 score integer

Jak pewny, że bot jest przekonany, że zwrócona odpowiedź jest poprawna.

Zamykanie biletu

Identyfikator operacji:
CloseTicket

Zamyka otwarty bilet w połączonym wystąpieniu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Unikatowy identyfikator biletu
 ticketId True string
Adres e-mail użytkownika, który przetworzył bilet
 editorEmail True string
Komentarz, który zostanie wysłany do użytkownika
 editorComment True string

Zmienianie nazwy istniejącego tematu

Identyfikator operacji:
RenameTopic

Zmień nazwę istniejącego tematu z połączonego wystąpienia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa tematu
 name True string

Nazwa istniejącego tematu, który ma zostać zmieniony.
Nazwa nowego tematu
 newName True string

Nazwa tematu zostanie zmieniona na .

Wyzwalacze

Kiedy użytkownik zadaje pytanie

Gdy użytkownik zadaje pytanie.
Po rozwiązaniu biletu

Po rozwiązaniu istniejącego biletu.
Po utworzeniu lub zmodyfikowaniu zestawu odpowiedzi na pytania

Po utworzeniu lub zmodyfikowaniu zestawu odpowiedzi na pytania.
Po utworzeniu nowego biletu

Po utworzeniu nowego biletu.
Po utworzeniu nowego zestawu odpowiedzi na pytania

Po utworzeniu nowego zestawu odpowiedzi na pytania.
Po zaktualizowaniu tematu biletu

Po zaktualizowaniu tematu istniejącego biletu.

Kiedy użytkownik zadaje pytanie

Identyfikator operacji:
OnAskedQuestion

Gdy użytkownik zadaje pytanie.

Zwraca

Nazwa Ścieżka Typ Opis
Adres e-mail użytkownika
 userEmail string
Pytanie, które zostało zadane przez użytkownika
 queryText string
Znaleziono odpowiedź
 foundAnswer boolean

Czy bot COSMO znalazł odpowiedź zgodną z pytaniem użytkownika.
Odpowiedź
 answer Answer

Po rozwiązaniu biletu

Identyfikator operacji:
OnResolvedTicket

Po rozwiązaniu istniejącego biletu.

Zwraca

Nazwa Ścieżka Typ Opis
Bilet
 ticket Ticket
Adres e-mail edytora
 editorEmail string
Komentarz edytora
 editorComment string
Link bezpośredni do oryginalnego zapytania
 queryUrl string

Po utworzeniu lub zmodyfikowaniu zestawu odpowiedzi na pytania

Identyfikator operacji:
OnUpdateAnswer

Po utworzeniu lub zmodyfikowaniu zestawu odpowiedzi na pytania.

Zwraca

Nazwa Ścieżka Typ Opis
Odpowiedź
 answer Answer

Po utworzeniu nowego biletu

Identyfikator operacji:
OnNewTicket

Po utworzeniu nowego biletu.

Zwraca

Nazwa Ścieżka Typ Opis
Bilet
 ticket Ticket

Po utworzeniu nowego zestawu odpowiedzi na pytania

Identyfikator operacji:
OnNewAnswer

Po utworzeniu nowego zestawu odpowiedzi na pytania.

Zwraca

Nazwa Ścieżka Typ Opis
Odpowiedź
 answer Answer

Po zaktualizowaniu tematu biletu

Identyfikator operacji:
OnUpdatedTicketTopic

Po zaktualizowaniu tematu istniejącego biletu.

Zwraca

Nazwa Ścieżka Typ Opis
Bilet
 ticket Ticket

Definicje

Odpowiedź

Nazwa Ścieżka Typ Opis
Temat
 topic string
Krótki opis
 shortDescription string
Pytania
 questions array of string
Tekst odpowiedzi
 answerText string
Data i godzina ostatniej modyfikacji tej odpowiedzi:
 modifiedAt date-time
Zmodyfikowany przez
 modifiedBy string

Bilet

Nazwa Ścieżka Typ Opis
Unikatowy identyfikator biletu
 ticketId string
Temat
 topic string
Link bezpośredni do przetwarzania biletu
 ticketUrl string
Wiadomość e-mail żądającego
 requesterEmail string
Wiadomości e-mail ekspertów
 expertEmails array of string
Pytanie, które zostało zadane przez użytkownika
 queryText string
Opinia przesłana przez użytkownika
 feedbackText string

Jest to puste, jeśli ten bilet nie jest opinią.
Krótki opis odpowiedzi otrzymanej przez użytkownika po zadaniu pytania
 answerShortDescription string

Jest to puste, jeśli ten bilet nie jest opinią.
Odpowiedź, że użytkownik otrzymał po zadaniu pytania
 answerText string

Jest to puste, jeśli ten bilet nie jest opinią.
Data i godzina utworzenia biletu
 createdAt date-time