Gambaran Umum Alat

Semua alat mengimplementasikan tool.Tool antarmuka:

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

Alat fungsi juga mengimplementasikan tool.FuncTool:

import "context"

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

Sebagian besar aplikasi membuat alat fungsi dengan functool.New atau functool.MustNew daripada menerapkan secara FuncTool langsung. Kerangka kerja menggunakan tanda tangan fungsi Go atau tag struktur untuk membangun skema yang diekspos ke model.

Teruskan alat ke agen melalui 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},
    },
})

Atau tambahkan alat per jalankan:

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

Untuk Go, tandai alat yang dapat dipanggil dengan tool.ApprovalRequiredFunc atau gunakan alat yang sudah mengimplementasikan tool.ApprovalRequiredTool, seperti alat shell lokal. Permintaan persetujuan dan respons mengalir melalui middleware panggilan otomatis alat, sehingga mereka bekerja dengan penyedia yang mengembalikan panggilan fungsi lokal.

Matriks Dukungan Penyedia

Penyedia OpenAI dan Azure OpenAI masing-masing menawarkan dua jenis klien - Respons dan Penyelesaian Obrolan - dengan kemampuan alat yang berbeda. Klien Azure OpenAI mencerminkan setara OpenAI mereka. Copilot Studio dan A2A berjalan pada layanan jarak jauh sehingga kemampuannya dikonfigurasi pada agen jarak jauh daripada melalui klien Agent Framework — mereka tidak tercantum dalam matriks.

Matriks Dukungan Penyedia

Penyedia OpenAI dan Azure OpenAI masing-masing menawarkan beberapa jenis klien dengan kemampuan alat yang berbeda. Klien Azure OpenAI mencerminkan setara OpenAI mereka. Kolom Foundry berlaku untuk FoundryChatClient — untuk FoundryAgent, alat dikonfigurasi pada definisi agen Foundry (lihat Apa yang berfungsi dan apa yang tidak dengan FoundryAgent). Copilot Studio dan A2A berjalan pada layanan jarak jauh sehingga kemampuannya dikonfigurasi pada agen jarak jauh daripada melalui klien Agent Framework — mereka tidak tercantum dalam matriks.

¹ Tergantung pada panggilan fungsi pendukung model lokal yang dipilih. ² Dibangun ke dalam runtime CLI GitHub Copilot, dijaga oleh penangan izin. Permukaan yang berbeda dari OpenAI get_shell_tool.

Matriks Dukungan Penyedia

Go SDK mengekspos Microsoft Foundry melalui foundryprovider dan OpenAI/Azure OpenAI melalui openaiprovider. Alat yang dihosting adalah deklarasi: Go SDK mengirimkannya ke penyedia, dan penyedia memutuskan apakah kemampuan yang dihosting tool/hostedtool tersedia.

.AsAIFunction() Panggil AIAgent untuk mengonversinya ke alat fungsi yang dapat disediakan ke agen lain:

// 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?"));

Panggil .as_tool() agen untuk mengonversinya ke alat fungsi yang dapat disediakan ke agen lain:

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)

Anda juga dapat menyesuaikan nama alat, deskripsi, dan nama argumen:

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"
)

Bungkus agen dengan agenttool.New untuk membuatnya tersedia sebagai tool.FuncTool untuk agen lain:

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()

Anda juga dapat mengekspos agen yang dibungkus yang sama melalui MCP dengan mcptool.AddTool, karena agenttool.New mengembalikan alat fungsi.