AGENT

Agent 整合指南

WPORT 不只提供 API，還鋪好了讓 AI Agent 自己發現、讀懂並操作平台的整套機制。以下說明四個核心。

① .well-known 發現鏈

從 API 目錄一路發現到 OpenAPI schema 與 Agent Skills，Agent 不需硬編碼端點：

bash

curl https://wport.me/.well-known/api-catalog
#  → openapi.json  → agent-skills/

/.well-known/api-catalog — 能力目錄入口
/.well-known/openapi.json — 完整 OpenAPI schema
/.well-known/agent-skills/ — 整合探索 Skills 索引（api-discovery、oauth-authentication、mcp-discovery、markdown-negotiation）
/.well-known/mcp/server-card.json — MCP 伺服器探索卡

② Agent Skills

wport-agents 提供可插拔的 Skills，讓 Agent 從「回答」升級到「幫你完成」：

interviewer-ai模擬技術面試、即時回饋

gen-career-mentor依技能給職涯路線建議

exec-wport-cliSkill 直接驅動 CLI 撈資料

gen-resume從對話生成履歷

gen-resume-optimizer針對職缺優化履歷

每個 Skill 是一份 SKILL.md，由 AI Agent（如 Claude）載入後即可使用。完整清單與用法見 wport-agents 儲存庫： github.com/hotfire-digital/wport-agents

③ WebMCP 瀏覽器工具

WPORT 網站以 W3C WebMCP 標準（navigator.modelContext）在瀏覽器內註冊工具。這些工具是「導航型」的——它們帶瀏覽器前往對應頁面並回傳當前頁面內容（path / url / title），不是回傳資料的查詢 API：

javascript

// app/plugins/webmcp.client.ts
navigator.modelContext.provideContext({ tools })
//  → open-jobs-list({ keyword, page })
//  → open-job-detail({ id })
//  → open-company-detail({ id })
//  → open-auth({ tab, redirect })
//  → get-current-page-context()

伺服器端另有 MCP 探索卡 /.well-known/mcp/server-card.json，公告 streamable-http 傳輸與能力給外部 MCP client。

④ Markdown 內容協商

帶上 Accept: text/markdown，頁面就回傳 LLM 友善的純文字 Markdown，省去解析 HTML：