Tenjin Icon

Flow Knowledge Actions

Query QnA

The Query QnA flow action will search QnA using the text supplied and save the results into the specified variable.

Options

The following additional options may be configured:

  • Include query in analytics: By default, all queries are recorded into analytics, turning off 'Include query in analytics' will prevent this.
  • Query assistant's linked topic: By default, the query will look for answers in the topics that are linked to the assistant, turning this option off will prevent linked topics from being queried. When turning it off you will need to specify other topics to query.
  • Query specific topics: Specify additional topics to query. May be used in addition to querying the assistant's linked topics. Additional topics may be added. Choose 'Topic' to enter a fixed topic name, or 'Topic from expression' to enter an expression. The expression should evaluate to a list of strings, each a valid topic name.

Example results and Parsing an ActionLink's Intent can be found within the inline help. 

The Query QnA badge will automatically be awarded when this action is called from a logged-in Tenjin User.

 

Get QnA

The Get Question and Answer flow action will get a single question and answer pair based on the configured QnaDocumentId, saving the result into the specified variable.

  • QnaDocumentId: This expression must start with an = then use the (x) button above the entry box to insert the variable required.
  • Include query in analytics: By default, all queries are recorded, turning this off will mean the query is not recorded into the analytics data.

A JSON example of a QnA result can be found within the inline help. 

Submit QnA Question Suggestion

The Submit QnA Question Suggestion flow action allows you to improve the quality of your QnA knowledge by suggesting alternative questions to your question and answer pair. You can then review these suggestions in the QnA administration section.

Your QnA questions do not change automatically, in order for any change to take effect, you must accept the suggestions. These suggestions add questions but don't change or remove existing questions.

The action inputs are summarised below:

  • QnaDocumentId: This expression must start with an equal sign (=), then use the (x) button above the entry box to insert the variable required. This should be retrieved from a QnA result object; e.g. =QnaResultVariable[0].QnaDocumentId
  • Question: This is the variable of the question that was initially asked by the user.

The Submit QnA Question Suggestion badge will automatically be awarded when this action is called from a logged-in Tenjin User.

Query Documents 

The search capabilities of the Query Documents flow action allow flow developers to select what content is searched, whether that's the file's content, associated keywords, and/or the filename. This update has been made following customer feedback, utilizing search results from their documents, and a better understanding of where improvements can be made.

Flow Action Update

  • Query Documents - New search criteria options added: file content, keywords, filename, and description.

Get Document Content

Returning the full contents of a document returned by a knowledge search has been made possible by the introduction of the new Get Document Content flow action. At present, the query documents flow action will return an excerpt of a document stored within the assistant's document search skill, along with its filename, and this new action gives the flow developer the capability to return the full contents of the document by simply supplying its filename to the new action. The contents of the document are returned as a string and stored within the specified variable for use later.

Detailed inline help is available which includes file sizes. 

Query Expert Assist

The Query Expert Assist flow action allows searching of Expert Assist questions, saving the result into the specified variable. The data returned will also include any answers stored against the question.

  • Query: This expression must start with an = then use the (x) button above the entry box to insert the variable required.
  • Take (optional): Number expression defining the number of results to return. When supplied, this value must be between 1 and 50, defaults to 15.

Example results can be found within the inline help. 

Get Expert Assist Question & Answers

The Get Expert Assist Question & Answers flow action will get a single Expert Assist question using the configured questionId and save the result into the specified variable. The data returned will also include any answers stored against the question.

  • QuestionId: This expression must start with an = then use the (x) button above the entry box to insert the variable required

Example results can be found within the inline help. 

Create Expert Assist Question

The Create Expert Assist Question flow action will create a new question with the provided question text. As part of creating the question, you also have the ability to assign one or more tags to it as an array of values; the tags will be used in the workspace to filter the questions. The tags can either be assigned manually, via the Assign Variables flow action, or by sourcing the relevant tags using the Get Experts flow action. You also can add pairs of metadata to the question. This can help (but not limited to) capture information from unregistered / anonymous users. Metadata created here will be passed through in the Get Expert Assist Question and Answers action.  

Upon success, the flow action will return the numerical ID of the question created.

The Create Expert Assist Question badge will automatically be awarded when this action is called from a logged-in Tenjin User.

Create Expert Assist Answer

The Create Expert Assist Answer flow action will store the supplied answer text against an existing question, defined by its numerical ID.

Upon success, the flow action will return the numerical ID of the answer created.

The Create Expert Assist Answer badge will automatically be awarded when this action is called from a logged-in Tenjin User.

Get Experts

The Get Experts flow action takes a piece of text, such as a question from a user, and analyses it for Expert Assist tags and keywords. It returns an object containing the related tags and the user IDs of experts linked to those tags.

  1. Text: A piece of text to analyze for tags and experts. 
  2. Result: The flow action returns an object with the following properties:
    TenjinUserIds: An array of expert IDs (Tenjin users) who are linked to the matching tags.
    Tags: An array of the matching tags and their associated experts. 

An example of the object returned is available within the inline help. 

Follow Expert Assist Question

Set the logged-in user as a follower to the specified question so that they receive a notification each time the question receives a new answer.

Unfollow Expert Assist Question

Unfollow Expert Assist Question - Remove the logged-in user as a follower for the specified question so that they no longer receive notifications.

Share this article

Comments

0 comments

Article is closed for comments.