Update Ollama Microsoft.Extensions.AI integration documentation to use current recommended patterns (#4145)

* Initial plan

* Update Ollama Microsoft.Extensions.AI integration to use current recommended patterns

Co-authored-by: IEvangelist <[email protected]>

* Fix Microsoft.Extensions.AI reference to include NuGet package link

Co-authored-by: IEvangelist <[email protected]>

* Update method references to use xrefs for better documentation linking

Co-authored-by: gewarren <[email protected]>

* Improve readability by wrapping xref links in parentheses

Co-authored-by: gewarren <[email protected]>

* Revert xref changes from 48b1cd6 as those APIs don't exist in documentation

Co-authored-by: IEvangelist <[email protected]>

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: IEvangelist <[email protected]>
Co-authored-by: gewarren <[email protected]>

Author: 3 people

docs/community-toolkit/ollama.md

@@ -194,10 +194,20 @@ Then the connection string will be retrieved from the `ConnectionStrings` config
 
 ### Integration with `Microsoft.Extensions.AI`
 
-The Microsoft.Extensions.AI library provides an abstraction over the Ollama client API, using generic interfaces. OllamaSharp supports these interfaces, and they can be registered using the `AddOllamaSharpChatClient` and `AddOllamaSharpEmbeddingGenerator` extension methods. These methods will also register the `IOllamaClientApi` instances with the dependency injection container, and have keyed versions for multiple instances.
+The [📦 Microsoft.Extensions.AI](https://www.nuget.org/packages/Microsoft.Extensions.AI) NuGet package provides an abstraction over the Ollama client API, using generic interfaces. OllamaSharp supports these interfaces, and they can be registered by chaining either the <xref:Microsoft.Extensions.AI.IChatClient> or <xref:Microsoft.Extensions.AI.IEmbeddingGenerator`2> registration methods to the `AddOllamaClientApi` method.
+
+To register an `IChatClient`, chain the `AddChatClient` method to the `AddOllamaClientApi` method:
+
+```csharp
+builder.AddOllamaClientApi("llama")
+       .AddChatClient();
+```
+
+Similarly, to register an `IEmbeddingGenerator`, chain the `AddEmbeddingGenerator` method:
 
 ```csharp
-builder.AddOllamaSharpChatClient("llama");
+builder.AddOllamaClientApi("llama")
+       .AddEmbeddingGenerator();
 ```
 
 After adding `IChatClient` to the builder, you can get the `IChatClient` instance using dependency injection. For example, to retrieve your context object from service:
@@ -209,6 +219,28 @@ public class ExampleService(IChatClient chatClient)
 }
 ```
 
+### Add keyed Microsoft.Extensions.AI clients
+
+There might be situations where you want to register multiple AI client instances with different connection names. To register keyed AI clients, use the keyed versions of the registration methods:
+
+```csharp
+builder.AddOllamaClientApi("chat")
+       .AddKeyedChatClient("chat");
+builder.AddOllamaClientApi("embeddings")
+       .AddKeyedEmbeddingGenerator("embeddings");
+```
+
+Then you can retrieve the AI client instances using dependency injection. For example, to retrieve the clients from an example service:
+
+```csharp
+public class ExampleService(
+    [FromKeyedServices("chat")] IChatClient chatClient,
+    [FromKeyedServices("embeddings")] IEmbeddingGenerator<string, Embedding<float>> embeddingGenerator)
+{
+    // Use AI clients...
+}
+```
+
 ## See also
 
 - [Ollama](https://ollama.com)