需配置Comet为Perplexity外部工具代理，通过API网关转发任务；在提示词中用@comet:run+YAML触发调用；启用Webhook事件反馈；统一output_format为perplexity_v1；限制并发频次防上下文污染。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望Perplexity在执行复杂任务时借助Comet实现高效工作流调度，则需明确其底层协同机制与可配置的触发路径。以下是具体实施步骤：
一、配置Comet作为Perplexity外部工具代理
Perplexity可通过API网关将任务请求转发至Comet运行时环境，使Comet承担计算密集型子任务的执行与状态回传。该方式依赖于双向认证与结构化payload映射。
1、登录Perplexity开发者控制台，进入Settings → External Tools页面。
2、点击Add Tool，选择Custom HTTP Endpoint类型。
3、在URL字段填入Comet部署实例的/public/execute端点地址，例如https://your-comet-instance.com/public/execute。
4、在Authentication字段选择Bearer Token，并粘贴Comet Admin API Key。
5、在Request Schema中定义JSON Schema，确保包含task_id、payload、timeout_ms三个必填字段。
二、在Perplexity提示词中嵌入Comet调用指令
通过特定语法标记触发Comet执行，Perplexity会自动识别并封装为结构化调用，避免手动构造HTTP请求。
1、在提问或指令中使用@comet:run前缀引导任务分发。
2、紧随其后以YAML格式声明参数块，包括type（如data_extraction、code_execution）、input（原始输入数据）、constraints（如max_steps: 8, max_runtime_ms: 120000）。
3、确保YAML块前后各保留一行空行，使Perplexity解析器能准确切分上下文边界。
4、提交后，Perplexity将暂停本地推理，转而向已注册的Comet端点发起POST请求，并等待status=completed响应。
三、启用Comet事件驱动反馈通道
当Comet完成子任务后，需将结果异步推送回Perplexity上下文，而非仅返回原始JSON响应。此过程依赖Webhook注册与payload签名验证。
1、在Comet管理界面进入Webhooks → Create New，目标URL填写Perplexity提供的/callback/comet/v1端点。
2、勾选Events：task_completed、task_failed、task_timeout三项。
3、在Secret Key字段填入与Perplexity External Tools设置中一致的HMAC密钥。
4、保存后，Comet每次任务终态变更均生成X-Comet-Signature头，Perplexity据此校验来源合法性并注入对应thread_id的对话流。
四、调试Comet与Perplexity间的数据序列化差异
Comet默认输出为紧凑JSON，而Perplexity期望带元信息的富文本片段，二者字段语义不一致会导致解析失败或内容截断。
1、在Comet任务模板的output_schema中显式声明output_format: perplexity_v1。
2、该格式要求响应体必须包含content（字符串，支持Markdown）、metadata（对象，含source、confidence、timestamp）、trace_id（字符串，与Perplexity初始request_id匹配）三个顶层键。
3、若Comet返回content为空字符串或仅含空白符，Perplexity将跳过该段落渲染且不报错。
4、使用curl命令手动模拟Comet响应，验证Perplexity是否在/devtools/network中捕获到200 OK及Content-Type: application/json。
五、限制Comet并发调用频次防止上下文污染
多个并行Comet调用可能因响应乱序导致Perplexity将A任务结果错误绑定至B任务上下文，需通过客户端节流与服务端队列策略双重控制。
1、在Perplexity External Tools配置页，将Rate Limit设置为3 requests/60s。
2、启用Comet侧的FIFO Queue Mode，在config.yaml中设queue_strategy: strict_sequential。
3、对同一用户session_id的所有@comet:run指令，Perplexity自动附加x-perplexity-seq-id头，Comet据此排序执行。
4、若检测到seq-id跳变或重复，Comet返回HTTP 409 Conflict并附带retry-after: 1200，Perplexity暂停后续调用直至冷却期结束。
