Table of contents
Last Updated: 12/13/2016

You must apply to join the Cortana Developer Preview Program to create and use a Cortana skill.
Enroll in the Cortana developer preview today.

Insights

An insight is a specific piece of info about a user that the user has given Cortana permission to access. Insights, based on user context, trigger the appearance of a Cortana skill, and include contextual data that you can pass to your app at runtime (through the skill deep link).

All insights associated with a Cortana skill must be true for the skill to be presented to a user.

You specify the insights (and corresponding data) associated with a skill in the Cortana skill developer preview dashboard.

Meeting During Lunch

Activation Requirements

This insight triggers an associated skill when the user:

  • Permits Cortana to read their calendar data
  • Specifies their typical lunch time in the Cortana Notebook
  • Has a meeting that starts, ends, or occurs during their next lunch time

This insight does not trigger a skill for the scheduled lunch after the scheduled lunch time.

Insight data

NameDescriptionData TypeExamples
MeetingDuringLunch.TitleThe title of the meeting during lunchString"Lunch with Jen"
MeetingDuringLunch.StartTimeUtcThe start time of the meeting, shifted to the GMT+0 timezone.int130997856000000000
MeetingDuringLunch.MeetingTimezoneOffsetThe meeting time offset, formatted TBD finish how this is formattedint-480
MeetingDuringLunch.EndTimeUtcThe end time of the meeting, shifted to the GMT+0 timezone.int130997862000000000
MeetingDuringLunch.Location.FormattedAddressThe location of the meeting as specified in the meeting invite.String"Bellevue, WA", "Conf Room City Center/2311"


Current Meeting

This insight triggers an associated skill when the user:

  • Permits Cortana to read their calendar data
  • Is currently in the meeting specified by the calendar

Insight Data

NameDescriptionData TypeExamples
CurrentMeeting.TitleThe name of the meeting the user is currently in, as specified by the meeting inviteString"Daily Standup", "Sync on developer center"
CurrentMeeting.StartTimeUtcThe start time of the meeting, shifted to the GMT+0 timezone.int130997856000000000
CurrentMeeting.MeetingTimezoneOffsetThe meeting time offset, formatted TBD finish how this is formattedint-480
CurrentMeeting.EndTimeUtcThe end time of the meeting, shifted to the GMT+0 timezone.int130997862000000000
CurrentMeeting.AttendeesEmailsThe list of people invited to the meeting.Comma-separated Strings"x@microsoft.com", "a@contoso.com,b@northwind.org"
CurrentMeeting.Location.FormattedAddressThe location of the meeting as specified in the calendar inviteString"Bellevue, WA", "Conf Room City Center/2311"


Next Meeting

This insight triggers an associated skill when the user:

  • Permits Cortana to read their calendar data
  • Has an upcoming meeting on the calendar

Insight Data

NameDescriptionData TypeExamples
NextMeeting.TitleThe name of the meeting the user is currently in, as specified by the meeting inviteString"Daily Standup", "Sync on developer center"
NextMeeting.StartTimeUtcThe start time of the meeting, shifted to the GMT+0 timezone.int130997856000000000
NextMeeting.MeetingTimezoneOffsetThe meeting time offset, formatted TBD finish how this is formattedint-480
NextMeeting.EndTimeUtcThe end time of the meeting, shifted to the GMT+0 timezone.int130997862000000000
NextMeeting.AttendeesEmailsThe list of people invited to the meeting.Comma-separated Strings"x@microsoft.com", "a@contoso.com,b@northwind.org"


Meeting Conflict

This insight triggers an associated skill when the user:

  • Permits Cortana to read their calendar data
  • Has overlapping meeting times

Insight Data

NameDescriptionData TypeExamples
ConflictMeeting.TitleThe name of the meeting the user is currently in, as specified by the meeting inviteString"Daily Standup", "Sync on developer center"
ConflictMeeting.StartTimeUtcThe start time of the meeting, shifted to the GMT+0 timezone.int130997856000000000
ConflictMeeting.MeetingTimezoneOffsetThe meeting time offset, formatted TBD finish how this is formattedint-480
ConflictMeeting.EndTimeUtcThe end time of the meeting, shifted to the GMT+0 timezone.int130997862000000000
ConflictMeeting.Location.FormattedAddressThe location of the meeting as specified in the calendar inviteString"Bellevue, WA", "Conf Room City Center/2311"


Early Meeting

This insight triggers an associated skill when the user:

  • Permits Cortana to read their calendar data
  • Has established a daily routine with Cortana
  • Has a meeting scheduled for when they typically wake up in the morning

Insight Data

NameDescriptionData TypeExamples
EarlyMeeting.TitleThe name of the meeting the user is currently in, as specified by the meeting inviteString"Daily Standup", "Sync on developer center"
EarlyMeeting.StartTimeUtcThe start time of the meeting, shifted to the GMT+0 timezone.int130997856000000000
EarlyMeeting.MeetingTimezoneOffsetThe meeting time offset, formatted TBD finish how this is formattedint-480
EarlyMeeting.EndTimeUtcThe end time of the meeting, shifted to the GMT+0 timezone.int130997862000000000
EarlyMeeting.Location.FormattedAddressThe location of the meeting as specified in the calendar inviteString"Bellevue, WA", "Conf Room City Center/2311"


Late Meeting

This insight triggers an associated skill when the user:

  • Permits Cortana to read their calendar data
  • Has established a daily routine with Cortana
  • Has a meeting scheduled for when they typically go to sleep

Insight Data

NameDescriptionData TypeExamples
LateMeeting.TitleThe name of the meeting the user is currently in, as specified by the meeting inviteString"Daily Standup", "Sync on developer center"
LateMeeting.StartTimeUtcThe start time of the meeting, shifted to the GMT+0 timezone.int130997856000000000
LateMeeting.MeetingTimezoneOffsetThe meeting time offset, formatted TBD finish how this is formattedint-480
LateMeeting.EndTimeUtcThe end time of the meeting, shifted to the GMT+0 timezone.int130997862000000000
LateMeeting.Location.FormattedAddressThe location of the meeting as specified in the calendar inviteString"Bellevue, WA", "Conf Room City Center/2311"


Meeting During Commute

This insight triggers an associated skill when the user:

  • Permits Cortana to read their calendar data
  • Has added home and work locations to the Cortana Notebook
  • Has established a daily routine with Cortana for when they arrive at work

Insight Data

NameDescriptionData TypeExamples
MeetingDuringCommute.TitleThe name of the meeting the user is currently in, as specified by the meeting inviteString"Daily Standup", "Sync on developer center"
MeetingDuringCommute.StartTimeUtcThe start time of the meeting, shifted to the GMT+0 timezone.int130997856000000000
MeetingDuringCommute.MeetingTimezoneOffsetThe meeting time offset, formatted TBD finish how this is formattedint-480
MeetingDuringCommute.EndTimeUtcThe end time of the meeting, shifted to the GMT+0 timezone.int130997862000000000
MeetingDuringCommute.Location.FormattedAddressThe location of the meeting as specified in the calendar inviteString"Bellevue, WA", "Conf Room City Center/2311"


Leaving Home

This insight triggers an associated skill when the user:

  • Permits Cortana to track their location
  • Has added a home location to the Cortana Notebook
  • Exits their home geo-fence

Insight Data

NameDescriptionData TypeExamples
LeavingHome.HomeLocation.DepartureTimeTBDTBDTBD
LeavingHome.HomeLocation.ReturnProbabilityTBDTBDTBD
LeavingHome.HomeLocation.LongitudeTBDTBDTBD
LeavingHome.HomeLocation.LatitudeTBDTBDTBD
LeavingHome.Destination.LocationTypeTBDTBDTBD
LeavingHome.Destination.LongitudeTBDTBDTBD
LeavingHome.Destination.LatitudeTBDTBDTBD


Leaving Work

This insight triggers an associated skill when the user:

  • Permits Cortana to track their location
  • Has added a work location to the Cortana Notebook
  • Exits their work geo-fence

Insight Data

NameDescriptionData TypeExamples
LeavingWork.WorkLocation.DepartureTimeTBDTBDTBD
LeavingWork.WorkLocation.ReturnProbabilityTBDTBDTBD
LeavingWork.WorkLocation.LongitudeTBDTBDTBD
LeavingWork.WorkLocation.LatitudeTBDTBDTBD
LeavingWork.Destination.LocationTypeTBDTBDTBD
LeavingWork.Destination.LongitudeTBDTBDTBD
LeavingWork.Destination.LatitudeTBDTBDTBD


Arriving Home

This insight triggers an associated skill when the user:

  • Permits Cortana to track their location
  • Has added a home location to the Cortana Notebook
  • Enters their home geo-fence

Insight Data

NameDescriptionData TypeExamples
ArrivingAtHome.HomeLocation.DepartureTimeTBDTBDTBD
ArrivingAtHome.HomeLocation.ReturnProbabilityTBDTBDTBD
ArrivingAtHome.HomeLocation.LongitudeTBDTBDTBD
ArrivingAtHome.HomeLocation.LatitudeTBDTBDTBD
ArrivingAtHome.Destination.LocationTypeTBDTBDTBD
ArrivingAtHome.Destination.LongitudeTBDTBDTBD
ArrivingAtHome.Destination.LatitudeTBDTBDTBD


Arriving at Work

This insight triggers an associated skill when the user:

  • Permits Cortana to track their location
  • Has added a work location to the Cortana Notebook
  • Enters their work geo-fence

Insight Data

NameDescriptionData TypeExamples
ArrivingAtWork.WorkLocation.DepartureTimeTBDTBDTBD
ArrivingAtWork.WorkLocation.ReturnProbabilityTBDTBDTBD
ArrivingAtWork.WorkLocation.LongitudeTBDTBDTBD
ArrivingAtWork.WorkLocation.LatitudeTBDTBDTBD
ArrivingAtWork.Destination.LocationTypeTBDTBDTBD
ArrivingAtWork.Destination.LongitudeTBDTBDTBD
ArrivingAtWork.Destination.LatitudeTBDTBDTBD


© 2017 Microsoft