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. 

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.

Query Document Chunks

Enhances the search by utilising machine learning to improve its understanding of the question being asked along with the information within the documents uploaded.

• By utilising machine learning and searching over each document in small sections, this search has an improved understanding of both the question and documents stored, allowing it to return more accurate results with part of the document's content along with a link to the file where the content was found.

Query Documents Using AI

This flow action enables follow-up questions to be asked from the content returned. The search attempts to provide a textual answer to the question, not just a link to a document, replicating how two people would converse.

• Returns relevant contextual information from the documents stored that answers the question asked. The flow action attempts to answer the question in a conversational way, rather than simply providing a copy of the document's content, with the added benefit of the user being able to ask follow-up questions, just like we would in real life, with the goal of getting the perfect answer to their question.

LLM Skill Document Search

Returns relevant contextual information from the documents stored by utilising an LLM configuration within the assistant's LLM skill. Like the above flow action, the user can ask follow-up questions, just like we would in real life, with the goal of getting the perfect answer to their question.

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 question ID and save the result into the specified variable. The data returned will also include any answers stored against the question.

• Question ID: 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 analyse 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 removes the logged-in user as a follower for the specified question so that they no longer receive notifications.