Coda Packs_AI Agent skill-PHP中文网

Coda Packs

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过 Coda REST API v1 和 CODA_API_TOKEN 管理私有 Coda Packs，包括列出、创建、更新元数据及删除。

Coda Packs Skill. 管理Coda Packs通过 REST API v1. 创建,列表,更新和删除私有 Packs.

功能概述

Coda Packs Skill. 管理Coda Packs通过 REST API v1. 创建,列表,更新和删除私有 Packs.是一项面向实际任务的技能，主要用于QQ API 限制.；Coda REST API v1 的包装管理能力有限:.；

核心要点

Featu。
它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

Coda Packs 技能

通过 REST API v1 管理 Coda Packs。创建、列出、更新和删除私有 Packs。

⚠️ API 限制

Coda REST API v1 的 Pack 管理能力有限：

功能	REST API	Pack SDK CLI
列出 Packs	✅ 可用	✅
创建 Pack	✅ 可用	✅
更新 Pack	✅ 可用	✅
删除 Pack	✅ 可用	✅
构建版本（Build Versions）	❌ 不可用	✅ 必需
提交至 Gallery（Gallery Submit）	❌ 不可用	✅ 必需
分析数据（Analytics）	❌ 不可用	✅ 必需
协作者管理（Collaborators）	❌ 不可用	✅ 必需

如需构建版本、提交至 Gallery 或使用高级功能，请使用以下命令：

npx @codahq/packs-sdk register    # 创建账户
npx @codahq/packs-sdk build       # 构建 Pack
npx @codahq/packs-sdk release     # 提交至 Gallery

适用场景

当用户希望执行以下操作时，可使用本技能：

列出已有的 Coda Packs
创建新的私有 Pack 模板（shells）
更新 Pack 元数据（名称、描述）
删除未使用的 Packs

不适用场景

请勿用于 文档管理（表格、行、页面）→ 请使用 coda 技能
请勿用于 构建 Pack 版本 → 请使用 Pack SDK CLI
请勿用于 提交至 Gallery → 请使用 Pack SDK CLI
请勿用于 查看分析数据 → 请使用 Pack SDK CLI 或 Coda 网页界面

前提条件

API Token：设置环境变量 CODA_API_TOKEN
- 获取地址：https://coda.io/account → API 设置
- Token 必须具备 Pack 管理权限
Python 3.7+ 并安装 requests 库

快速开始

# 初始化配置
export CODA_API_TOKEN="your_token_here"

# 列出您的 Packs
python scripts/coda_packs_cli.py packs list

# 创建新的 Pack 模板
python scripts/coda_packs_cli.py packs create 
  --name "My Integration" 
  --description "Does cool things"

# 更新 Pack
python scripts/coda_packs_cli.py packs update my-pack-id 
  --description "Updated description"

# 删除 Pack（需确认）
python scripts/coda_packs_cli.py packs delete my-pack-id

完整 Pack 开发流程

由于 REST API 仅支持基础 Pack 管理，以下是完整的开发流程：

步骤 1：通过 REST API 创建 Pack 模板

python scripts/coda_packs_cli.py packs create 
  --name "Karakeep Bookmarks" 
  --description "Save and search bookmarks"

步骤 2–4：使用 Pack SDK CLI（必需）

# 安装 Pack SDK
npm install -g @codahq/packs-sdk

# 初始化 Pack 项目
npx @codahq/packs-sdk init karakeep-pack

# 开发您的 Pack（编辑 pack.ts）
# 参考文档：https://coda.io/packs/build/latest/guides/quickstart/

# 构建并上传
npx @codahq/packs-sdk build
npx @codahq/packs-sdk upload

# 准备就绪后提交至 Gallery
npx @codahq/packs-sdk release

CLI 工具使用说明

Pack 管理

# 列出所有 Pack
python scripts/coda_packs_cli.py packs list

# 获取 Pack 详情
python scripts/coda_packs_cli.py packs get 48093
python scripts/coda_packs_cli.py packs get "Karakeep"

# 创建新 Pack
python scripts/coda_packs_cli.py packs create 
  --name "My Pack" 
  --description "Description" 
  --readme "# My PacknnDetails here"

# 更新 Pack 元数据
python scripts/coda_packs_cli.py packs update my-pack-id 
  --name "New Name" 
  --description "New description"

# 删除 Pack（需确认）
python scripts/coda_packs_cli.py packs delete my-pack-id
# 或跳过确认：--force

Pack ID 解析规则

CLI 支持两种 Pack 标识方式：数字型 Pack ID 和 Pack 名称：

# 以下两条命令等效：
python scripts/coda_packs_cli.py packs get 48093
python scripts/coda_packs_cli.py packs get "Karakeep"

若名称存在歧义，CLI 将列出所有匹配项并退出。

安全防护机制

需确认的操作

操作	风险等级	确认提示
删除 Pack	不可逆	"确认删除 Pack 'X'？此操作无法撤销。"

无需确认的操作

创建 Pack：安全，可逆
列出 / 获取 Pack：只读操作
更新 Pack：可逆

错误处理

常见 API 错误：

状态码	含义	解决方法
`401`	Token 无效	刷新 CODA_API_TOKEN
`403`	权限不足	确保 Token 具备 Pack 管理权限
`404`	Pack 未找到	检查 Pack ID 或名称是否正确
`429`	请求频率超限	等待后重试（自动处理）