スペシャリストロール（agency-agents）
agent run にスペシャリストとしてのアイデンティティ——弁護士、データアナリスト、ブランドガーディアン——を付与します。同梱の agency-agents ライブラリから取得します。ロールは、そのタスクにおいてエージェントが「誰であるか」（専門、ルール、トーン）を形作り、ベースプロンプトより前に適用されます。
ロールの役割
スペシャリストロール（ペルソナ）はアイデンティティの切り替えです。ロールの slug を agent run に渡すと、エージェントはそのタスクにおいてその専門の視点——ドメイン知識、作業ルール、コミュニケーションスタイル——を採用しつつ、ツール能力と Nexevo ブランドを完全に保ちます。これは スキル とは異なります。スキルはエージェントが 適用する ワークフロープレイブックですが、ロールは エージェントが誰であるか を決めます。
ロールは完全にオプトインかつ手動です。ロールを選ばなければ、エージェントは通常の Nexevo として動作します。ライブラリ（またはアプリの composer ロールメニュー）から 1 つ選びます；ロールへの自動ルーティングはありません。
利用可能なロールの一覧
GET/v1/workspaces/{workspace_id}/skill-library — ワークスペースのスキル＋ロールライブラリ。kind: "agency" のエントリがスペシャリストロール、kind: "official"／"custom" が スキル です。kind で絞り込めばロールのみ取得できます。
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 まで。
ロールを指定して実行
ロールの slug を agent run の persona_slug として渡します。ロールのアイデンティティはシステムプロンプトのヘッドとして注入され、エージェントはすべてのツールを保持します。
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 あたり最大 1 つのロールです。欠落または無効化された persona_slug は暗黙にベースラインの Nexevo アイデンティティへと低下します——ロールの検索が原因で run が失敗することはありません。
ロールはアイデンティティであり、ツールのホワイトリストではありません。エージェントは完全な能力（Web、コード、ブラウザ、コネクタ）を保持します；ロールが形作るのは どう推論し伝達するか であり、何ができるか ではありません。最强の結果を得るには、ロールを スキル と組み合わせてください——ドメインのアイデンティティにワークフローのプレイブックを加える構成です。