Araçlara Genel Bakış

Tüm araçlar arabirimi uygular tool.Tool :

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

İşlev araçları ayrıca şunu uygular tool.FuncTool:

import "context"

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

Çoğu uygulama, doğrudan uygulamak FuncTool yerine veya functool.MustNew ile functool.New işlev araçları oluşturur. Çerçeve, modele sunulan şemayı oluşturmak için Go işlevi imzasını veya yapı etiketlerini kullanır.

aracıya aracılığıyla araçları geçirin 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},
    },
})

Veya çalıştırma başına araçlar ekleyin:

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

Go için, çağrılabilen bir aracı ile tool.ApprovalRequiredFunc işaretleyin veya yerel kabuk aracı gibi zaten uygulayan tool.ApprovalRequiredToolbir araç kullanın. Onay istekleri ve yanıtları araç otomatik çağrı ara yazılımı üzerinden akar, böylece yerel işlev çağrıları döndüren sağlayıcılarla çalışır.

Sağlayıcı Destek Matrisi

OpenAI ve Azure OpenAI sağlayıcılarının her biri farklı araç özelliklerine sahip iki istemci türü (Yanıtlar ve Sohbet Tamamlama) sunar. Azure OpenAI istemcileri, OpenAI eşdeğerlerini yansıtır. Copilot Studio ve A2A aracıları uzak bir hizmette çalıştırılır, böylece özellikleri Agent Framework istemcisi yerine uzak aracıda yapılandırılır; matriste listelenmez.

Sağlayıcı Destek Matrisi

OpenAI ve Azure OpenAI sağlayıcılarının her biri farklı araç özelliklerine sahip birden çok istemci türü sunar. Azure OpenAI istemcileri, OpenAI eşdeğerlerini yansıtır. Foundry sütunu için FoundryChatClient geçerlidir— içinFoundryAgent, araçlar Foundry aracı tanımında yapılandırılır (bkz. Ne işe yarar ve nelerle FoundryAgentçalışmaz? ). Copilot Studio ve A2A aracıları uzak bir hizmette çalıştırılır, böylece özellikleri Agent Framework istemcisi yerine uzak aracıda yapılandırılır; matriste listelenmez.

¹ Seçilen yerel modeli destekleyen işlev çağrısına bağlıdır. ² bir izin işleyicisi tarafından geçitli GitHub Copilot CLI çalışma zamanında yerleşiktir. OpenAI'nin get_shell_toolfarklı yüzeyi.

Sağlayıcı Destek Matrisi

Go SDK,aracılığıyla Microsoft Foundry'yi ve aracılığıyla foundryprovider OpenAI/Azure OpenAI'yi openaiproviderkullanıma sunar. içindeki tool/hostedtool barındırılan araçlar bildirimdir: Go SDK'sı bunları sağlayıcıya gönderir ve sağlayıcı barındırılan özelliğin kullanılabilir olup olmadığına karar verir.

Başka bir .AsAIFunction() aracıya sağlanabilir bir işlev aracısına dönüştürmek için çağrısı AIAgent yapın:

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

Aracıyı çağırarak .as_tool() başka bir aracıya sağlanabilir bir işlev aracısına dönüştürün:

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)

Araç adını, açıklamasını ve bağımsız değişken adını da özelleştirebilirsiniz:

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

Aracıyı başka bir aracı için tool.FuncTool kullanılabilir hale getirmek için ile agenttool.New sarmalayın:

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

Aynı sarmalanmış aracıyı ile mcptool.AddToolMCP aracılığıyla da kullanıma sunun çünkü agenttool.New bir işlev aracı döndürür.