전문가 역할(agency-agents)

번들로 제공되는 agency-agents 라이브러리에서 가져온 전문가 정체성(변호사, 데이터 분석가, 브랜드 수호자 등)을 agent run에 부여합니다. 역할은 베이스 프롬프트보다 앞서 해당 작업에서 agent가 누구인지(전문 분야, 규칙, 어조)를 결정합니다.

역할이 하는 일

전문가 역할(즉, persona)은 정체성 전환입니다. 역할의 slug를 agent run에 전달하면 agent는 해당 작업에서 그 전문 분야의 관점(도메인 지식, 작업 규칙, 커뮤니케이션 스타일)을 채택하되, 전체 도구 역량과 Nexevo 브랜드는 유지합니다. 이는 agent가 적용하는 워크플로 플레이북인 skill과 다릅니다. 역할은 agent가 누구인지를 정의합니다.

역할은 완전히 옵트인이며 수동입니다. 역할을 선택하지 않으면 agent는 일반 Nexevo로 실행됩니다. 라이브러리(또는 앱의 컴포저 역할 메뉴)에서 하나를 선택하며, 역할로의 자동 라우팅은 없습니다.

사용 가능한 역할 나열

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

워크스페이스의 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까지 아우릅니다.

역할로 실행하기

역할의 slug를 agent run의 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": "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는 전체 역량(web, code, browser, connectors)을 유지하며, 역할은 어떻게 추론하고 소통하는지를 다룰 뿐 무엇을 할 수 있는지를 제한하지 않습니다. 가장 강력한 결과를 원한다면 역할과 skills를 조합하세요. 도메인 정체성에 워크플로 플레이북을 더한 조합입니다.