Vyhledávání na webu

Vyhledávání na webu umožňuje agentům hledat na webu informace up-to-date. Tento nástroj umožňuje agentům zodpovědět otázky týkající se aktuálních událostí, najít dokumentaci a získat přístup k informacím nad rámec trénovacích dat.

Poznámka:

Dostupnost vyhledávání na webu závisí na příslušném poskytovateli agenta. Viz Přehled poskytovatelů podpory pro konkrétního poskytovatele.

Následující příklad ukazuje, jak vytvořit agenta pomocí nástroje Pro vyhledávání na webu:

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

Výstraha

DefaultAzureCredential je vhodný pro vývoj, ale vyžaduje pečlivé zvážení v produkčním prostředí. V produkčním prostředí zvažte použití konkrétních přihlašovacích údajů (např ManagedIdentityCredential. ) k zabránění problémům s latencí, neúmyslnému testování přihlašovacích údajů a potenciálním bezpečnostním rizikům z náhradních mechanismů.

Následující příklad ukazuje, jak vytvořit agenta pomocí nástroje Pro vyhledávání na webu:

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

Vyhledávání na webu

Typ hostedtool.WebSearch povolí vyhledávání na straně serveru při použití zprostředkovatele, který ho podporuje.

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},
    },
})

Poznámka:

Webové vyhledávání je hostovaný nástroj – vyhledávání provádí služba AI, nikoli místně.

Použití webového vyhledávání s využitím agenta

Pro prostého agenta přidejte HostedWebSearchTool do nástrojů agenta, jak je znázorněno výše. HarnessAgent přidá jednu HostedWebSearchTool ve výchozím nastavení, takže není nutná žádná registrace nástroje:

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.",
    },
});

Nastavte DisableWebSearch = true , když vybraný zprostředkovatel nepodporuje hostované webové vyhledávání nebo když chcete zaregistrovat vyhledávací nástroj specifický pro poskytovatele sami prostřednictvím ChatOptions.Tools. Pokud přidáte vlastní nástroj pro vyhledávání na webu bez zakázání výchozího nastavení, agent obdrží oba nástroje.

Vyhledávání na webu je hostováno poskytovatelem modelu; Neexistuje žádný životní cyklus místního klienta vyhledávání pro správu nástroje. Dostupnost, podporované modely, parametry hledání, rezidence dat a fakturace závisí na poskytovateli IChatClient . Nepodporovaní klienti můžou hostovaný nástroj při odeslání požadavku odmítnout.

Zachází s vyhledávacími dotazy a výsledky jako s daty překračujícími hranice externí důvěryhodnosti. Nezahrnujte do dotazů tajné kódy a načítejte stránky jako nedůvěryhodný obsah, který může obsahovat nepřímé injektáže výzvy. Před provedením akcí ověřte důležité deklarace identity a citace.

HarnessAgent je k dispozici v Microsoft.Agents.AI.Harness balíčku.

Pro prostého agenta zavolejte client.get_web_search_tool(...) a předejte vrácený nástroj Agent, jak je znázorněno výše. create_harness_agent volání client.get_web_search_tool() bez argumentů ve výchozím nastavení při implementaci SupportsWebSearchToolklienta:

from agent_framework import create_harness_agent

agent = create_harness_agent(client=client)

Pokud klient neimplementuje SupportsWebSearchTool, továrna zaznamená upozornění a pokračuje bez vyhledávání na webu. Nastavte disable_web_search=True potlačení automatické registrace a upozornění.

Pokud chcete předat nastavení specifická pro poskytovatele, zakažte výchozí a explicitně zaregistrujte nakonfigurovaný nástroj:

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

Poskytovatel vlastní spouštění a životní cyklus hostovaného vyhledávání. Podporované parametry, modely, zpracování dat a fakturace závisí na implementaci klienta. Neukládejte tajné kódy do dotazů, zacházejte s načteným obsahem jako s nedůvěryhodným vstupem a před provedením akcí ověřte důležité deklarace identity a citace.

create_harness_agent je vydáno v agent-framework-core; webové vyhledávání zůstává k dispozici pouze prostřednictvím klientů, kteří implementují SupportsWebSearchTool.

Balíček Go Postroj není v současné době k dispozici. Přidejte hostedtool.WebSearch do prostého agenta Go, jak je znázorněno výše.

Další kroky

Hostované nástroje MCP