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 - narzędzie do automatyzacji procesów | 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 |
| integracja Microsoft Entra ID | Użyj Microsoft Entra ID, aby uzyskać dostęp do 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 |
Microsoft Entra ID Zintegrowany
Identyfikator uwierzytelniania: tokenBasedAuth
Dotyczy: wszystkie regiony
Użyj Microsoft Entra ID, aby uzyskać dostęp do 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. |