Pilot S3 Bridge

将 Pilot 协议与云存储服务（AWS S3、Google Cloud Storage、Azure Blob Storage）对接，使智能体能够通过具备云访问权限的网关智能体上传、下载和管理文件。

命令

通过 Bridge 上传文件

pilotctl --json send-file s3-agent /path/to/local/file.pdf

请求从 S3 下载文件

pilotctl --json send-message s3-agent --data '{"action":"download","bucket":"my-bucket","key":"documents/file.pdf"}'

列出 S3 对象

pilotctl --json send-message s3-agent --data '{"action":"list","bucket":"my-bucket","prefix":"documents/"}'

查看已接收的文件

pilotctl --json received
pilotctl --json received --clear

请求预签名 URL

pilotctl --json send-message s3-agent --data '{"action":"presign","bucket":"my-bucket","key":"public/image.png","expires":3600}'

工作流示例

#!/bin/bash
# S3 bridge agent 设置

pilotctl --json daemon start --hostname s3-agent --public
pilotctl --json listen 1008

export AWS_ACCESS_KEY_ID="your_key"
export AWS_SECRET_ACCESS_KEY="your_secret"

while true; do
  REQUEST=$(pilotctl --json recv 1008 --timeout 120s)
  ACTION=$(echo "$REQUEST" | jq -r '.action')
  SENDER=$(echo "$REQUEST" | jq -r '.sender')
  BUCKET=$(echo "$REQUEST" | jq -r '.bucket')
  KEY=$(echo "$REQUEST" | jq -r '.key')

  case "$ACTION" in
    upload)
      pilotctl --json received > /tmp/upload_file
      aws s3 cp /tmp/upload_file "s3://$BUCKET/$KEY"
      pilotctl --json send-message "$SENDER" --data '{"status":"uploaded"}'
      ;;
    download)
      aws s3 cp "s3://$BUCKET/$KEY" /tmp/download_file
      pilotctl --json send-file "$SENDER" /tmp/download_file
      ;;
    list)
      OBJECTS=$(aws s3 ls "s3://$BUCKET/$(echo "$REQUEST" | jq -r '.prefix')" --recursive)
      pilotctl --json send-message "$SENDER" --data "$OBJECTS"
      ;;
  esac
done

依赖项

需安装 pilot-protocol 技能，运行中的 daemon，以及配置了云凭据（AWS CLI、gsutil 或 az CLI）的 S3 bridge agent。