联网搜索与引用

export API_ROOT_URL='https://gateway.example.com'
export API_KEY='YOUR_API_KEY'
export API_MODEL='YOUR_SEARCH_MODEL_ID'
export API_SEARCH_TOOL='web_search_preview'
node examples/web-search.mjs

import { requestJSON } from './http-client.mjs';

try {
  const { API_MODEL, API_SEARCH_TOOL } = process.env;
  if (!API_MODEL?.trim() || !['web_search_preview', 'web_search'].includes(API_SEARCH_TOOL)) {
    throw new Error('Select a model and a supported native search tool.');
  }
  const result = await requestJSON('/v1/responses', {
    model: API_MODEL, store: false,
    input: 'Search the official Node.js website for its release schedule and summarize it with source citations.',
    tools: [{ type: API_SEARCH_TOOL }], tool_choice: 'required',
  });
  if (result.status !== 'completed' || !Array.isArray(result.output)) throw new Error('Incomplete response.');
  let calls = 0;
  const blocks = [];
  for (const item of result.output) {
    if (item?.type === 'reasoning') continue;
    if (item?.type === 'web_search_call') {
      if (item.status !== 'completed') throw new Error('Incomplete search.');
      calls++;
      continue;
    }
    if (item?.type !== 'message' || item.role !== 'assistant' || item.status !== 'completed'
      || !Array.isArray(item.content)) throw new Error('Unexpected output.');
    for (const part of item.content) {
      if (part?.type !== 'output_text' || typeof part.text !== 'string' || !Array.isArray(part.annotations)) {
        throw new Error('Missing text or annotations.');
      }
      const citations = [];
      for (const annotation of part.annotations) {
        if (annotation?.type !== 'url_citation') throw new Error('Unsupported annotation.');
        const { url, title, start_index, end_index } = annotation;
        if (typeof url !== 'string' || typeof title !== 'string' || !title.trim()
          || !Number.isSafeInteger(start_index) || !Number.isSafeInteger(end_index)
          || start_index < 0 || end_index <= start_index) throw new Error('Invalid citation.');
        const link = new URL(url);
        if (!['http:', 'https:'].includes(link.protocol) || link.username || link.password) throw new Error('Invalid citation URL.');
        // Keep provider offsets attached to the original text block; do not fetch links.
        citations.push({ url, title, start_index, end_index });
      }
      blocks.push({ text: part.text, citations });
    }
  }
  if (!calls || !blocks.some((block) => block.text.trim()) || !blocks.some((block) => block.citations.length)) {
    throw new Error('This example requires a completed search and cited text.');
  }
  console.log(JSON.stringify({ search_calls: calls, blocks }));
} catch {
  console.error('Search example failed. Check native tool support, completed search, and citations. No automatic retry.');
  process.exitCode = 1;
}