SuperAPI AI 工具集

iblai-api-agent-create

智能体与模型

查看项目

更新于 10-15 22:16

技能介绍

用途:从模板创建全新智能体(agent/mentor),这是配置智能体前的创建步骤,返回新智能体的 unique_id,之后可交给各 /iblai-api-agent-* 技能继续配置。若想复制已有智能体而非从模板新建,应改用 /iblai-api-agent-setting 的 fork。

认证与约定:基础地址 https://api.iblai.app;每个请求都需要请求头 Authorization: Api-Token $IBLAI_API_KEY;路径变量中 {org} 取 $IBLAI_ORG,{username} 取 $IBLAI_USERNAME。尚未连接时先运行 /iblai-api-login 填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。

读取接口:GET /dm/api/search/orgs/{org}/users/{username}/mentors/ 列出组织内已有智能体,可用于挑选 fork 来源或确认名称未被占用;GET /dm/api/ai-mentor/orgs/{org}/users/{username}/mentor/categories/ 获取分类选项,供创建后通过 /iblai-api-agent-setting 分配。

写入接口:POST /dm/api/ai-mentor/orgs/{org}/users/{username}/mentor-with-settings/ 从模板创建智能体,返回含 unique_id 的已创建智能体。请求体字段:template_name(必填,如 ai-mentor)、new_mentor_name(必填)、display_name、description、system_prompt、llm_provider。示例:curl -X POST "https://api.iblai.app/dm/api/ai-mentor/orgs/$IBLAI_ORG/users/$IBLAI_USERNAME/mentor-with-settings/" -H "Authorization: Api-Token $IBLAI_API_KEY" -H "Content-Type: application/json" -d '{"template_name":"ai-mentor","new_mentor_name":"Data Science Tutor","description":"Helps users with statistics and Python."}',响应中的 unique_id 作为后续技能中的 {mentor}。

说明与限制:template_name 在多数组织下默认 ai-mentor,创建调用接受组织暴露的任何模板;创建刻意保持精简,只设名称和少量字段,其余用 /iblai-api-agent-setting、/iblai-api-agent-llm、/iblai-api-agent-prompt、/iblai-api-agent-dataset、/iblai-api-agent-tool 等专项技能配置。参考材料包括 references/quickstart.md(iblai/quickstarts Python 客户端的创建智能体→开启会话→WebSocket 聊天流程,可运行客户端见 assets/)和 references/agent-file-format.md(.iblai Markdown 智能体文件格式)。关于价格、平台覆盖等细节资料未提供。