Connect Your Agent to External Tools Done

dotnet add package Microsoft.Agents.AI.OpenAI
dotnet add package OpenAI
dotnet add package Microsoft.Extensions.AI
dotnet restore

dotnet add package Microsoft.Agents.AI.OpenAI
dotnet add package Azure.AI.OpenAI
dotnet add package Microsoft.Extensions.AI
dotnet restore

using System.ComponentModel;
using OpenAI;
using System.ClientModel;
using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;
using OpenAI.Chat;

// 1. Configure the Provider
var endpoint = Environment.GetEnvironmentVariable("OPENAI_ENDPOINT") ?? "http://localhost:1234/v1";
var modelName = Environment.GetEnvironmentVariable("OPENAI_MODEL_NAME") ?? "google/gemma-4-e4b";
var chatClient = new OpenAIClient(new ApiKeyCredential("dummy"), new OpenAIClientOptions { Endpoint = new Uri(endpoint) })
    .GetChatClient(modelName);

// 2. Define the Tool
[Description("Gets the current health status for an enterprise service.")]
static string GetServiceStatus(
    [Description("The service name to check, such as checkout, payments, or inventory.")] string serviceName)
{
    return serviceName.ToLowerInvariant() switch
    {
        "checkout" => "Checkout is DEGRADED in West Europe. P P95 latency is 4.8s. Payment retries are elevated.",
        "payments" => "Payments is HEALTHY. No active regional alerts.",
        "inventory" => "Inventory is HEALTHY. Last sync 2 minutes ago.",
        _ => $"{serviceName} has no active status record in the demo store."
    };
}

// 3. Initialize the Agent with the Tool

AIAgent agent = chatClient.AsAIAgent(new ChatClientAgentOptions
{
    Name = "TriageAgent",
    ChatOptions = new()
    {
        Instructions = """
        You are an enterprise incident triage assistant.
        Summarize the incident, identify likely severity, 
        and suggest the next investigation step.

        IMPORTANT:
        - You MUST use the provided service status tools to verify the health of any service mentioned in the incident.
        - Do NOT guess the status of a service. 
        - Always base your triage on the grounded data returned by your tools.

        Keep answers concise and operational.
        """,
        Tools = [AIFunctionFactory.Create(GetServiceStatus, "GetServiceStatus")]
    }
});

// 4. Define the Task
var incident = """
We have reports of checkout failures. 
Can you check the status of the checkout service and summarize the impact?
""";

// 5. Run and Stream
Console.WriteLine("Agent reasoning and responding...");
await foreach (var update in agent.RunStreamingAsync(incident))
{
    Console.Write(update);
}
Console.WriteLine();

using System.ComponentModel;
using Azure.AI.OpenAI;
using Azure.Identity;
using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;
using OpenAI.Chat;

// 1. Configure the Provider
var endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")!;
var deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")!;

// 2. Define the Tool
[Description("Gets the current health status for an enterprise service.")]
static string GetServiceStatus(
    [Description("The service name to check, such as checkout, payments, or inventory.")] string serviceName)
{
    return serviceName.ToLowerInvariant() switch
    {
        "checkout" => "Checkout is DEGRADED in West Europe. P95 latency is 4.8s. Payment retries are elevated.",
        "payments" => "Payments is HEALTHY. No active regional alerts.",
        "inventory" => "Inventory is HEALTHY. Last sync 2 minutes ago.",
        _ => $"{serviceName} has no active status record in the demo store."
    };
}

// 3. Initialize the Agent with the Tool
var chatClient = new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential())
    .GetChatClient(deploymentName);

AIAgent agent = chatClient.AsAIAgent(new ChatClientAgentOptions
{
    Name = "TriageAgent",
    ChatOptions = new()
    {
        Instructions = """
        You are an enterprise incident triage assistant.
        Summarize the incident, identify likely severity, 
        and suggest the next investigation step.

        IMPORTANT:
        - You MUST use the provided service status tools to verify the health of any service mentioned in the incident.
        - Do NOT guess the status of a service. 
        - Always base your triage on the grounded data returned by your tools.

        Keep answers concise and operational.
        """,
        Tools = [AIFunctionFactory.Create(GetServiceStatus, "GetServiceStatus")]
    }
});

// 4. Define the Task
var incident = """
We have reports of checkout failures. 
Can you check the status of the checkout service and summarize the impact?
""";

// 5. Run and Stream
Console.WriteLine("Agent reasoning and responding...");
await foreach (var update in agent.RunStreamingAsync(incident))
{
    Console.Write(update);
}
Console.WriteLine();

Add a New Tool

Try adding a second tool to check the On-Call Engineer for a service.

[Description("Gets the name of the engineer currently on-call.")]
static string GetOnCallEngineer(
    [Description("The service name to check.")] string serviceName) => "Taylor Vance (@tvance)";

Update your AsAIAgent call to include it:

tools: [
    AIFunctionFactory.Create(GetServiceStatus,"GetServiceStatus"), 
    AIFunctionFactory.Create(GetOnCallEngineer,"GetOnCallEngineer")
]

Update your incident string to ask for the on-call contact:

var incident = """
Check checkout health and tell me who is on call.
""";

Result: The agent will now invoke both tools sequentially and mention Taylor Vance in its response.

Change the Status

Update the logic in your GetServiceStatus method to return a healthy result for the checkout service:

"checkout" => "Checkout is HEALTHY. No active regional alerts.",

Run the app again with the original incident query.

Result: Instead of escalating, the agent will report that the internal status is healthy and suggest investigating client-side issues or load balancer configurations.

Automate Tool Usage

You can force the agent to be proactive by updating the Persona. This ensures it always performs specific checks without being asked in every prompt.

Update the instructions to mandate the contact check:

instructions: """
You are a proactive SRE. 
For every service mentioned, you MUST check both its health AND the currently on-call engineer.
Always include the contact person in your summary.
"""

Revert your incident string to the simple version:

var incident = "Check checkout status.";

Result: Even without asking for the contact, the agent will automatically invoke both tools and provide the engineer’s name because the Persona mandates it.