专家角色（agency-agents）

为一次 agent 运行赋予专家身份——律师、数据分析师、品牌守护者——选自内置的 agency-agents 角色库。角色决定了 agent 在该任务中“是谁”（专业领域、规则、语气），注入在基础提示词之前。

角色的作用

专家角色（persona）是一个身份开关。当你把角色的 slug 传给一次 agent 运行时，agent 会以该角色的专业视角执行任务——它的领域知识、工作规则和沟通风格——同时保留全部工具能力和 Nexevo 品牌。它与Skills不同：技能是 agent 执行的工作流手册，而角色是 agent 是谁。

角色完全是可选的、手动的。不选角色时，agent 以纯 Nexevo 身份运行。你从角色库（或应用输入框的角色菜单）中选一个；系统不会自动路由到角色。

列出可用角色

GET/v1/workspaces/{workspace_id}/skill-library —

工作区的技能 + 角色库。kind: "agency" 的条目是专家角色；kind: "official" / "custom" 是Skills。按 kind 过滤即可只取角色。

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/skill-library \
  -H "Authorization: Bearer $NEXEVO_API_KEY"
# [
#   {
#     "slug": "engineering-ai-engineer",
#     "name": "AI Engineer",
#     "description": "Expert AI/ML engineer ...",
#     "kind": "agency",
#     "category": "engineering",
#     "emoji": "🤖",
#     "division": "engineering",
#     "division_label": "Engineering",
#     "enabled": true,
#     ...
#   },
#   ...
# ]

每个角色条目包含：slug（传给运行的角色 id）、name、description、category / division（角色所属领域——工程、市场、财务、设计……），以及展示元数据（emoji、division_label、division_color）。角色库覆盖 18 个领域、数十个专家角色——从 engineering-backend-architect（后端架构师）到 design-brand-guardian（品牌守护者）到 finance-cfo（CFO）。

以角色身份运行

在 Agent runs中把角色的 slug 作为 persona_slug 传入。角色的身份会作为头部注入系统提示词；agent 保留全部工具。

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "审查我们的结账流程，找出流失点并提出 3 个改进方案。",
    "persona_slug": "design-ux-architect"
  }'
# -> {"run_id": "…", "trace_id": "…"}

每次运行最多一个角色。persona_slug 缺失或已禁用时会静默回退到基线 Nexevo 身份——运行绝不会因为角色查找失败而中断。

角色是身份，不是工具白名单。agent 保留全部能力（网页、代码、浏览器、连接器）；角色塑造的是它如何推理和沟通，而非它能做什么。将角色与Skills搭配使用效果最强——领域身份加上工作流手册。