files

用途

该技能用于在 Google Drive 中管理通过 Shift 创建或上传的文件。当用户希望创建文件夹、上传文件、查看文件元数据，或为这些文件设置共享时，可以使用此托管技能。

主要能力

• 列出通过 Shift 创建或上传的文件，支持查询条件、分页大小和排序。
• 获取指定文件的详细信息。
• 创建文件夹，可指定父文件夹。
• 上传本地文件，可指定名称、MIME 类型、父文件夹和描述。
• 通过预编译代码技能助手直接上传原始内容。
• 将上传的内容转换为 Google Doc。
• 为文件设置共享，可指定接收者类型、角色和邮箱地址。

使用方式

该技能使用 Shift 的本地 Skill Router，基础地址为 SHIFT_LOCAL_GATEWAY，调用端点为 POST /skill-router/invoke。

列出通过 Shift 创建或上传的文件：

{
  "skillProvider": "google-drive",
  "skill": "files",
  "action": "list",
  "input": {
    "query": "mimeType = 'application/vnd.google-apps.folder'",
    "pageSize": 10,
    "orderBy": "modifiedTime desc"
  }
}

获取文件详情：

{
  "skillProvider": "google-drive",
  "skill": "files",
  "action": "get",
  "input": {
    "fileId": "1AbCdEfGhIjKlMnOp"
  }
}

创建文件夹：

{
  "skillProvider": "google-drive",
  "skill": "files",
  "action": "create-folder",
  "input": {
    "name": "Launch assets",
    "parentIds": ["1AbCdEfGhIjKlMnOp"]
  }
}

上传本地文件：

{
  "skillProvider": "google-drive",
  "skill": "files",
  "action": "upload",
  "input": {
    "filePath": "/tmp/launch.html",
    "name": "launch.html",
    "mimeType": "text/html",
    "parentIds": ["1AbCdEfGhIjKlMnOp"],
    "description": "Launch page draft"
  }
}

上传原始内容：

node dist/index.js '{
  "operation": "upload-content",
  "name": "launch.html",
  "mimeType": "text/html",
  "content": "<html><body><h1>Launch</h1></body></html>",
  "parentIds": ["1AbCdEfGhIjKlMnOp"]
}'

将上传内容转换为 Google Doc：

node dist/index.js '{
  "operation": "upload-content",
  "name": "launch.html",
  "mimeType": "text/html",
  "targetMimeType": "application/vnd.google-apps.document",
  "content": "<html><body><h1>Launch</h1></body></html>",
  "parentIds": ["1AbCdEfGhIjKlMnOp"]
}'

共享文件：

{
  "skillProvider": "google-drive",
  "skill": "files",
  "action": "share",
  "input": {
    "fileId": "1AbCdEfGhIjKlMnOp",
    "type": "user",
    "role": "writer",
    "emailAddress": "teammate@example.com"
  }
}

认证

该技能需要在 Shift 中配置 Google Drive 连接。它面向通过 Shift 创建或上传的文件。

代理行为建议

• 当用户未提供文件 ID 时，先使用 list 再使用 get。
• 当用户已有运行时机器上的本地文件路径时，使用 upload。
• 直接上传内容或转换为 Google Doc 时，使用 node dist/index.js '<json payload>'。
• 该技能用于通过 Shift 创建或上传的文件，不用于浏览整个现有 Drive。
• 仅当用户明确指定接收者和所需角色时，才使用 share。

适用场景

适用于需要通过 Shift 在 Google Drive 中创建文件夹、上传文件、查看元数据或管理共享的用户。

限制

该技能不用于浏览整个现有 Drive，仅针对通过 Shift 创建或上传的文件。需要先在 Shift 中配置 Google Drive 连接。