Agent Skills
返回列表
🤖

Venice 角色

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md ，安装 @user_3c6cb52e/venice-characters-5pve。

技能介绍

解决什么问题

在 Venice 上搭建角色类产品时，通常要处理三件繁琐的事：拿到一份可检索的角色目录、逐个翻出角色背后的系统提示词和底层模型，以及把这些预设人格真正塞进对话请求里。这套技能把这三件事收拢到一组 Preview API 上，让你不必再手写过滤逻辑和字段映射。

核心能力

  • 目录浏览：通过 GET /characters 按关键词、分类、标签、底层 modelId、成人标记、Pro 要求、Web 开关等条件筛选，并支持多种排序和分页。
  • 单个角色详情：GET /characters/{slug} 返回角色完整元数据，包括 slug、modelId、stats 等字段。
  • 公开评价：GET /characters/{slug}/reviews 返回分页评论，响应头带 x-pagination-*。
  • 对话注入：在聊天时把 venice_parameters.character_slug 指向角色，Venice 会自动注入该角色的 system prompt；可通过 include_venice_system_prompt=false 获得纯角色声音。
  • 模型覆盖：当角色默认模型缺少能力时，可以用 venice_parameters.model_id 或模型字符串后缀覆盖，Venice 仍会应用角色的 system prompt。

适用边界与注意点

  • 三个端点都处于 Preview，响应结构可能变化，不适合当作稳定契约长期依赖。
  • 全部端点需要认证（Bearer key 或 x402 SIWE），没有公开的匿名接口。
  • slug 是角色在 venice.ai/c/ 页面的公开 ID，不是内部 id UUID；用错会直接 404。
  • photoUrl、shareUrl、userAvatarUrl 可能为 null，展示层要做兜底。
  • 角色默认的 modelId 可能是 Pro 或 beta 模型；如果总是沿用角色自带模型，要优雅处理 401。
  • 未显式传 isAdult=true 时，成人向角色会被自动省略。

使用场景

  • 在搭建角色选择器界面时，通过调用 `GET /characters` 按标签和排序规则拉取角色列表。
  • 想发布预设角色时，用 `GET /characters/{slug}` 获取系统提示词和底层模型配置作为参考。
  • 在构建教学助手聊天时，通过 `character_slug` 把哲学家角色系统提示词注入对话。
  • 应用需要网络搜索能力时，过滤 `isWebEnabled=true` 的角色来筛选支持联网的角色。

适合人员

  • 开发聊天应用的后端工程师，需要在对话请求中动态加载预设角色。
  • 构建角色发现页的前端工程师，需要按分类和标签展示角色列表。
  • 为 Agent 选型的工程师，需要对比不同角色的底层模型与评分数据。
  • 运营自定义角色的开发者，需要检查角色元数据和公开评价反馈。