مهارت‌ها

خواندن پیش‌تنظیم‌های پرامپت در دسترس یک فضای کاری.

مهارت‌ها پیش‌تنظیم‌های پرامپت‌اند که در کنسول تعریف می‌شوند. این مسیر می‌گوید یک فضای کاری کدام‌ها را می‌تواند استفاده کند، تا آن‌ها را به‌عنوان گزینه نشان بدهید و هنگام پرسیدن یکی را به‌عنوان skill_id بفرستید.

فهرست مهارت‌ها

اجتماع مهارت‌های محدود به این فضای کاری و مهارت‌های محدود به اپ آن را برمی‌گرداند — مهارت سطح اپ از همهٔ فضاهای زیرش قابل استفاده است.

GET/workspaces/{workspace_id}/skills/

فیلد	نوع	توضیح
`id`	`uuid`	شناسهٔ یکتا که سرور تولید می‌کند.
`title`	`string`	نام نمایشی مهارت.
`description`	`string`	این مهارت به چه کاری می‌آید.
`core_prompt`	`string`	دستوری که هنگام استفاده از مهارت به پرامپت سیستم اضافه می‌شود.
`scope`	`global \| application \| workspace`	جایی که مهارت تعریف شده — سراسری، روی اپ، یا روی یک فضای کاری.
`category`	`string \| null`	حوزه‌ای که مهارت سراسری به آن تعلق دارد. برای مهارت‌های کاربر null است.

cURL

JavaScript

Python

curl "https://api.daneshyar.info/api/v1/workspaces/8f14e45f-ceea-467a-9f4c-1a2b3c4d5e6f/skills/" \
  -H "X-API-Key: dk_live_9f3aC2xQ7mB1vT8sE4nK6pR0jY5wZ2hL"

پاسخ

{
  "status": "ok",
  "data": {
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
      {
        "id": "0a7f3d52-8e61-4b90-ac35-6d2f19c847be",
        "title": "Clinical summary",
        "description": "Answer as a concise clinical summary with dosages called out.",
        "core_prompt": "Summarise for a practising clinician. Always surface dosages...",
        "category": "health",
        "application_id": "c4e18b6a-9d70-4f21-8b53-2a6f0e7c9d84",
        "workspace_id": null,
        "scope": "application",
        "created_at": "2026-08-01T12:00:00.000Z",
        "updated_at": "2026-08-01T12:00:00.000Z"
      }
    ]
  }
}

این مسیر فقط‌خواندنی است. مهارت‌ها در کنسول نوشته می‌شوند؛ در API مشتری، ساخت، ویرایش و حذفی وجود ندارد.

id

uuid

شناسهٔ یکتا که سرور تولید می‌کند.

title

string

نام نمایشی مهارت.

description

string

این مهارت به چه کاری می‌آید.

core_prompt

string

دستوری که هنگام استفاده از مهارت به پرامپت سیستم اضافه می‌شود.

scope

global | application | workspace

جایی که مهارت تعریف شده — سراسری، روی اپ، یا روی یک فضای کاری.

category

string | null

حوزه‌ای که مهارت سراسری به آن تعلق دارد. برای مهارت‌های کاربر null است.

{ "status": "ok", "data": { "count": 1, "next": null, "previous": null, "results": [ { "id": "0a7f3d52-8e61-4b90-ac35-6d2f19c847be", "title": "Clinical summary", "description": "Answer as a concise clinical summary with dosages called out.", "core_prompt": "Summarise for a practising clinician. Always surface dosages...", "category": "health", "application_id": "c4e18b6a-9d70-4f21-8b53-2a6f0e7c9d84", "workspace_id": null, "scope": "application", "created_at": "2026-08-01T12:00:00.000Z", "updated_at": "2026-08-01T12:00:00.000Z" } ] } }