How can we help you?

Structural Agility: Ask AgilityAI

While using the Structural Agility Dashboard, a feature called Ask AgilityAI is available to dive deeper into your company's data. We're using Natural Language Query (NLQ) to retrieve data from your company's AgilityHealth database to respond to your questions. Learn about our dedication to Responsible AI.

Info: Ask AgilityAI is currently in beta and will be generally available for customers in June 2024.

Depending on your user role and permissions, Ask AgilityAI will only show you data for the teams you have access to view. 

After selecting the appropriate level in the left navigation, click the Ask AgilityAI box on the right of your screen. 

Screenshot 2023-10-31 at 7.34.34 AM.png

The Ask AgilityAI modal will open. You can see suggested questions in the blue boxes on the screen and simply click one of those to start your query. Click "Show all suggestions" to see more question options. You can also type a question in the "Ask a question about your data" box. Read more about how to do that here.

Remember, the data returned to you will be related to the level you selected in the left navigation and what your user permissions allow you to view. The level you selected will show in brackets at the top of the modal. In the example below, you can see the company level for A Global Financial was selected. 

Screenshot 2023-12-19 at 2.17.18 PM.png

In the below example, the "Who are the team members of Dons and Divas" box was clicked. You can see the result returned below.

Hovering over the information icon on the right tells you how AgilityInsights understands the question typed by the user. Reviewing this will help you understand how the model is querying your question in the backend and could be useful information to improve how you ask a question.

Screenshot 2023-10-31 at 8.31.06 AM.png

Search terms underlined in blue can easily be changed. To change what team you are searching for members on, change "Dons and Divas" in the search box to the team of your choice.

Put your cursor in the search box and click the X to clear the question and return to the menu of suggested questions.

Screenshot 2023-10-31 at 7.41.21 AM.png

We will enhance the list of suggested questions over time and would love your feedback to do that successfully. After asking a question, please give us a thumbs up or down in the lower-right corner of the modal and then click either "Tell us why" or "How could we improve" to provide details. 

Screenshot 2023-10-31 at 7.42.16 AM.png

Screenshot 2023-10-31 at 7.42.32 AM.pngScreenshot 2023-10-31 at 7.43.07 AM.png

How to ask questions

Ask AgilityAI will always try to answer your query but the language you use to ask your question matters. As you enter text for a question, Ask AgilityAI lets you know when it doesn't understand the question by underlining words with a red underline and will suggest a different way to word the question.

In this example, "Which teams have full-time employees" was searched. You can see red underlines under "full" and "employees" and some words in grey instead of black, signaling that Ask AgilityAI may not understand your question. 

Screenshot 2023-10-31 at 8.50.46 AM.png

When "employees" is clicked, two alternate suggestions are shown. Clicking "Which teams have full-time employee types" may yield a more accurate result.

Screenshot 2023-10-31 at 8.51.48 AM.png

Once the new query is selected, the results are updated in the modal. This looks like a better answer to the question but can still be refined so that the only Employment Type shown is for full-time employees or FTEs. 

Screenshot 2023-10-31 at 8.51.59 AM.png

To show just the teams that have team members marked with the FTE (full-time employees) tag, the question can be altered to "Which teams have FTE". The results shown are teams that roll up to the team in brackets at the top of the modal (AgilityHealth in this case) that have team members tagged with the FTE tag.

Screenshot 2023-10-31 at 8.52.14 AM.png

Suggested questions to ask

  • How has the size of my org changed?
  • Which roles are under-allocated and need attention? List roles and count of gaps.
  • Is the Developer role over-allocated on any teams? 
  • How many teams are currently over-allocated or under-allocated? List them.
  • How many teams have a collocated ratio >40% or a distributed ratio >40%?
  • What teams do Scrum Masters exist in?
  • What teams are supported by a Scrum Master?
  • Show team members in <<team_name>>
  • How many members exist as FTE and contractors in <<team_name>>?
  • Show the count of FTE and contractors in <<team_name>>
  • Show under-allocated roles in <<team name>>
  • Show all over-allocated roles in <<team name>
  • Show all distributed team members in <<team name>>
  • Show work type, team name, team members of all teams
  • Show team names and stability score for all teams
  • Show team names and stablity score where team name = <<xxxxx>> or stability score > 80%
  • How many test engineers exist in <<team name>>?
  • How many teams support the role of Scrum Master?
  • Show the work type for the <<team name>>
  • What is the team stability for the <<team name>>?
  • Show the under-allocated roles for <<team name>>


Here are some guidelines for using Ask AgilityAI:

  • Use clear language
    • Use simple, clear, concise language that accurately represents the data you want to retrieve.
    • Avoid using ambiguous or complex terms that might lead to misinterpretation.
  • Specify data
    • Clearly specify the type of data you want to retrieve, including the specific fields, metrics, or dimensions you are interested in.
  • Be specific
    • Include specific criteria, conditions, or filters that narrow down the data you want to see.
    • Use words like "where," "between," "under," "over," and other specific qualifiers to refine your query.
  • Avoid expressions
    • Minimize the use of technical expressions.
    • If technical terms are necessary, ensure that they are well-defined and commonly understood.
  • Use aggregates
    • Utilize words like "count", "average," "maximum," "minimum," and other aggregate functions to indicate the type of data analysis you require.
  • Ask simple questions
    • Break down complex questions into simpler parts to avoid confusion and ensure accurate results.
    • Ask one question at a time to maintain clarity and precision in your query.
  • Use proper synonyms
    • Use synonyms or words that are defined to get the correct answers. For example, to get a list of members, use team members or members.
Was this article helpful?
0 out of 0 found this helpful
    Download article


Please sign in to leave a comment.