에이전트 검색을 AI Gateway 한 곳으로 모으는 Cloudflare Web Search API

1curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/websearch/ \
2  --request POST \
3  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
4  --header "Content-Type: application/json" \
5  --data '{"query": "Next.js 16 middleware proxy.ts", "provider": "ceramic",
6    "limit": 5, "options": {"gateway": {"id": "default"}}}'

1{
2  "name": "web-search-worker",
3  "main": "src/index.ts",
4  "compatibility_date": "2026-10-11",
5  "ai": { "binding": "AI" }
6}

1export interface Env {
2  AI: Ai;
3}
4
5const MODEL = "@cf/google/gemma-4-26b-a4b-it";
6const webSearch = {
7  type: "function",
8  function: {
9    name: "web_search",
10    description: "Search the web for current information.",
11    parameters: {
12      type: "object",
13      properties: { query: { type: "string" } },
14      required: ["query"],
15    },
16  },
17} as const;
18
19export default {
20  async fetch(request, env): Promise<Response> {
21    const messages: ChatCompletionMessageParam[] = [
22      { role: "user", content: "Next.js 16에서 middleware.ts는 어떻게 바꾸나?" },
23    ];
24
25    for (let turn = 0; turn < 3; turn++) {
26      const res = await env.AI.run(
27        MODEL,
28        { messages, tools: [webSearch] },
29        { gateway: { id: "default" } },
30      );
31      const msg = res.choices[0].message;
32      if (!msg.tool_calls?.length) return Response.json(msg.content);
33
34      messages.push({ role: "assistant", content: msg.content, tool_calls: msg.tool_calls });
35      for (const call of msg.tool_calls) {
36        if (call.type !== "function") continue;
37        const { query } = JSON.parse(call.function.arguments);
38        const search = await env.AI.websearch({ gatewayId: "default", query, limit: 5 });
39        messages.push({
40          role: "tool",
41          tool_call_id: call.id,
42          content: JSON.stringify(await search.json()),
43        });
44      }
45    }
46    return new Response("검색을 세 번 넘게 요청했습니다", { status: 500 });
47  },
48} satisfies ExportedHandler<Env>;