支持的工具
前置条件
- 袋袋账号 + Developer 角色
- API Key(在 开发者控制台 创建,格式
profy_sk_*) - 专家需要开启 API 访问(
apiAccess: "open")
方式一:Skill 接入(推荐,零基础设施)
Skill 是一个 Markdown 文件,教 AI 编程工具如何调用袋袋 API。安装后,agent 会自动识别何时调用袋袋专家。Claude Code
“用袋袋的 react-architect 专家审查一下这段代码”Claude Code 会自动按 Skill 指引调用
POST https://api.profy.cn/v1/experts/react-architect/chat。
Cursor
Codex / Cline / Gemini CLI
将SKILL.md 放到项目根目录的 agent skills 目录(具体路径因工具而异),确保环境变量 PROFY_API_KEY 已设置。
方式二:MCP Server 接入
MCP (Model Context Protocol) 提供更强的集成能力,让 AI 工具以结构化工具调用的方式使用袋袋专家。配置 .mcp.json
在项目根目录创建 .mcp.json:
Claude Code 注册
可用 Tools(MCP Server 上线后)
MCP Server 端点
mcp.profy.cn 正在开发中。当前请先使用 Skill 方式接入。API 端点速查
所有请求均需Authorization: Bearer $PROFY_API_KEY。
Base URL: https://api.profy.cn
调用专家示例
text/event-stream),Header 中 X-Session-Id 用于多轮对话。
多轮对话
OpenAI 兼容
创作者:如何让你的专家被 AI 编程工具调用
- 在 Studio 中编辑你的专家
- 设置 API 访问 为
开放(任何持有 API Key 的开发者可调用) - 发布新版本
常见问题
Skill 和 MCP 有什么区别?
Skill 和 MCP 有什么区别?
- Skill:纯文本指令,教 AI 如何 curl 你的 API。零基础设施,跨平台兼容。
- MCP Server:结构化工具协议,AI 以 function call 方式调用。更强但需要服务端支持。
返回 403 怎么办?
返回 403 怎么办?
专家的
api_access 字段为 off(默认值)。联系专家创作者开启 API 访问,或换一个 api_access: open 的专家。SSE 流怎么解析?
SSE 流怎么解析?
响应为标准 Server-Sent Events 格式。每行以
data: 开头,最终以 data: [DONE] 结束。大多数 HTTP 客户端和 AI 工具原生支持 SSE 解析。支持哪些模型?
支持哪些模型?
通过
/v1/chat/completions 端点,支持平台已接入的所有模型(DeepSeek、Qwen 等)。具体可用模型取决于平台配置。计费怎么算?
计费怎么算?
按 token 计费(METERED),从 API Key 所属用户的积分中扣除。可在开发者控制台查看用量。

