Skip to main content

​
Agent Skill

安装 socq-social-research 技能，教编码代理如何选择 SocQ 端点、调整输入、控制成本和完成异步采集。

​
Agent Skill 与 MCP

建议同时使用两者。MCP 提供执行能力；Agent Skill 提供端点选择、计费意识、轮询、分页和跨平台工作流指导。 计费行为和 API 密钥限制记录在 API 概述 和 身份验证 中。

​
你可以问什么

该技能指导代理执行以下操作：
  • 将用户意图映射到 Capability Registry 端点；
  • 选择 URL、用户名、主题标签或查询输入；
  • 在大型任务前检查 schema 并估算积分；
  • 当可以重试时使用幂等密钥提交；
  • 轮询异步任务而不是重新提交；
  • 按游标分页并检索原始文件；
  • 处理身份验证、参数校验、速率、积分和数据提供方错误；
  • 协调可比较的跨平台研究。

​
执行偏好

技能偏好：
  1. 远程 MCP；
  2. SocQ stdio MCP 桥；
  3. MCP 不可用时使用 CLI 或 REST。
端点引用是从与 MCP 和 OpenAPI 相同的 Capability Registry 生成的，因此端点 ID 和输入字段在集成中保持一致。

​
请求归属

由 Agent Skill 提交的任务会在 request_source 中保留 Skill 来源及其执行路径： 该技能将 _request_source: "skill" 传递到 MCP 执行工具，将 --request-source skill 传递到 CLI 命令，或将 X-Socq-Source: skill-rest 传递到直接 REST 请求。轮询现有任务不需要归因标记。