Peranan pakar (agency-agents)

Berikan agent run satu identiti pakar — peguam, penganalisis data, penjaga jenama — daripada pustaka agency-agents yang dibundel. Peranan membentuk siapa agent ITU untuk tugasan berkenaan (kepakaran, peraturan, nada), sebelum prompt asas.

Apakah yang dilakukan peranan

Peranan pakar (iaitu persona) ialah suis identiti. Apabila anda menghantar slug peranan kepada agent run, agent itu mengambil perspektif kepakaran tersebut untuk tugasan — pengetahuan domainnya, peraturan kerja dan gaya komunikasinya — sambil mengekalkan keupayaan alat penuhnya dan jenama Nexevo. Ia berbeza daripada skill, yang merupakan buku panduan aliran kerja yang dipakai agent: peranan ialah siapa agent itu.

Peranan adalah pilih-masuk dan manual sepenuhnya. Tanpa peranan dipilih, agent berjalan sebagai Nexevo tulen. Anda memilih satu daripada pustaka (atau menu peranan penggubah aplikasi); tiada penghalaan automatik ke peranan.

Senaraikan peranan tersedia

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

pustaka skills + peranan workspace. Entri dengan kind: "agency" ialah peranan pakar; kind: "official" / "custom" ialah skills. Tapis pada kind untuk mendapatkan peranan sahaja.

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,
#     ...
#   },
#   ...
# ]

Setiap entri peranan membawa: slug (id yang anda hantar kepada run), name, description, category / division (bidang peranan — kejuruteraan, pemasaran, kewangan, reka bentuk…) dan metadata paparan (emoji, division_label, division_color). Pustaka merangkumi 18 bidang dengan berpuluh peranan pakar — daripada engineering-backend-architect ke design-brand-guardian ke finance-cfo.

Jalankan dengan peranan

Hantar slug peranan sebagai persona_slug dalam agent run. Identiti peranan disuntik sebagai pengepala pada prompt sistem; agent mengekalkan semua alatnya.

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": "…"}

Selebih-lebihnya satu peranan setiap run. persona_slug yang hilang atau dilumpuhkan merosot senyap ke identiti Nexevo garis asas — run tidak pernah gagal kerana carian peranan.

Peranan ialah identiti, bukan senarai putih alat. Agent mengekalkan keupayaan penuhnya (web, kod, pelayar, penyambung); peranan membentuk cara ia menaakul dan berkomunikasi, bukan apa yang boleh dilakukannya. Pasangkan peranan dengan skills untuk hasil terkuat — identiti domain serta buku panduan aliran kerja.