Semantic kernel model adapter

[lspinheiro]

Why are these changes needed?

Related issue number

Checks

• I've included any doc changes needed for https://microsoft.github.io/autogen/. See https://microsoft.github.io/autogen/docs/Contribute#documentation to build and test documentation locally.
• I've added tests (if relevant) corresponding to the changes introduced in this PR.
• I've made sure all auto checks have passed.

[ekzhu]

I can see it is going to be useful for integrating with non-openai APIs such as Gemini and Mistral, using SK's large ecosystem of connectors. Could you show a few examples of such in the API documentation? This way users can take away a clear picture of why this model adapter is useful.

[codecov]

Codecov Report

Attention: Patch coverage is 81.44330% with 36 lines in your changes missing coverage. Please review.

Project coverage is 70.15%. Comparing base (9b1260d) to head (0402136).
Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
...els/semantic_kernel/_sk_chat_completion_adapter.py	81.59%	30 Missing ⚠️
...ools/semantic_kernel/_kernel_function_from_tool.py	77.77%	6 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4851      +/-   ##
==========================================
+ Coverage   69.95%   70.15%   +0.20%     
==========================================
  Files         168      172       +4     
  Lines       10716    10910     +194     
==========================================
+ Hits         7496     7654     +158     
- Misses       3220     3256      +36     

Flag	Coverage Δ
unittests	70.15% <81.44%> (+0.20%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[jackgerrits]

Looks good! If you have a chance could you just add the relevant tool and model pages here so that the API reference docs show up https://github.com/microsoft/autogen/tree/main/python/packages/autogen-core/docs/src/reference/python

We can always do it post merge if you'd rather just get this in to avoid conficts

[ekzhu]

Doc headings underlines need to be the same length as the title 😁

[lspinheiro]

@jackgerrits @ekzhu , I added autodoc_pydantic_model_show_json_error_strategy = "coerce" to conf.py. I had some issues with non-serializable pydantic attributes coming from SK which generated issues in the json schema generation of the docs. Updating to coerce seemed reasonable: https://autodoc-pydantic.readthedocs.io/en/stable/users/configuration.html

Let me know if you see any issues and I can revert it later.