Webpage Summarizer

能力概述

调用千帆平台的网页内容总结组件，访问指定 URL 的网页并生成内容分析/总结文本。

• Endpoint: POST https://app-bo4w33bsdqm9-api-DY8MNXjBpKAa-gateway.appmiaoda.com/v2/components/c-wf-e1bc471f-1d33-4df1-ab42-87800e89c1ad
• 认证方式: platform_managed（密钥由平台注入，Header: X-Gateway-Authorization: Bearer <key>）
• Content-Type: application/json
• 响应格式: JSON，分析结果在 content[0].raw_data.origin_response.node_content[0].outputs.output
• 超时限制: apiClient timeout 60s
• 支持平台: Web、MiniProgram

典型响应示例

{
  "content": [
    {
      "raw_data": {
        "origin_response": {
          "node_content": [
            {
              "outputs": {
                "output": "网页内容分析：\n\n第一个网页是新浪体育的新闻页面，主要报道了国内足球比赛的相关新闻..."
              }
            }
          ]
        }
      },
      "event": {
        "error_code_int": 0,
        "error_message": ""
      }
    }
  ]
}

生成期用法（Agent 直接调用）

const apiKey = process.env["INTEGRATIONS_API_KEY"]!; // platform_managed 密钥由平台注入

/**
 * 调用网页内容总结接口，分析指定网页并返回总结文本。
 *
 * @param sysOriginQuery - 用户诉求描述，例如"请帮我分析下网页的内容"
 * @param webUrl - 待分析的网页 URL 列表，当前只支持一个地址
 * @returns 网页内容分析/总结文本
 */
async function callWebPageSummary(
  sysOriginQuery: string,
  webUrl: string[]
): Promise<string> {
  const response = await fetch(
    "https://app-bo4w33bsdqm9-api-DY8MNXjBpKAa-gateway.appmiaoda.com/v2/components/c-wf-e1bc471f-1d33-4df1-ab42-87800e89c1ad",
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "X-Gateway-Authorization": `Bearer ${apiKey}`,
      },
      body: JSON.stringify({
        parameters: {
          _sys_origin_query: sysOriginQuery,
          web_url: webUrl,
        },
      }),
      signal: AbortSignal.timeout(60_000), // 平台要求 timeout 60s
    }
  );

  if (!response.ok) throw new Error(`HTTP error: ${response.status}`);

  const json = await response.json();
  const event = json?.content?.[0]?.event;
  if (event?.error_code_int !== 0) {
    throw new Error(`API error ${event?.error_code_int}: ${event?.error_message}`);
  }

  return json.content[0].raw_data.origin_response.node_content[0].outputs.output as string;
}

// 使用示例
const summary = await callWebPageSummary(
  "请帮我总结这篇文章的主要内容",
  ["https://example.com/article"]
);
console.log(summary);

生成后用法（应用内通过 Edge Function 调用）

Edge Function

// edge-functions/webpage-summarizer.ts
import { serve } from "https://deno.land/std/http/server.ts";

serve(async (req: Request): Promise<Response> => {
  /**
   * 处理前端请求，转发至千帆网页内容总结接口并返回分析结果。
   * 注入平台密钥，避免在前端暴露 INTEGRATIONS_API_KEY。
   */
  if (req.method !== "POST") {
    return new Response("Method Not Allowed", { status: 405 });
  }

  // --- 解析客户端请求 ---
  let sysOriginQuery: string;
  let webUrl: string[];
  try {
    const body = await req.json();
    sysOriginQuery = body.sysOriginQuery;
    webUrl = body.webUrl;
    if (!sysOriginQuery) throw new Error("Missing sysOriginQuery");
    if (!webUrl || !Array.isArray(webUrl) || webUrl.length === 0) {
      throw new Error("Missing or invalid webUrl");
    }
  } catch {
    return new Response(JSON.stringify({ error: "Invalid request body" }), {
      status: 400,
      headers: { "Content-Type": "application/json" },
    });
  }

  // --- 注入平台密钥（严禁暴露至前端） ---
  const apiKey = Deno.env.get("INTEGRATIONS_API_KEY");
  if (!apiKey) {
    return new Response(JSON.stringify({ error: "Server configuration error" }), {
      status: 500,
      headers: { "Content-Type": "application/json" },
    });
  }

  // --- 调用上游接口 ---
  let upstream: Response;
  try {
    upstream = await fetch(
      "https://app-bo4w33bsdqm9-api-DY8MNXjBpKAa-gateway.appmiaoda.com/v2/components/c-wf-e1bc471f-1d33-4df1-ab42-87800e89c1ad",
      {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
          "X-Gateway-Authorization": `Bearer ${apiKey}`,
        },
        body: JSON.stringify({
          parameters: {
            _sys_origin_query: sysOriginQuery,
            web_url: webUrl,
          },
        }),
        signal: AbortSignal.timeout(60_000),
      }
    );
  } catch (e) {
    return new Response(JSON.stringify({ error: `Upstream fetch failed: ${(e as Error).message}` }), {
      status: 502,
      headers: { "Content-Type": "application/json" },
    });
  }

  // 透传配额/余额错误
  if (upstream.status === 429 || upstream.status === 402) {
    const errText = await upstream.text();
    return new Response(errText, {
      status: upstream.status,
      headers: { "Content-Type": "application/json" },
    });
  }

  if (!upstream.ok) {
    return new Response(
      JSON.stringify({ error: `Upstream error: ${upstream.status}` }),
      { status: 502, headers: { "Content-Type": "application/json" } }
    );
  }

  const data = await upstream.json();
  return new Response(JSON.stringify(data), {
    status: 200,
    headers: { "Content-Type": "application/json" },
  });
});

前端调用代码

推荐方式（supabase client 可用时，Web 和 MiniProgram 通用）：

/**
 * 通过 Edge Function 调用网页内容总结接口。
 *
 * @param sysOriginQuery - 用户诉求描述
 * @param webUrl - 待分析的网页 URL 列表（当前只支持一个地址）
 * @returns 完整的 API 响应 JSON
 */
async function fetchWebPageSummary(
  sysOriginQuery: string,
  webUrl: string[]
): Promise<unknown> {
  const { data, error } = await supabase.functions.invoke("webpage-summarizer", {
    body: { sysOriginQuery, webUrl },
  });
  if (error) throw error;

  const event = data?.content?.[0]?.event;
  if (event?.error_code_int !== 0) {
    throw new Error(`API 错误 ${event?.error_code_int}：${event?.error_message}`);
  }

  return data;
}

备用方式（无法使用 supabase client 时）：

async function fetchWebPageSummary(
  sysOriginQuery: string,
  webUrl: string[]
): Promise<unknown> {
  const res = await fetch(
    `${import.meta.env.VITE_SUPABASE_URL}/functions/v1/webpage-summarizer`,
    {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ sysOriginQuery, webUrl }),
    }
  );

  if (res.status === 429) {
    const err = await res.json();
    throw new Error(`配额已用尽：${err.message ?? res.statusText}`);
  }
  if (res.status === 402) {
    const err = await res.json();
    throw new Error(`余额不足：${err.message ?? res.statusText}`);
  }
  if (!res.ok) throw new Error(`请求失败：${res.status}`);

  const json = await res.json();
  const event = json?.content?.[0]?.event;
  if (event?.error_code_int !== 0) {
    throw new Error(`API 错误 ${event?.error_code_int}：${event?.error_message}`);
  }

  return json;
}

参数说明

请求参数

以上参数包裹在请求体的 parameters 对象中，示例：{ "parameters": { "_sys_origin_query": "...", "web_url": ["..."] } }

返回字段说明

成功响应：

失败响应：

注意事项

• 密钥安全: INTEGRATIONS_API_KEY 仅可在 Edge Function 服务端读取，严禁暴露到前端。
• 超时设置: 上游接口要求 apiClient timeout 60s，Edge Function 和生成期调用均需设置 AbortSignal.timeout(60_000)。
• URL 数量限制: web_url 数组当前只支持一个地址，传入多个地址可能导致异常。
• 错误处理: 务必检查 content[0].event.error_code_int 是否为 0，同时处理 HTTP 429（配额超限）和 402（余额不足）。
• 计费: 此插件当前免费（original_price: "0"，enable_billing: false），但 need_count_calls: true，调用次数会被统计，避免不必要的重复调用。
• Plugin ID: c3f8d97a-7532-4927-9467-cb79344ae5eb
• API ID: api-DY8MNXjBpKAa