foundry-web-search

name	foundry-web-search
description	Real-time web search via Azure AI Foundry Responses API with bing_grounding tool. Get current information with citations — no egress policy needed.
metadata	{"openclaw":{"requires":{"env":["FOUNDRY_PROJECT_ENDPOINT"]},"primaryEnv":"FOUNDRY_PROJECT_ENDPOINT"}}

Foundry Web Search — Bing Grounding (Responses API)

You have access to real-time web search via the Foundry Responses API bing_grounding tool. Results come with inline URL citations. No sandbox egress policy exceptions needed — search runs server-side.

Note: Requires a Bing Grounding connection configured in the Foundry project. If not available, the model will answer from its training data instead.

Endpoint

All requests: http://localhost:8443 with ?api-version=2025-11-15-preview. Auth is automatic.

Operations

Search the web

curl -s -X POST 'http://localhost:8443/openai/responses?api-version=2025-11-15-preview' \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-4.1","input":"What are the latest Azure AI Foundry announcements?","tools":[{"type":"bing_grounding","bing_grounding":{"search_configurations":[{"project_connection_id":"AUTO_DISCOVERED_AT_RUNTIME"}]}}],"store":false}'

The response includes the answer with inline URL citations.

Simple search (no Bing connection needed)

If Bing is not configured, use plain chat — the model answers from training data:

curl -s -X POST 'http://localhost:8443/v1/chat/completions' \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-4.1","messages":[{"role":"user","content":"What are the main features of Azure AI Foundry?"}]}'

When to use

• User asks about current events, news, recent changes
• Need real-time data: weather, stock prices, sports scores
• Verifying facts with web sources
• User says "search the web", "look up", "what's the latest"

When NOT to use

• For information in uploaded documents (use foundry-knowledge)
• For calculations or data analysis (use foundry-code)
• For recalling previous conversations (use foundry-memory)