Język — odpowiadanie na pytania
Język — interfejs API odpowiadania na pytania to oparta na chmurze usługa, która zapewnia zaawansowane przetwarzanie języka naturalnego ze stanem modeli przekształcania sztuki w celu generowania odpowiedzi na niestandardowe projekty odpowiedzi na pytania lub nieprzetworzonego tekstu. Odpowiadanie na pytania to funkcja w usłudze językowej, która została ulepszona z poziomu usługi QnA Maker z dodatkowymi funkcjami, takimi jak obsługa dokumentów bez struktury i precyzyjne odpowiadanie.
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: - China Cloud obsługiwane przez firmę 21Vianet |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure (Chiny) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - China Cloud obsługiwane przez firmę 21Vianet |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - China Cloud obsługiwane przez firmę 21Vianet |
| Kontakt | |
|---|---|
| Name | Pomoc techniczna dotycząca odpowiadania na pytania |
| adres URL | https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview |
| qnamakersupport@microsoft.com |
| Metadane łącznika | |
|---|---|
| Publisher | Mikrosot |
| Witryna internetowa | https://azure.microsoft.com/en-us/services/cognitive-services/question-answering/#overview |
| Zasady ochrony prywatności | https://privacy.microsoft.com/en-us/privacystatement |
| Kategorie | AI; Witryna internetowa |
Language — Question Answering Connector to łącznik umożliwiający integrację dowolnej aplikacji Power z naszą nową funkcją odpowiadania na pytania w usłudze językowej. Dzięki temu łącznikowi użytkownicy mogą teraz łączyć się z nowymi, a także rozszerzonymi funkcjami odpowiadania na pytania. W tym łączniku znajdują się akcje, które ułatwiają użytkownikom
- Generowanie odpowiedzi na podstawie projektu
- Pobieranie metadanych projektu
- Wygeneruj odpowiedzi na podstawie dostarczonego tekstu w danym okresie, planujemy wdrożyć więcej akcji, aby zapewnić klientom więcej funkcji.
Wymagania wstępne
Postępuj zgodnie z instrukcjami tutaj , aby utworzyć projekt odpowiedzi na pytania niestandardowe.
Jak uzyskać poświadczenia
- Po wdrożeniu projektu kliknij pozycję "Pobierz adres URL przewidywania".
- Pobierz adres URL witryny z nazwy hosta adresu URL przewidywania i klucza konta, który będzie kluczem Ocp-Apim-Subscription-Key.
Adres - Utwórz połączenie przy użyciu klucza konta i adresu URL witryny.
Wprowadzenie do łącznika
Używanie łącznika w przepływie
- Przejdź do usługi Microsoft Power Automate, a następnie kliknij pozycję Utwórz i wybierz pozycję "Błyskawiczny przepływ chmury".
- Aby przetestować ten łącznik, możesz kliknąć pozycję "Ręcznie wyzwolić przepływ" i kliknąć pozycję
Create.
- Kliknij pozycję "Nowy krok" i wyszukaj frazę "Language – Question Answering" (Język — odpowiadanie na pytania) i wybierz jedną z trzech akcji.
Akcje:
Generowanie odpowiedzi na podstawie projektu
- Ta akcja pomaga w odpowiadaniu na określone pytanie przy użyciu bazy wiedzy w projekcie.
- To zapytanie umożliwia wygenerowanie odpowiedzi z projektu "Sample-project"
- Dowiedz się więcej o treści żądania tutaj: Odpowiadanie na pytania — Uzyskiwanie odpowiedzi — interfejs API REST (Azure Cognitive Services) | Microsoft Docs
Pobieranie metadanych projektu
- Ta akcja pomaga w uzyskaniu wszystkich metadanych projektu.
- Nadaj nazwę projektu, aby uzyskać metadane projektu.
Generowanie odpowiedzi na podstawie dostarczonego tekstu
- Ta akcja pomaga w odpowiadaniu na określone pytanie przy użyciu podanego tekstu. Aby użyć tylko tej akcji, niestandardowe odpowiadanie na pytania nie musi być włączone w zasobie Język.
- Ta akcja nie wymaga niestandardowego projektu odpowiadania na pytania. Potrzebuje tylko zasobu języka. Zasób językowy można utworzyć i skopiować punkt końcowy i klucz z witryny Azure Portal, odpowiednio w sekcji Klucze i punkt końcowy do adresu URL witryny i klucza konta.
- Zapytanie " jak długo trwa ładowanie powierzchni? " w następującym tekście: " Zasilanie i ładowanie. Ładowanie baterii Surface Pro 4 z pustego stanu trwa od dwóch do czterech godzin. Korzystanie z urządzenia Surface na potrzeby intensywnych działań, takich jak gry lub przesyłanie strumieniowe wideo, może potrwać dłużej, gdy pobierasz ją "
- Dowiedz się więcej o treści żądania tutaj: Odpowiadanie na pytania — uzyskiwanie odpowiedzi z tekstu — interfejs API REST (Azure Cognitive Services) | Microsoft Docs
Odpowiedź
Generowanie odpowiedzi na podstawie projektu
Zostanie zwrócona odpowiedź z "Sample-project" dla pytania "Ułatwienia dostępu". Aby dowiedzieć się więcej o obiekcie odpowiedzi dla tej akcji, odwiedź stronę Odpowiadanie na pytania — Uzyskiwanie odpowiedzi — interfejs API REST (Azure Cognitive Services) | Microsoft Docs
Generowanie odpowiedzi na podstawie dostarczonego tekstu
Wyodrębni odpowiedź na pytanie z danego tekstu. Aby dowiedzieć się więcej na temat obiektu odpowiedzi, odwiedź stronę Odpowiadanie na pytania — uzyskiwanie odpowiedzi z tekstu — interfejs API REST (Azure Cognitive Services) | Microsoft Docs .
Pobieranie metadanych projektu
Pobiera metadane żądanego projektu. Aby dowiedzieć się więcej na temat obiektu odpowiedzi, odwiedź stronę Projekty odpowiedzi na pytania — Uzyskiwanie szczegółów projektu — interfejs API REST (Azure Cognitive Services) | Microsoft Docs .
Znane problemy i ograniczenia
Nie znaleźliśmy żadnego z nas, skontaktuj się z nami, jeśli znajdziesz go w qnamakersupport@microsoft.com
Typowe błędy i środki zaradcze
Zapoznaj się z tą dokumentacją: https://docs.microsoft.com/en-us/rest/api/cognitiveservices/questionanswering/question-answering
Często zadawane pytania
Zapoznaj się z tą dokumentacją: https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/question-answering/overview
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Klucz interfejsu API | ApiKey | Wszystkie regiony | Udostępnialne |
| Zintegrowana z usługą Azure AD | Użyj usługi Azure Active Directory, aby uzyskać dostęp do usługi Azure Blob Storage. | Wszystkie regiony | Nie można udostępniać |
| Domyślne [PRZESTARZAŁE] | Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami. | Wszystkie regiony | Nie można udostępniać |
Klucz interfejsu API
Identyfikator uwierzytelniania: keyBasedAuth
Dotyczy: wszystkie regiony
ApiKey
Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Klucz konta | securestring | Klucz punktu końcowego zasobu języka, który ma zostać skopiowany z witryny Azure Portal | Prawda |
| Adres URL witryny | ciąg | Nazwa hosta zasobu językowego, który ma zostać skopiowany z witryny Azure Portal | Prawda |
Zintegrowana z usługą Azure AD
Identyfikator uwierzytelniania: tokenBasedAuth
Dotyczy: wszystkie regiony
Użyj usługi Azure Active Directory, aby uzyskać dostęp do usługi Azure Blob Storage.
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 witryny | ciąg | Nazwa hosta zasobu językowego, który ma zostać skopiowany z witryny Azure Portal | Prawda |
Domyślne [PRZESTARZAŁE]
Dotyczy: wszystkie regiony
Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.
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 |
|---|---|---|---|
| Klucz konta | securestring | Klucz punktu końcowego zasobu języka, który ma zostać skopiowany z witryny Azure Portal | Prawda |
| Adres URL witryny | ciąg | Nazwa hosta zasobu językowego, który ma zostać skopiowany z witryny Azure Portal | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Generowanie odpowiedzi na podstawie dostarczonego tekstu |
Ta akcja pomaga w odpowiadaniu na określone pytanie przy użyciu podanego tekstu. |
| Generowanie odpowiedzi na podstawie projektu |
Ta akcja pomaga w odpowiadaniu na określone pytanie przy użyciu bazy wiedzy w projekcie. |
| Pobieranie metadanych projektu |
Ta akcja pomaga w uzyskaniu wszystkich metadanych projektu. |
Generowanie odpowiedzi na podstawie dostarczonego tekstu
Ta akcja pomaga w odpowiadaniu na określone pytanie przy użyciu podanego tekstu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Question
|
question | True | string |
Pytanie użytkownika dotyczące wykonywania zapytań względem podanych rekordów tekstowych. |
|
id
|
id | True | string |
Unikatowy identyfikator rekordu tekstowego. |
|
SMS
|
text | True | string |
Zawartość tekstowa rekordu. |
|
Język
|
language | string |
Język rekordów tekstowych. Jest to reprezentacja języka BCP-47. |
|
|
Typ indeksu ciągu
|
stringIndexType | string |
Określa metodę używaną do interpretowania przesunięć ciągów. Wartość domyślna to Text Elements (Graphemes) zgodnie z Unicode w wersji 8.0.0. Aby uzyskać dodatkowe informacje, zobacz https://aka.ms/text-analytics-offsets. |
|
|
Wersja interfejsu API
|
api-version | True | string |
Jest to wersja interfejsu API klienta. |
Zwraca
Reprezentuje wyniki odpowiedzi.
Generowanie odpowiedzi na podstawie projektu
Ta akcja pomaga w odpowiadaniu na określone pytanie przy użyciu bazy wiedzy w projekcie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa projektu
|
projectName | True | string |
Jest to nazwa projektu, której chcesz użyć. |
|
Question
|
question | True | string |
Pytanie użytkownika dotyczące zapytania względem projektu. |
|
Identyfikator użytkownika
|
userId | string |
Unikatowy identyfikator użytkownika. |
|
|
Do góry #
|
top | integer |
Maksymalna liczba odpowiedzi na pytanie. |
|
|
Próg ufności
|
confidenceScoreThreshold | float |
Minimalny wynik progu dla odpowiedzi. Zakresy wartości z zakresu od 0 do 1. |
|
|
Typ klasyfikatora
|
rankerType | string |
Typ klasyfikatora do użycia. |
|
|
Identyfikator QnA
|
qnaId | string |
Jest to dokładny identyfikator pytań i odpowiedzi do pobrania z projektu. |
|
|
Poprzedni identyfikator QnA
|
previousQnaId | integer |
Poprzedni wynik odpowiedzi odpowiedzi QnA ID poprzedniego zwrotu. |
|
|
Poprzednie zapytanie użytkownika
|
previousUserQuery | string |
Poprzednie zapytanie użytkownika. |
|
|
klucz
|
key | string |
Klucz metadanych ze słownika metadanych używany w usłudze QnA. |
|
|
value
|
value | string |
Wartość metadanych ze słownika metadanych używanego w usłudze QnA. |
|
|
Dołączanie metadanych za pomocą polecenia
|
logicalOperation | string |
Ustaw wartość "OR" lub "AND" dla odpowiedniej operacji logicznej dla filtrów metadanych. |
|
|
Filtr źródłowy
|
sourceFilter | string |
Znajdź nazwy pytań i pytań, które są skojarzone z dowolną z danej listy źródeł w projekcie. |
|
|
Dołączanie filtrów za pomocą polecenia
|
logicalOperation | string |
Operacja logiczna używana do łączenia filtru metadanych z filtrem źródłowym. |
|
|
Włącz dokładną odpowiedź
|
enable | boolean |
Włącz lub wyłącz przewidywanie answer span. |
|
|
Próg ufności
|
confidenceScoreThreshold | float |
Minimalny wynik progu wymagany do uwzględnienia dokładnej odpowiedzi, zakresy wartości z zakresu od 0 do 1. |
|
|
Do góry #
|
topAnswersWithSpan | integer |
Liczba najważniejszych odpowiedzi, które należy wziąć pod uwagę w przypadku dokładnego przewidywania odpowiedzi z zakresu od 1 do 10. |
|
|
Dołączanie źródeł bez struktury
|
includeUnstructuredSources | boolean |
Flaga umożliwiająca włączenie zapytania względem źródeł nieustrukturyzowanych. |
|
|
Nazwa wdrożenia
|
deploymentName | True | string |
Jest to konkretne wdrożenie projektu, którego chcesz użyć. |
|
Wersja interfejsu API
|
api-version | True | string |
Jest to wersja interfejsu API klienta. |
Zwraca
Reprezentuje listę odpowiedzi na pytania.
- Body
- AnswersResult
Pobieranie metadanych projektu
Ta akcja pomaga w uzyskaniu wszystkich metadanych projektu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa projektu
|
ProjectNamePathParameter | True | string |
Nazwa projektu do użycia. |
|
Wersja interfejsu API
|
api-version | True | string |
Jest to wersja interfejsu API klienta. |
Zwraca
Reprezentuje projekt.
- Body
- ProjectMetadata
Definicje
ProjectMetadata
Reprezentuje projekt.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
nazwa projektu
|
projectName | string |
Nazwa projektu. |
|
opis
|
description | string |
Opis projektu. |
|
Język
|
language | Language |
Język rekordów tekstowych. Jest to reprezentacja języka BCP-47. |
|
defaultAnswer
|
settings.defaultAnswer | string |
Domyślna odpowiedź, gdy w bazie wiedzy nie znaleziono dobrego dopasowania. |
|
multilingualResource
|
multilingualResource | boolean |
Zasób włączony dla wielu języków w projektach lub nie. |
|
createdDateTime
|
createdDateTime | date-time |
Data i godzina utworzenia projektu. |
|
lastModifiedDateTime
|
lastModifiedDateTime | date-time |
Reprezentuje projekt ostatniej modyfikacji daty i godziny. |
|
lastDeployedDateTime
|
lastDeployedDateTime | date-time |
Reprezentuje datę ostatniego wdrożenia projektu. |
Język
Język rekordów tekstowych. Jest to reprezentacja języka BCP-47.
Język rekordów tekstowych. Jest to reprezentacja języka BCP-47.
- Język
- string
OdpowiedziWybieranie
Reprezentuje listę odpowiedzi na pytania.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
answers
|
answers | array of KnowledgeBaseAnswer |
Reprezentuje listę wyników odpowiedzi. |
|
isUserQuestionAmbiguous
|
isUserQuestionAmbiguous | boolean |
Zwraca wartość logiczną, jeśli pytanie użytkownika było niejednoznaczne. |
KnowledgeBaseAnswer
Reprezentuje odpowiedź projektu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Pytania
|
questions | array of string |
Lista pytań skojarzonych z odpowiedzią. |
|
odpowiedź
|
answer | string |
Tekst odpowiedzi. |
|
Próg ufności
|
confidenceScore | float |
Wynik ufności odpowiedzi, zakresy wartości z zakresu od 0 do 1. |
|
Identyfikator QnA
|
id | integer |
Identyfikator wyniku pytań i pytań. |
|
przesłać źródło
|
source | string |
Źródło wyniku pytań i pytań. |
|
metadane
|
metadata | object |
Metadane skojarzone z odpowiedzią, przydatne do kategoryzowania lub filtrowania odpowiedzi na pytania. |
|
dialog
|
dialog | KnowledgeBaseAnswerDialog |
Okno dialogowe skojarzone z odpowiedzią. |
|
answerSpan
|
answerSpan | AnswerSpan |
Odpowiedź obejmuje obiekt pytań i odpowiedzi. |
KnowledgeBaseAnswerDialog
Okno dialogowe skojarzone z odpowiedzią.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
isContextOnly
|
isContextOnly | boolean |
Aby zaznaczyć, czy monit jest odpowiedni tylko z poprzednim pytaniem, czy nie. Jeśli wartość true, nie dołączaj tej usługi pytań i odpowiedzi jako wyników wyszukiwania dla zapytań bez kontekstu; w przeciwnym razie, jeśli wartość false, ignoruje kontekst i uwzględnia tę usługę pytań i pytań w wynikach wyszukiwania. |
|
Monity
|
prompts | array of KnowledgeBaseAnswerPrompt |
Lista monitów skojarzonych z odpowiedzią. |
KnowledgeBaseAnswerPrompt
Monituj o odpowiedź.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
displayOrder
|
displayOrder | integer |
Indeks monitu — używany w kolejności monitów. |
|
qnaId
|
qnaId | integer |
Identyfikator pytań i odpowiedzi odpowiadający monitowi. |
|
displayText
|
displayText | string |
Tekst wyświetlany w celu reprezentowania monitu o pytanie. |
Zakres odpowiedzi
Odpowiedź obejmuje obiekt pytań i odpowiedzi.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
SMS
|
text | string |
Przewidywany tekst dokładnej odpowiedzi. |
|
Próg ufności
|
confidenceScore | float |
Przewidywany wynik dokładnej odpowiedzi, zakresy wartości z zakresu od 0 do 1. |
|
przesunąć
|
offset | integer |
Przesunięcie dokładnej odpowiedzi od początku odpowiedzi. |
|
length
|
length | integer |
Długość dokładnej odpowiedzi. |
OdpowiedziFromTextResult
Reprezentuje wyniki odpowiedzi.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
answers
|
answers | array of TextAnswer |
Reprezentuje wyniki odpowiedzi. |
TextAnswer
Reprezentuje wynik odpowiedzi.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
odpowiedź
|
answer | string |
Tekst odpowiedzi. |
|
Próg ufności
|
confidenceScore | float |
Wynik ufności odpowiedzi, zakresy wartości z zakresu od 0 do 1. |
|
id
|
id | string |
Identyfikator rekordu. |
|
answerSpan
|
answerSpan | AnswerSpan |
Odpowiedź obejmuje obiekt pytań i odpowiedzi. |
|
przesunąć
|
offset | integer |
Przesunięcie zdania od początku dokumentu. |
|
length
|
length | integer |
Długość zdania. |