Add ability to read outlook emails to EmailSkill

[sw47]

Motivation and Context

1. Why is this change required?

Today, there is no ability to get outlook email contents in SK.

2. What problem does it solve?

Ability to get outlook email contents in SK.

3. What scenario does it contribute to?

Ability to get specific emails from one's outlook inbox and perform actions (i.e. additional skills)

Description

Add the ability to read outlook email contents to SK Skill.
Currently, this PR is in Draft state - please see the comments for questions on design/intention.

I will add full UT once those questions have been resolved.

Contribution Checklist

• The code builds clean without any errors or warnings
• The PR follows SK Contribution Guidelines (https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md)
• The code follows the .NET coding conventions (https://learn.microsoft.com/dotnet/csharp/fundamentals/coding-style/coding-conventions) verified with dotnet format
• All unit tests pass, and I have added new tests where possible
• I didn't break anyone 😄

[sw47]

I would like to return an object collection (Email) from the skill but the only examples I have seen are all string's returned by the Skill. I'm not sure if that is by design the the contract for Skills can ultimately only return string to represent raw text.

For example I see the OrgHierarchy connector:

semantic-kernel/dotnet/src/SemanticKernel.Skills/Skills.MsGraph/Connectors/OrganizationHierarchyConnector.cs

Line 40 in ed9f38f

public async Task<IEnumerable<string>> GetDirectReportsEmailAsync(CancellationToken cancellationToken = default)

return a IEnumerable but no corresponding Skill for that function:

semantic-kernel/dotnet/src/SemanticKernel.Skills/Skills.MsGraph/OrganizationHierarchySkill.cs

Line 13 in ed9f38f

public class OrganizationHierarchySkill

Would be great to get some clarity here.

@craigomatic for your input, please feel free to tag others.

[sw47]

My use case is for each email, run an additional classification skill on email attributes (e.g. email subject, email body, etc.) and then possibly either generate a auto-respond email or further actions (e.g. add reminder, etc.)

I think the consumer of this skill would want full access to a concrete Email object that encapsulates the aforementioned attributes but I understand/think the intention SKContext to to generically encapsulate the info I need in the most generic way (i.e. string) so I'm not sure what is the best way to go about my problem. Would appreciate some tips :) @craigomatic and other folks

[MovGP0]

I recommend using the int.TryParse() methods and consider the locale settings of the user using the CultureInfo class. The vast majority of people are not from the U.S.A.

[adrianwyatt]

FYI - we'll be bringing in this feature this week. I'll link to the PR when it get created before closing this PR.

[adrianwyatt]

#801