用途:通过 coval CLI 引导用户设计并创建用于测试 AI 智能体的模拟人物(persona),按阶段依次提问,完成用例、语音语言、环境、行为和提示词配置。
主要能力与流程:
- 预检与清点:先运行 coval whoami 检查认证,未登录则用 coval login(API Key 在 https://app.coval.dev/settings 获取,账号注册见 https://coval.dev);再并行运行 coval personas list --format json 和 coval agents list --format json 清点已有资源,可复用、复制修改或新建。
- 智能体上下文:选择要测试的智能体,可用 coval agents get <agent_id> --format json 获取类型(model_type)、名称和提示词。语音类(MODEL_TYPE_VOICE / MODEL_TYPE_OUTBOUND_VOICE)会影响语音设置与对话发起方向;文本类(CHAT / WEBSOCKET / API / ENDPOINT)中语音设置仅作默认值,不影响模拟。
- 用例检测:可选 customer_support、scheduling_booking、sales、insurance_claims、healthcare_intake、restaurant_orders、debt_collection、it_helpdesk 或 other,并加载对应模板作为起点。
- 语音与语言:语言可选 en-US、es-ES、fr-FR、de-DE、pt-BR、ja-JP;声音可选女性 aria、男性 callum。文本类智能体的语音语言仅作默认存储。
- 环境与行为:背景音可选 quiet、office、cafe、airport;等待秒数可选 0.3(快速)、0.5(标准)、1.0(慢速);打断频率可选 NONE、LOW、MEDIUM、HIGH,用于合规测试、常规测试、真实对话模拟或压力测试。注意打断频率当前不是 CLI 参数,创建后需用 Coval API:PATCH /v1/personas/{persona_id} 并传 {"interruption_rate": "LOW"}。
- 提示词撰写:persona 提示词定义“来电者是谁、如何表现”(性格、说话风格、情绪),不定义要问什么(由测试用例决定)。
- 创建确认:汇总名称、声音、语言、背景、等待秒数、打断频率和提示词后,执行 coval personas create --name "<name>" --voice "<voice>" --language "<language>" --prompt "<final prompt>" --background "<background>" --wait-seconds <wait> --format json,从返回 JSON 获取 persona_id。
- 后续建议:可继续用 /build-test-suite、/configure-metrics、/quick-eval,或用 coval personas get <persona_id> 与 coval personas update <persona_id> --prompt "new prompt" 管理。
限制:需 Coval 账号与 API Key;打断频率暂不支持 CLI 参数;文本类智能体的语音语言设置不影响模拟。