完成

​

用户交互模型

​

协议消息

​

请求完成

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "completion/complete",
  "params": {
    "ref": {
      "type": "ref/prompt",
      "name": "code_review"
    },
    "argument": {
      "name": "language",
      "value": "py"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "completion": {
      "values": ["python", "pytorch", "pyside"],
      "total": 10,
      "hasMore": true
    }
  }
}

​

引用类型

​

完成结果

• 每个响应最多100个项目
• 可选的可用匹配总数
• 指示是否存在额外结果的布尔值

​

消息流程

​

数据类型

​

CompleteRequest

• ref：PromptReference 或 ResourceReference
• argument：包含的对象：
  • name：参数名称
  • value：当前值

​

CompleteResult

• completion：包含的对象：
  • values：建议数组（最多100个）
  • total：可选的总匹配数
  • hasMore：额外结果标志

​

实现考虑

1. 服务器应该：
   • 按相关性返回排序的建议
   • 在适当的地方实现模糊匹配
   • 对完成请求进行速率限制
   • 验证所有输入
2. 客户端应该：
   • 对快速完成请求进行去抖
   • 在适当的地方缓存完成结果
   • 优雅地处理缺失或部分结果

​

安全

• 验证所有完成输入
• 实现适当的速率限制
• 控制对敏感建议的访问
• 防止基于完成的情報披露