Stap 2: Hulpmiddelen toevoegen

Met hulpprogramma's kan uw agent aangepaste functies aanroepen, zoals het ophalen van weergegevens, het uitvoeren van query's op een database of het aanroepen van een API.

Voordat u hulpprogramma's toevoegt, controleert u de best practices voor beveiliging bij goedkeuring van hulpprogramma's om te bepalen welke bewerkingen menselijke bevestiging nodig hebben.

Definieer een hulpprogramma als elke methode met een [Description] kenmerk:

using System.ComponentModel;

[Description("Get the weather for a given location.")]
static string GetWeather([Description("The location to get the weather for.")] string location)
    => $"The weather in {location} is cloudy with a high of 15°C.";

Maak een agent met het hulpprogramma:

using System;
using Azure.AI.Projects;
using Azure.Identity;
using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;

var endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
    ?? throw new InvalidOperationException("Set AZURE_OPENAI_ENDPOINT");
var deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME") ?? "gpt-4o-mini";

AIAgent agent = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential())
    .AsAIAgent(
        model: deploymentName,
        instructions: "You are a helpful assistant.",
        tools: [AIFunctionFactory.Create(GetWeather)]);

Warning

DefaultAzureCredential is handig voor ontwikkeling, maar vereist zorgvuldige overwegingen in de productieomgeving. Overweeg in productie een specifieke referentie te gebruiken (bijvoorbeeld ManagedIdentityCredential) om latentieproblemen, onbedoelde referentieprobing en potentiële beveiligingsrisico's van terugvalmechanismen te voorkomen.

De agent roept uw hulpprogramma automatisch aan wanneer dit relevant is:

Console.WriteLine(await agent.RunAsync("What is the weather like in Amsterdam?"));

Tip

Zie hier voor een volledig uitvoerbare voorbeeldtoepassing.

Het volledige voorbeeld definieert een hulpprogramma met de @tool decorator, maakt een agent met het hulpprogramma en voert de agent uit:

import asyncio

from agent_framework import Agent, tool
from agent_framework.foundry import FoundryChatClient
from azure.identity import AzureCliCredential


# This read-only sample tool can run without approval.
@tool(approval_mode="never_require")
def get_weather(location: str) -> str:
    """Get the weather for a given location."""
    return f"The weather in {location} is sunny."


async def main() -> None:
    agent = Agent(
        client=FoundryChatClient(
            project_endpoint="https://your-account.services.ai.azure.com/api/projects/your-project",
            model="gpt-6-luna",
            credential=AzureCliCredential(),
        ),
        instructions="Use the weather tool to answer questions.",
        tools=[get_weather],
    )
    print(await agent.run("What's the weather like in Seattle?"))


if __name__ == "__main__":
    asyncio.run(main())

Tip

Bekijk het volledige voorbeeld voor het volledige runnable bestand.

Een hulpprogramma definiëren met behulp van functool:

import (
    "context"
    "fmt"

    "github.com/microsoft/agent-framework-go/tool"
    "github.com/microsoft/agent-framework-go/tool/functool"
)

var weatherTool = functool.MustNew(functool.Config{
    Name:        "weather",
    Description: "Get the current weather for a given location",
}, func(_ context.Context, location string) (string, error) {
    return fmt.Sprintf("The weather in %s is cloudy with a high of 15°C.", location), nil
})

Maak een agent met het hulpprogramma:

a := foundryprovider.NewAgent(
    endpoint,
    token,
    foundryprovider.ModelDeployment(model),
    foundryprovider.AgentConfig{
        Instructions: "You are a helpful assistant",
        Config: agent.Config{
            Tools: []tool.Tool{weatherTool},
        },
    },
)

De agent roept uw hulpprogramma automatisch aan wanneer dit relevant is:

resp, err := a.RunText(ctx, "What is the weather like in Amsterdam?").Collect()
fmt.Println(resp, err)

Tip

Bekijk het volledige voorbeeld voor het volledige runnable bestand.

Volgende stappen 

Stap 3: Gesprekken met meerdere uitwisselingen

Ga dieper in:

  • Laatst bijgewerkt om