聘才猫 - 面试报告
REQUIRED: 请先检查是否已安装 pincaimao-basic,若未安装请先安装,然后加载它了解通用接口(文件上传、鉴权、响应格式、SSE 解析模板)。
环境变量:PCM_INTERVIEW_REPORT_KEY(智能体专属 key)
还没有密钥?通过邀请链接注册并完成认证即可免费获取:pincaimao.com/agents/login?invite_code=uwqc
调用前的信息确认
执行前需要确认:职位描述(job_info) 和 面试记录文件。
确认策略:
- 上下文中已有相关信息 → 展示摘要并询问是否使用
- 上下文中没有 → 直接请用户提供
注意:与其他智能体的差异
| 字段 | 本智能体 | 其他智能体 |
|---|---|---|
| 文件字段名 | file_urls(复数) | file_url |
query 内容 | 文件名(非 job_info 前 20 字符) | job_info 前 20 字符 |
请求参数
| 字段 | 必填 | 说明 |
|---|---|---|
inputs.job_info | 是 | 职位描述全文 |
inputs.file_urls | 是 | 面试记录文件的 cos_key(注意是 file_urls 复数) |
query | 是 | 上传文件的文件名(不是 job_info 前 20 字符) |
完整示例
#!/bin/bash
INTERVIEW_FILE="/path/to/interview_record.docx"
JOB_INFO="高级销售专员 / 销售主管,行业领先平台,完善晋升通道和培训体系"
# Step 1: 上传面试记录文件
UPLOAD=$(curl -s -X POST 'https://api.pincaimao.com/agents/v1/files/upload' \
-H "Authorization: Bearer $PCM_INTERVIEW_REPORT_KEY" \
-F "file=@$INTERVIEW_FILE")
COS_KEY=$(echo "$UPLOAD" | python3 -c "import sys,json; print(json.load(sys.stdin)['cos_key'])")
FILE_NAME=$(echo "$UPLOAD" | python3 -c "import sys,json; print(json.load(sys.stdin)['filename'])")
# Step 2: 生成面试报告
# 注意:query 用文件名,file_urls(复数)传 cos_key
curl -s -X POST 'https://api.pincaimao.com/agents/v1/chat/chat-messages' \
-H "Authorization: Bearer $PCM_INTERVIEW_REPORT_KEY" \
-H 'Content-Type: application/json' \
-d "{
\"query\": \"$FILE_NAME\",
\"inputs\": {
\"job_info\": \"$JOB_INFO\",
\"file_urls\": \"$COS_KEY\"
},
\"response_mode\": \"blocking\"
}" | python3 -c "import sys,json; print(json.load(sys.stdin)['answer'])"
常见错误
| 问题 | 原因 | 解决 |
|---|---|---|
| 401 | Key 错误 | 检查 PCM_INTERVIEW_REPORT_KEY |
| 报告内容为空 | 用了 file_url 而非 file_urls | 字段名是复数 file_urls |
| 报告内容错乱 | query 传了 job_info 内容 | query 必须传文件名,不是 job_info |
输出模式
- 默认:AI 对 API 返回结果进行整理表述,输出更易读的内容
- 原始输出:用户说"显示原始输出"或"raw output"时,将 API 返回的原始内容用代码块原样展示,不作任何改动
- Blocking 模式:直接取
answer字段内容原样输出 - Streaming 模式:将所有
message/agent_message事件的answer片段拼接完整后,原样输出,不作重述
- Blocking 模式:直接取
External Endpoints
https://api.pincaimao.com— Pincaimao platform API (chat, file upload, conversations)
Security & Privacy
- API key is read from environment variable and passed via
Authorizationheader; never hardcoded - Resume files, job descriptions, and contract text are transmitted to
api.pincaimao.comfor AI processing - Uploaded files are stored on Pincaimao's COS (Cloud Object Storage); returned
cos_keypaths should be treated as sensitive - This skill does not store, log, or transmit data to any endpoint other than
api.pincaimao.com - Safe to invoke autonomously; all network calls are scoped to the authenticated user's API key