Web Search

Web Araması, aracıların web'de up-totarih bilgilerini aramasına olanak tanır. Bu araç, aracıların geçerli olaylar hakkındaki soruları yanıtlamasına, belgeleri bulmasına ve eğitim verilerinin ötesinde bilgilere erişmesine olanak tanır.

Uyarı

Web Araması kullanılabilirliği, temel alınan aracı sağlayıcısına bağlıdır. Sağlayıcıya özgü destek için bkz. Sağlayıcılara Genel Bakış .

Aşağıdaki örnekte Web Araması aracısıyla aracı oluşturma gösterilmektedir:

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

// Requires: dotnet add package Microsoft.Agents.AI.Foundry --prerelease
var endpoint = Environment.GetEnvironmentVariable("FOUNDRY_PROJECT_ENDPOINT")
    ?? throw new InvalidOperationException("FOUNDRY_PROJECT_ENDPOINT is not set.");
var deploymentName = Environment.GetEnvironmentVariable("FOUNDRY_MODEL") ?? "gpt-5.4-mini";

// Create an agent with hosted web search.
AIAgent agent = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential())
    .AsAIAgent(
        model: deploymentName,
        instructions: "You are a helpful assistant that can search the web for current information.",
        tools: [new HostedWebSearchTool()]);

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

Warning

DefaultAzureCredential geliştirme için uygundur ancak üretimde dikkatli bir şekilde dikkate alınması gerekir. Üretimde gecikme sorunları, istenmeyen kimlik bilgisi yoklama ve geri dönüş mekanizmalarından kaynaklanan olası güvenlik risklerini önlemek için belirli bir kimlik bilgisi (ör ManagedIdentityCredential. ) kullanmayı göz önünde bulundurun.

Aşağıdaki örnekte Web Araması aracısıyla aracı oluşturma gösterilmektedir:

# Copyright (c) Microsoft. All rights reserved.

import asyncio

from agent_framework import Agent
from agent_framework.openai import OpenAIChatClient

"""
OpenAI Responses Client with Web Search Example

This sample demonstrates using get_web_search_tool() with OpenAI Responses Client
for direct real-time information retrieval and current data access.
"""


async def main() -> None:
    client = OpenAIChatClient()

    # Create web search tool with location context
    web_search_tool = client.get_web_search_tool(
        user_location={"city": "Seattle", "country": "US"},
    )

    agent = Agent(
        client=client,
        instructions="You are a helpful assistant that can search the web for current information.",
        tools=[web_search_tool],
    )

    message = "What is the current weather? Do not ask for my current location."
    stream = False
    print(f"User: {message}")

    if stream:
        print("Assistant: ", end="")
        async for chunk in agent.run(message, stream=True):
            if chunk.text:
                print(chunk.text, end="")
        print("")
    else:
        response = await agent.run(message)
        print(f"Assistant: {response}")


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

Web araması

Türü, hostedtool.WebSearch destekleyen bir sağlayıcı kullanılırken sunucu tarafı web araması sağlar.

import "github.com/microsoft/agent-framework-go/tool/hostedtool"

webSearch := &hostedtool.WebSearch{}

a := foundryprovider.NewAgent(endpoint, token, foundryprovider.ModelDeployment(model), foundryprovider.AgentConfig{
    Config: agent.Config{
        Tools: []tool.Tool{webSearch},
    },
})

Uyarı

Web araması barındırılan bir araçtır; arama yerel olarak değil yapay zeka hizmeti tarafından gerçekleştirilir.

Koşum Aracısı ile web araması kullanma

Düz bir aracı için, daha önce gösterildiği gibi aracının araçlarına ekleyin HostedWebSearchTool . HarnessAgent varsayılan olarak bir tane HostedWebSearchTool ekler, bu nedenle araç kaydı gerekmez:

using Microsoft.Agents.AI;

AIAgent agent = chatClient.AsHarnessAgent(new HarnessAgentOptions
{
    ChatOptions = new()
    {
        Instructions = "Use web search for current information and cite the sources you used.",
    },
});

Seçili sağlayıcı barındırılan web aramasını desteklemediğinde veya sağlayıcıya özgü bir arama aracını kendiniz aracılığıyla DisableWebSearch = truekaydetmek istediğinizde ayarlayınChatOptions.Tools. Varsayılanı devre dışı bırakmadan kendi web arama aracınızı eklerseniz aracı her iki aracıyı da alır.

Web araması model sağlayıcısı tarafından barındırılır; Koşum'un yönetecek yerel bir arama istemcisi yaşam döngüsü yoktur. Kullanılabilirlik, desteklenen modeller, arama parametreleri, veri yerleşimi ve faturalama sağlayıcıya IChatClient bağlıdır. Desteklenmeyen istemciler, istek gönderildiğinde barındırılan aracı reddedebilir.

Arama sorgularını ve sonuçlarını dış güven sınırını aşan veriler olarak değerlendirin. Sorgulara gizli diziler eklemeyin ve alınan sayfaları dolaylı istem ekleme içerebilen güvenilmeyen içerik olarak değerlendirin. Eylem gerçekleştirmeden önce önemli talepleri ve alıntıları doğrulayın.

HarnessAgent paketinden Microsoft.Agents.AI.Harness kullanılabilir.

Düz bir aracı için çağrısı client.get_web_search_tool(...) yapın ve daha önce gösterildiği gibi döndürülen aracı öğesine Agentgeçirin. create_harness_agent , istemci tarafından uygulandığında varsayılan olarak bağımsız değişken içermeyen çağrıları client.get_web_search_tool() çağırır SupportsWebSearchTool:

from agent_framework import create_harness_agent

agent = create_harness_agent(client=client)

İstemci uygulamazsa SupportsWebSearchTool, fabrika bir uyarı kaydeder ve web araması olmadan devam eder. Otomatik kaydı ve uyarıyı gizleyecek şekilde ayarlayın disable_web_search=True .

Sağlayıcıya özgü ayarları geçirmek için varsayılanı devre dışı bırakın ve yapılandırılan aracı açıkça kaydedin:

agent = create_harness_agent(
    client=client,
    disable_web_search=True,
    tools=[
        client.get_web_search_tool(
            user_location={"city": "Seattle", "country": "US"},
            search_context_size="medium",
        )
    ],
)

Sağlayıcı, barındırılan arama yürütme ve yaşam döngüsüne sahiptir. Desteklenen parametreler, modeller, veri işleme ve faturalama, istemci uygulamasına bağlıdır. Gizli dizileri sorgulara koymayın, alınan içeriği güvenilmeyen giriş olarak kabul etmeyin ve eylem gerçekleştirmeden önce önemli talepleri ve alıntıları doğrulayın.

create_harness_agent içinde agent-framework-coreyayınlanır; web araması yalnızca uygulayan SupportsWebSearchToolistemciler aracılığıyla kullanılabilir durumda kalır.

Paketlenmiş Go Harness şu anda kullanılamıyor. Daha önce gösterildiği gibi düz Go aracısına ekleyin hostedtool.WebSearch .

Sonraki Adımlar

Barındırılan MCP Araçları