Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
/v1/agents — 用 API 创建、修改和发布专家
POST https://api.profy.cn/v1/agents
description、category、tags、changelog、overview。
curl -X POST https://api.profy.cn/v1/agents \
-H "Authorization: Bearer sk-pro-your-key" \
-H "Content-Type: application/json" \
-d '{
"name": "报关助手",
"identifier": "customs-helper",
"persona": "你是一名资深报关员…",
"sandbox": { "runtime": "python", "dependencies": ["pandas"] }
}'
{
"code": 0,
"data": {
"identifier": "customs-helper",
"version": "0.1.0",
"status": "pending_review",
"is_update": false,
"invocable": true
}
}
curl -N -X POST https://api.profy.cn/v1/agents/run \
-H "Authorization: Bearer sk-pro-your-key" \
-H "Content-Type: application/json" \
-d '{"expert_identifier": "customs-helper", "message": "试一下"}'
PATCH https://api.profy.cn/v1/agents/{identifier}
name 和 version 会自动沿用当前值。
POST https://api.profy.cn/v1/agents/{identifier}/publish
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /v1/agents?page=&page_size= | 列出你创建的专家 |
GET | /v1/agents/{identifier} | 专家详情（作者视角） |
| HTTP 状态码 | 说明 |
|---|---|
400 | 缺少 name |
401 | 认证失败 |
403 | 不是这个专家的作者，或作者资质未通过 |
404 | 专家不存在 |
409 | 专家名称重复 |