Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add skills navigator FAQ with breadcrumb & TOC #1052

Merged
merged 14 commits into from
Oct 4, 2024
26 changes: 14 additions & 12 deletions .openpublishing.publish.config.json
Original file line number Diff line number Diff line change
@@ -1,17 +1,5 @@
{
"docsets_to_publish": [
{
"docset_name": "ai-navigator",
"build_source_folder": "ai-navigator",
"build_output_subfolder": "ai-navigator",
"locale": "en-us",
"monikers": [],
"open_to_public_contributors": true,
"type_mapping": {
"Conceptual": "Content"
},
"build_entry_point": "docs"
},
{
"docset_name": "ContributionGuide",
"build_source_folder": "Contribute",
Expand All @@ -32,6 +20,20 @@
},
"build_entry_point": "docs",
"template_folder": "_themes"
},
{
"docset_name": "ai-navigator",
"build_source_folder": "ai-navigator",
"build_output_subfolder": "ai-navigator",
"locale": "en-us",
"monikers": [],
"moniker_ranges": [],
"open_to_public_contributors": false,
"type_mapping": {
"Conceptual": "Content"
},
"build_entry_point": "docs",
"template_folder": "_themes"
}
],
"notification_subscribers": [],
Expand Down
4 changes: 2 additions & 2 deletions ai-navigator/TOC.yml
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
- name: Index
href: index.md
- name: Artificial Intelligence (AI) skills navigator
href: index.yml
3 changes: 0 additions & 3 deletions ai-navigator/breadcrumb/ai-navigator/toc.yml

This file was deleted.

4 changes: 4 additions & 0 deletions ai-navigator/breadcrumb/toc.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
items:
- name: Artificial Intelligence
tocHref: /ai/
topicHref: /ai
12 changes: 8 additions & 4 deletions ai-navigator/docfx.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@
"**/obj/**",
"**/includes/**",
"_themes/**",
"_themes.pdf/**",
"**/docfx.json",
"_repo.en-us/**",
"README.md",
Expand All @@ -30,6 +31,7 @@
"**/obj/**",
"**/includes/**",
"_themes/**",
"_themes.pdf/**",
"**/docfx.json",
"_repo.en-us/**"
]
Expand All @@ -38,11 +40,13 @@
"overwrite": [],
"externalReference": [],
"globalMetadata": {
"breadcrumb_path": "~/breadcrumb/ai-navigator/toc.yml",
"breadcrumb_path": "/ai/breadcrumb/toc.json",
"feedback_system": "Standard",
"permissioned-type": "public"
"permissioned-type": "public",
"uhfHeaderId": "ai"
},
"fileMetadata": {},
"template": []
"template": [],
"dest": "ai-navigator"
}
}
}
1 change: 0 additions & 1 deletion ai-navigator/index.md

This file was deleted.

42 changes: 42 additions & 0 deletions ai-navigator/index.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
### YamlMime:FAQ
metadata:
title: "AI Skills Navigator: FAQ"
description: "A Frequently Asked Questions (FAQ) page for the AI Skills Navigator."
author: bmackinney
ms.author: miriam.brady
ms.service: artificial-intelligence
ms.topic: faq #Don't change.
ms.date: 10/03/2024

title: "AI Skills Navigator: FAQ"

sections:
- name: What is the AI Skills Navigator?
questions:
- question: What is the AI Skills Navigator?
answer: |
The Skills for Social Impact team is building an AI Skills Navigator, an AI assistant designed to direct learners to learning pathways and resources. Users will provide information about their role, expertise level and what they are interested in learning and the navigator will recommend learning pathways. Alternatively, there will be an option to simply ask the AI Skills Navigator a question and it will leverage the skilling pathways and resources it has in its data set to respond or recommend learning.

- question: What can the AI Skills Navigator do?
answer: |
The AI Skills Navigator, through AI technology, surfaces answers to questions and suggested learning paths based on input from a learner. These are based on a library of learning paths developed by Microsoft and its partners.

- question: What is/are the AI Skills Navigator’s intended use(s)?
answer: |
The intended use of the AI Skills Navigator is to surface learning paths or information from those learning paths that are most relevant to the learner based on their input with the intention to help the learner gain skills in AI. This is done through an AI-powered assistant.

- question: How was the AI Skills Navigator evaluated? What metrics are used to measure performance?
answer: |
The AI Skills Navigator has been tested manually and evaluated qualitatively by multiple human testers and subject matter experts, both inside and outside the organization. All grounding data is publicly available and vetted by a Microsoft content team. More evaluation was performed over custom datasets for offensive and malicious prompts (user questions) and responses. In addition, the AI Skills Navigator is continuously evaluated by human testers to ensure it continues to perform at expected levels.

- question: What are the limitations of the AI Skills Navigator? How can users minimize the impact of the AI Skills Navigator’s limitations when using the system?
answer: |
The AI Skills Navigator is focused on surfacing resources for gaining AI skills. Therefore, users should focus their questions to the AI assistant on that subject area. It will not be able to answer questions related to other subject areas.

- question: What operational factors and settings allow for effective and responsible use of the AI Skills Navigator?
answer: |
The system does not allow customization. Users should leverage their browser settings to ensure the best experience for this site and others.

- question: What data is collected by the AI Skills Navigator?
answer: |
The only data collected by the AI Skills Navigator is the information users enter into the chatbot. This data is used for training for the AI and will not be used for any other purpose.