Araçlara Genel Bakış

Agent Framework, aracı özelliklerini genişleten birçok farklı araç türünü destekler. Araçlar, aracıların dış sistemlerle etkileşim kurmasına, kod yürütmesine, veri aramasına ve daha fazlasına olanak tanır.

Araç Türleri

Araç Türü	Description
İşlev Araçları	Aracıların konuşmalar sırasında çağırabileceği özel kod
Araç Onayı	Araç çağrıları için döngüdeki insan onayı
Kod Yorumlayıcısı	Korumalı bir ortamda kod yürütme
Dosya Arama	Karşıya yüklenen dosyalar arasında arama
Web Araması	Bilgi için web'de arama yapma
Barındırılan MCP Araçları	Azure AI Foundry tarafından barındırılan MCP araçları
Yerel MCP Araçları	Yerel olarak veya özel sunucularda çalışan MCP araçları

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.

Araç Türü	Sohbet Tamamlama	Yanıt	Asistanlar	Azure AI Foundry	Anthropic	Ollama	GitHub Yardımcı Pilotu	Copilot Studio
İşlev Araçları	✅	✅	✅	✅	✅	✅	✅	✅
Araç Onayı	❌	✅	❌	✅	❌	❌	❌	❌
Kod Yorumlayıcısı	❌	✅	✅	✅	❌	❌	❌	❌
Dosya Arama	❌	✅	✅	✅	❌	❌	❌	❌
Web Araması	✅	✅	❌	❌	❌	❌	❌	❌
Barındırılan MCP Araçları	❌	✅	❌	✅	✅	❌	❌	❌
Yerel MCP Araçları	✅	✅	✅	✅	✅	✅	✅	❌

Uyarı

Sohbet Tamamlama, Yanıtlar ve Yardımcılar sütunları hem OpenAI hem de Azure OpenAI için geçerlidir; Azure varyantları, OpenAI eşdeğerleriyle aynı araç desteğini yansıtır.

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.

Araç Türü	Sohbet Tamamlama	Yanıt	Asistanlar	Azure AI Foundry	Anthropic	Claude Aracısı	Ollama	GitHub Yardımcı Pilotu
İşlev Araçları	✅	✅	✅	✅	✅	✅	✅	✅
Araç Onayı	❌	✅	❌	✅	❌	❌	❌	❌
Kod Yorumlayıcısı	❌	✅	✅	✅	✅	❌	❌	❌
Dosya Arama	❌	✅	✅	✅	❌	❌	❌	❌
Web Araması	✅	✅	❌	✅	✅	❌	❌	❌
Görüntü Üretimi	❌	❌	❌	✅	❌	❌	❌	❌
Barındırılan MCP Araçları	❌	✅	❌	✅	✅	❌	❌	❌
Yerel MCP Araçları	✅	✅	✅	✅	✅	✅	✅	✅

Uyarı

Sohbet Tamamlama, Yanıtlar ve Yardımcılar sütunları hem OpenAI hem de Azure OpenAI için geçerlidir; Azure varyantları, OpenAI eşdeğerleriyle aynı araç desteğini yansıtır. Yerel MCP Araçları, işlev araçlarını destekleyen tüm sağlayıcılarla çalışır.

Aracıyı İşlev Aracı olarak Kullanma

Aracıyı başka bir aracı için işlev aracı olarak kullanarak aracı oluşturma ve daha gelişmiş iş akışları sağlayabilirsiniz. İç aracı bir işlev aracına dönüştürülür ve dış aracıya sağlanır ve gerektiğinde çağırılabilir.

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

// Create the inner agent with its own tools
AIAgent weatherAgent = new AzureOpenAIClient(
    new Uri("https://<myresource>.openai.azure.com"),
    new AzureCliCredential())
     .GetChatClient("gpt-4o-mini")
     .AsAIAgent(
        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 AzureOpenAIClient(
    new Uri("https://<myresource>.openai.azure.com"),
    new AzureCliCredential())
     .GetChatClient("gpt-4o-mini")
     .AsAIAgent(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:

from agent_framework.azure import AzureOpenAIChatClient
from azure.identity import AzureCliCredential

# Create the inner agent with its own tools
weather_agent = AzureOpenAIChatClient(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 = AzureOpenAIChatClient(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"
)

Sonraki Adımlar

İşlev Araçları