Eszközök áttekintése

Minden eszköz implementálja a tool.Tool felületet:

type Tool interface {
    Name() string
    Description() string
}

A függvényeszközök emellett implementálják tool.FuncToola következőt:

import "context"

type FuncTool interface {
    Tool
    Schema() any
    ReturnSchema() any
    Call(ctx context.Context, arguments string) (any, error)
}

A legtöbb alkalmazás közvetlenül a functool.Newfunctool.MustNew implementálás FuncTool helyett függvényeszközöket hoz létre. A keretrendszer a Go-függvény aláírásával vagy strukturálási címkék használatával hozza létre a modell számára elérhető sémát.

Eszközök átadása az ügynöknek a következőn keresztül agent.Config.Tools:

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

Vagy adjon hozzá futtatásonként eszközöket:

resp, err := a.RunText(ctx, "What's the weather?", agent.WithTool(weatherTool)).Collect()

Go esetén jelölj meg egy visszavonhatatlan eszközt tool.ApprovalRequiredFunc egy már implementálható eszközzel, vagy használjon olyan eszközt, amely már implementálható tool.ApprovalRequiredTool, például a helyi rendszerhéj-eszközt. A jóváhagyási kérelmek és válaszok automatikusan meghívják a köztes szoftvereket, így a helyi függvényhívásokat visszaadó szolgáltatókkal működnek együtt.

Szolgáltatói támogatási mátrix

Az OpenAI és Azure OpenAI-szolgáltatók mindegyike két ügyféltípust kínál – a Válaszokat és a Csevegés befejezését – különböző eszközképességekkel. Az Azure OpenAI-ügyfelek az OpenAI-ekvivalenseiket tükrözik. Copilot Studio és A2A ügynökök távoli szolgáltatáson futnak, így képességeik az Ügynökkeret-ügyfél helyett a távoli ügynökön vannak konfigurálva – nem szerepelnek a mátrixban.

Szolgáltatói támogatási mátrix

Az OpenAI és az Azure OpenAI-szolgáltatók mindegyike több ügyféltípust kínál különböző eszközképességekkel. Az Azure OpenAI-ügyfelek az OpenAI-ekvivalenseiket tükrözik. Az Foundry oszlop a következőre vonatkozik FoundryChatClient : az FoundryAgenteszközök az Foundry-ügynök definícióján vannak konfigurálva (lásd: Mi működik és mi nem működik).FoundryAgent Copilot Studio és A2A ügynökök távoli szolgáltatáson futnak, így képességeik az Ügynökkeret-ügyfél helyett a távoli ügynökön vannak konfigurálva – nem szerepelnek a mátrixban.

¹ A kiválasztott helyi modell támogató függvényhívásától függ. ² Beépített a GitHub Copilot CLI-futtatókörnyezetbe, amelyet egy engedélykezelő vezet. Más felület, mint az OpenAI-é get_shell_tool.

Szolgáltatói támogatási mátrix

A Go SDK Microsoft Foundryt foundryprovider és OpenAI/Azure OpenAI-t openaiprovidertesz elérhetővé. Az tool/hostedtool üzemeltetett eszközök deklarációk: a Go SDK elküldi őket a szolgáltatónak, és a szolgáltató dönti el, hogy elérhető-e az üzemeltetett képesség.

Meghívhat .AsAIFunction() egy olyan AIAgent függvényeszközt, amely egy másik ügynöknek adható:

// Create the inner agent with its own tools
AIAgent weatherAgent = new AIProjectClient(
    new Uri("<your-foundry-project-endpoint>"),
    new DefaultAzureCredential())
     .AsAIAgent(
        model: "gpt-4o-mini",
        instructions: "You answer questions about the weather.",
        name: "WeatherAgent",
        description: "An agent that answers questions about the weather.",
        tools: [AIFunctionFactory.Create(GetWeather)]);

// Create the main agent and provide the inner agent as a function tool
AIAgent agent = new AIProjectClient(
    new Uri("<your-foundry-project-endpoint>"),
    new DefaultAzureCredential())
     .AsAIAgent(
        model: "gpt-4o-mini",
        instructions: "You are a helpful assistant.",
        tools: [weatherAgent.AsAIFunction()]);

// The main agent can now call the weather agent as a tool
Console.WriteLine(await agent.RunAsync("What is the weather like in Amsterdam?"));

Hívja meg .as_tool() az ügynököt, hogy átalakítsa egy másik ügynöknek adható függvényeszközzé:

import os
from agent_framework.openai import OpenAIChatCompletionClient
from azure.identity import AzureCliCredential

# Create the inner agent with its own tools
weather_agent = OpenAIChatCompletionClient(
    model=os.environ["AZURE_OPENAI_CHAT_COMPLETION_MODEL"],
    azure_endpoint=os.environ["AZURE_OPENAI_ENDPOINT"],
    api_version=os.getenv("AZURE_OPENAI_API_VERSION"),
    credential=AzureCliCredential(),
).as_agent(
    name="WeatherAgent",
    description="An agent that answers questions about the weather.",
    instructions="You answer questions about the weather.",
    tools=get_weather
)

# Create the main agent and provide the inner agent as a function tool
main_agent = OpenAIChatCompletionClient(
    model=os.environ["AZURE_OPENAI_CHAT_COMPLETION_MODEL"],
    azure_endpoint=os.environ["AZURE_OPENAI_ENDPOINT"],
    api_version=os.getenv("AZURE_OPENAI_API_VERSION"),
    credential=AzureCliCredential(),
).as_agent(
    instructions="You are a helpful assistant.",
    tools=weather_agent.as_tool()
)

# The main agent can now call the weather agent as a tool
result = await main_agent.run("What is the weather like in Amsterdam?")
print(result.text)

Az eszköz nevét, leírását és argumentumnevét testre is szabhatja:

weather_tool = weather_agent.as_tool(
    name="WeatherLookup",
    description="Look up weather information for any location",
    arg_name="query",
    arg_description="The weather query or location"
)

Az ügynök burkolása agenttool.New egy másik ügynök számára való elérhetővé tool.FuncTool tétele érdekében:

import (
    "github.com/microsoft/agent-framework-go/agent"
    "github.com/microsoft/agent-framework-go/provider/foundryprovider"
    "github.com/microsoft/agent-framework-go/tool"
    "github.com/microsoft/agent-framework-go/tool/agenttool"
)

weatherAgent := foundryprovider.NewAgent(endpoint, token, foundryprovider.ModelDeployment(model), foundryprovider.AgentConfig{
    Instructions: "You answer questions about the weather.",
    Config: agent.Config{
        Name:        "WeatherAgent",
        Description: "An agent that answers weather questions.",
        Tools:       []tool.Tool{weatherTool},
    },
})

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

resp, err := mainAgent.RunText(ctx, "Should I bring an umbrella to Amsterdam?").Collect()

Ugyanezt a burkolt ügynököt az MCP-vel mcptool.AddToolis elérhetővé teheti, mivel agenttool.New függvényeszközt ad vissza.