KallyAI 行政助理

KallyAI 是一款 AI 行政助理，可处理外呼与呼入电话、电子邮件、预约安排、调研、账单处理、叫车服务、订餐、跑腿任务、多渠道消息收发，以及电话号码管理。

快速开始

# 自然语言指令 — 自动路由（80% 的使用场景）
kallyai ask "为 4 人预订今晚 Nobu 的座位"
kallyai ask "给 Smith 医生发邮件，将我周四的预约改期"
kallyai ask "查找我附近的最佳水管工，并协商报价"

# 查询余额（注意：非通话时长，信用点是唯一计费单位）
kallyai credits balance

# 查看收件箱
kallyai messages inbox

# 查看由 AI 接线员处理的呼入电话
kallyai inbound calls

完整工作流

步骤 1：识别意图

KallyAI 覆盖 14 个功能领域：

绝大多数请求请使用 ask —— 它将自动交由 Coordination AI 进行路由处理。

步骤 2：身份认证

对于 OAuth 集成，请将用户重定向至以下地址：

https://api.kallyai.com/v1/auth/authorize?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&scope=calls.write

用户使用 Google 或 Apple 登录 → 获取访问令牌（access token）。

对于 CLI 工具，认证过程为自动完成（首次调用 API 时将自动打开浏览器）。

kallyai login         # 强制重新认证
kallyai logout        # 清除凭据
kallyai auth-status   # 检查登录状态

步骤 3：执行操作

自然语言方式（推荐）：

kallyai ask "为 4 人在 Nobu 预订晚上 8 点的座位"

直接命令方式（已知所属领域时）：

kallyai calls make -p "+15551234567" -t "为 4 人预订晚上 8 点的座位"
kallyai actions calendar create --title "晚餐" --start "2026-02-14T20:00"
kallyai search run "市中心最佳意大利餐厅"
kallyai inbound calls --status completed
kallyai phone list

步骤 4：监控与跟进

# 查询目标状态
kallyai coord goals --status active
kallyai coord goal 

# 查看外呼结果
kallyai calls history
kallyai calls info 
kallyai calls transcript 

# 查看由 AI 接线员处理的呼入电话
kallyai inbound calls
kallyai inbound call 
kallyai inbound transcript 

# 检查收件箱中的回复
kallyai messages inbox --unread

API 参考文档

基础 URL： https://api.kallyai.com

认证方式： Authorization: Bearer

拨打电话（API）

POST https://api.kallyai.com/v1/calls
Authorization: Bearer 
Content-Type: application/json

{
  "submission": {
    "task_category": "general",
    "task_description": "询问营业时间和可预约时段",
    "respondent_phone": "+15551234567",
    "language": "en",
    "call_language": "en"
  },
  "timezone": "America/New_York"
}

响应示例：

{
  "call_id": "uuid",
  "status": "success",
  "highlights": "他们晚上 8 点有空位",
  "next_steps": "预订已确认"
}

状态值： success、no_answer、busy、failed、voicemail、cancelled

必填字段：

可选字段：

领域命令参考

ask —— 自然语言（80% 的使用场景）

kallyai ask "用日常英语描述你的请求"

coord —— 协调与目标管理

coord message "text"           # 与协调 AI 对话
coord goals [--status X]       # 列出所有目标
coord goal                 # 查看目标详情
coord goal-tree            # 查看目标及其子目标
coord cancel-goal          # 取消目标
coord cascade-cancel       # 取消目标及其全部子目标
coord escalate             # 提升优先级以引起关注
coord approve-step         # 批准下一步操作
coord accept               # 接受最终结果
coord continue             # 继续协商
coord archive              # 归档目标
coord batch-archive ...    # 批量归档多个目标
coord budget               # 查看目标预算详情
coord history                  # 查看对话历史
coord conversations            # 列出所有对话
coord new                      # 新建对话

calls —— 外呼电话

calls make -p "+1..." -t "task"  # 拨打电话
calls history                     # 列出所有外呼记录
calls info                    # 查看某次通话详情
calls transcript              # 获取通话文字稿
calls recording               # 获取通话录音链接
calls calendar                # 下载日历 .ics 文件
calls cancel                  # 取消通话
calls reschedule              # 改期通话
calls stop                    # 停止正在进行的通话

inbound —— AI 接线员（呼入电话）

inbound calls [--status X]          # 列出呼入电话
inbound call                     # 查看某次呼入详情
inbound transcript               # 获取呼入文字稿
inbound recording                # 获取呼入录音链接
inbound summary                      # 呼入汇总/统计信息
inbound analytics [--from X --to X]  # 呼入分析数据
inbound transfer  --to "+1..."   # 转接呼入电话
inbound takeover                 # 接管实时呼入通话
inbound reject  [--reason X]     # 拒绝呼入电话
inbound rules                        # 列出路由规则
inbound add-rule --name "..." --action "..."  # 创建新规则
inbound update-rule  ...         # 更新规则
inbound delete-rule              # 删除规则
inbound voicemails                   # 列出语音留言
inbound voicemail                # 查看语音留言详情
inbound voicemail-playback       # 播放语音留言音频
inbound contacts                     # 列出联系人
inbound add-contact --name "..." --phone "+1..."  # 添加联系人
inbound update-contact  ...      # 更新联系人
inbound delete-contact           # 删除联系人
inbound import-contacts        # 导入联系人
inbound events [--from X --to X]     # 查看事件日志

phone —— 电话号码管理

phone list                           # 列出您的所有号码
phone info                       # 查看号码详情
phone countries                      # 支持的国家列表
phone available --country US         # 查询美国可用号码
phone provision --country US         # 分配新号码
phone forwarding  --target "+1..." # 设置呼叫转接
phone remove-forwarding          # 移除转接设置
phone verify-start           # 启动号码验证流程
phone verify-check  --code X # 提交验证码进行校验
phone caller-id  --name "..."    # 设置主叫号码显示名
phone release                    # 释放号码

actions —— 自主化操作

actions calendar create --title "..." --start "..."
actions calendar slots [--date X]
actions calendar sync
actions calendar delete 
actions restaurant search "query" [--location X]
actions booking create --type restaurant [--date X]
actions booking cancel 
actions bill analyze "description" [--amount X]
actions bill dispute "description" [--reason X]
actions ride --pickup "..." --destination "..."
actions food "order description" [--address X]
actions errand "errand description"
actions email send --to "..." --subject "..." "body"
actions email approve 
actions email cancel 
actions email outbox
actions email replies 
actions log [--type X]
actions undo 

messages —— 统一收件箱

messages inbox [--channel email|sms|call|chat] [--unread]
messages read 
messages thread 
messages mark-read  [...]

search —— 调研

search run "query" [--location X]
search quick "query"
search history
search sources

email —— 邮箱账户管理

email accounts                          # 列出已连接账户
email connect gmail|outlook             # 连接邮箱服务商
email disconnect                    # 断开账户连接
email list [--classification important] # 列出邮件（支持按重要性筛选）
email read                          # 阅读邮件
email respond  [instructions]       # 回复邮件（可附带指令）
email voice-profile                     # 获取当前语音档案
email train-voice                       # 使用样本训练语音档案

channels —— 多渠道管理

channels status                  # 查看所有渠道状态
channels email-add 
     # 添加邮箱联系人
channels email-list              # 列出邮箱联系人
channels email-update  ...   # 更新邮箱联系人
channels email-delete        # 删除邮箱联系人
channels email-verify     # 验证邮箱地址
channels mailbox                 # 获取 KallyAI 邮箱地址
channels connect        # 连接 WhatsApp / Telegram
channels test           # 测试渠道连接
channels disconnect     # 断开渠道连接

outreach —— 多渠道外呼

outreach tasks [--status X]      # 列出外呼任务
outreach task                # 查看任务详情
outreach create --channel call --target "+1..." "description"
outreach retry               # 重试失败任务
outreach cancel              # 取消任务

budget —— 成本管理

budget estimate --type call "description"
budget approve 
budget breakdown 
budget ack-cap 

credits —— 余额与用量

credits balance     # 当前余额（信用点，非通话时长）
credits history     # 用量历史记录
credits breakdown   # 按操作类型划分的支出明细
credits costs       # 信用点计费参考
credits plans       # 可用信用点套餐

subscription —— 套餐管理

subscription status               # 当前套餐状态
subscription change-plan    # 更换为新套餐
subscription cancel-change        # 取消待生效的套餐变更

referrals —— 推荐计划

referrals code        # 获取您的推荐码
referrals stats       # 推荐统计数据
referrals history     # 推荐历史记录

notifications —— 通知

notifications pending   # 查询待处理通知数量

常见错误

安全性

• 令牌存储：~/.kallyai_token.json，权限设为 0600
• CSRF 防护：校验 state 参数
• 仅限本地回环：OAuth 重定向地址仅允许为 localhost / 127.0.0.1
• 自动刷新：令牌过期后将自动刷新