專家角色（agency-agents）

為 agent run 賦予一個專家身份——律師、資料分析師、品牌守護者——取自隨附的 agency-agents 程式庫。該角色決定了 agent 在該任務中「是誰」（專長、規則、語氣），並置於基礎 prompt 之前。

角色的作用

專家角色（一個 persona）是一種身份切換。當你將角色的 slug 傳給 agent run 時，agent 會在任務中採納該專長的視角——其領域知識、工作規則與溝通風格——同時保留完整的工具能力與 Nexevo 品牌。它與 skill 不同：skill 是 agent 套用的工作流程劇本，而角色決定的是 agent 是誰。

角色完全是選用且手動的。未挑選角色時，agent 以純粹的 Nexevo 身份執行。你從程式庫（或應用程式的 composer 角色選單）中挑選一個；系統不會自動路由到角色。

列出可用角色

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

workspace 的 skill＋角色程式庫。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（你傳給 run 的 id）、name、description、category／division（角色所屬領域——工程、行銷、財務、設計……）與顯示中介資料（emoji、division_label、division_color）。程式庫涵蓋 18 個領域、數十個專家角色——從 engineering-backend-architect 到 design-brand-guardian 到 finance-cfo。

以角色執行

在 agent run 中將角色的 slug 作為 persona_slug 傳入。角色的身份會以系統 prompt 的頭部注入；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": "Review our checkout flow for drop-off points and propose 3 fixes.",
    "persona_slug": "design-ux-architect"
  }'
# -> {"run_id": "…", "trace_id": "…"}

每次 run 最多一個角色。缺少或已停用的 persona_slug 會靜默退化為基線 Nexevo 身份——run 絕不會因為角色查詢而失敗。

角色是一種身份，不是工具白名單。Agent 會保留完整能力（網頁、程式碼、瀏覽器、connectors）；角色塑造的是 它如何推理與溝通，而非 它能做什麼。將角色與 skills 搭配可獲得最佳效果——領域身份加上工作流程劇本。