page-agent CDN 演示脚本的 URL 查询参数:不写代码配置自己的 LLM

发布时间:2026/9/12 17:15:38
page-agent CDN 演示脚本的 URL 查询参数:不写代码配置自己的 LLM page-agent CDN 演示脚本的 URL 查询参数不写代码配置自己的 LLM【免费下载链接】page-agentJavaScript in-page GUI agent. Control web interfaces with natural language.项目地址: https://gitcode.com/GitHub_Trending/pa/page-agentpage-agent 的 demo CDN 脚本只要一行script就能给任意网页装上一个现成的 GUI Agent但它默认连接的是项目提供的免费测试 LLM。如果你想保留这种一行脚本的集成方式却把后端换成自己的 LLM 服务阿里云百炼、OpenAI、DeepSeek 等任何符合 OpenAI 接口规范且支持 tool call 的服务不需要写任何代码给 CDN 脚本地址追加查询参数即可。本文说明这些参数的取值、默认值以及如何验证它们生效。参数从哪里被读取demo 入口是 IIFE 构建产物dist/iife/page-agent.demo.js。它加载时会读取自身script标签src地址不是页面地址上的查询参数来源见 demo.tsconst model url.searchParams.get(model) || DEMO_MODEL const baseURL url.searchParams.get(baseURL) || DEMO_BASE_URL const apiKey url.searchParams.get(apiKey) || DEMO_API_KEY const language (url.searchParams.get(lang) as zh-CN | en-US) || zh-CN showPanel ((url.searchParams.get(showPanel) as true | false) || true) true组装出{ model, baseURL, apiKey, language }后脚本调用new PageAgent(config)把实例挂到window.pageAgent默认展示操作面板。模型侧的要求以官方模型文档为准服务需符合 OpenAI 接口规范且支持 tool call已测试的模型清单见 models 文档页。参数清单与默认值参数作用不传时的默认值modelLLM 模型名qwen3.5-plusbaseURLLLM 服务地址免费测试端点https://page-ag-testing-ohftxirgbn.cn-shanghai.fcapp.runapiKey服务 API KeyNA测试端点无需真实 Keylang面板语言zh-CN或en-USzh-CNshowPanel是否展示操作面板true/falsetrueautoInit是否自动创建 demo agent自动创建值恰好为false时关闭前四个参数正是脚本创建PageAgent时用到的全部配置字段。这也是这条路径的边界URL 参数只能覆盖model、baseURL、apiKey、language这四项。想设置maxSteps、instructions、customFetch等其他配置项时URL 参数帮不上忙需要走后文的autoInitfalse手动初始化。切换到自己名下的 LLM 服务起点是 README 里的一行集成script srchttps://cdn.jsdelivr.net/npm/page-agent1.12.3/dist/iife/page-agent.demo.js crossoriginanonymous /script如果访问不了 jsDelivrREADME 给出的中国镜像地址是https://registry.npmmirror.com/page-agent/1.12.3/files/dist/iife/page-agent.demo.js参数用法相同。以阿里云百炼为例baseURL 与模型名同官方模型文档中的示例把参数追加到src上script srchttps://cdn.jsdelivr.net/npm/page-agent1.12.3/dist/iife/page-agent.demo.js?modelqwen3.5-plusbaseURLhttps://dashscope.aliyuncs.com/compatible-mode/v1apiKeyYOUR_API_KEYlangzh-CN crossoriginanonymous /script其中YOUR_API_KEY替换为你的真实 Key。两点注意如果某个参数值本身含有或?字符比如你的服务地址还带查询串先做 URL 编码如写成%26否则会被拆成其他参数。只改部分参数也是合法的缺省项回落到上表的默认值。可选分支autoInitfalse 后手动初始化README 与 快速开始页 都记录了另一条路径URL 加上autoInitfalse脚本只加载不自动创建 demo agent之后用new window.PageAgent(...)手动初始化并使用自定义 LLMscript srchttps://cdn.jsdelivr.net/npm/page-agent1.12.3/dist/iife/page-agent.demo.js?autoInitfalse crossoriginanonymous /script script const agent new window.PageAgent({ model: qwen3.5-plus, baseURL: https://dashscope.aliyuncs.com/compatible-mode/v1, apiKey: YOUR_API_KEY, language: zh-CN, }) /script需要customFetch、transformRequestBody、disableNamedToolChoice等 URL 参数覆盖不到的配置时走这条路。注意它与 URL 参数是两种独立方式同页二选一autoInitfalse时不会自动创建实例window.pageAgent保持未初始化。验证参数是否生效demo 入口内置了控制台日志demo.ts加载页面后在浏览器 Console 里依次确认脚本加载完成会输出 page-agent.js loaded!初始化完成后输出 page-agent.js initialized with config:后面紧跟实际使用的 config 对象——核对其中的model、baseURL是否就是你传的值这是判断 URL 参数生效的直接依据showPanel为true默认时页面上出现操作面板可以直接输入自然语言指令让 agent 操作页面传showPanelfalse则只创建实例、不显示面板实例仍在window.pageAgent上可按快速开始页的示例用agent.execute(点击登录按钮)这类方式编程调用。window.PageAgent是构造函数脚本始终挂载方便手动初始化window.pageAgent是自动创建的实例。demo 入口在自动初始化前还会先dispose()页面上已有的旧实例所以重复注入同一脚本不会产生多个 agent 并存。边界与注意事项免费测试端点仅用于技术评估。官方模型文档明确该端点仅供 PageAgent.js 与 PageAgent Extension 的技术评估和研发使用禁止用于生产环境数据经中国大陆服务器处理不要输入任何个人身份信息或敏感数据使用即表示同意其使用条款。免费端点只覆盖qwen3.5-plus/qwen3.5-flash两个模型——换model的同时必须换baseURL和apiKey否则请求会打到测试端点。不要把真实 API Key 留在前端。官方模型文档的红线是“永远不要把真实的 LLM API Key 提交到前端代码中”。写在 URL 查询参数里意味着任何能看到该 URL 的人都能拿到 Key因此这种配法适合本地测试和技术评估计划集成进自己的 Web 应用时官方建议搭建后端代理转发 LLM 请求并通过customFetch携带 Cookie 或其他鉴权信息该配置不在 URL 参数范围内需走手动初始化路径。脚本若检测不到script元素document.currentScript为 null入口会回退到构建期环境变量LLM_MODEL_NAME/LLM_BASE_URL/LLM_API_KEY否则用内置 demo 默认值按正常script标签引入时不会进入这个分支。下一步模型选型可对照 models 文档页 的已测试模型清单本地 Ollama / LM Studio 的接入要求和启动参数也在该页的 “Local LLMs” 一节。需要 URL 参数覆盖不到的配置项生产鉴权、Prompt 缓存、工具扩展等时切换到autoInitfalse手动初始化完整配置项参见 PageAgentCore 文档。【免费下载链接】page-agentJavaScript in-page GUI agent. Control web interfaces with natural language.项目地址: https://gitcode.com/GitHub_Trending/pa/page-agent创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考