ابزارها و مهارتها
فهرست مهارتها
مهارتهای (Agent Skills) در دسترس کلید خود را بخوانید: نام، توضیح، نسخه و فایلهای هر مهارت.
/v1/skillsمهارتها بستههای دستور و فایلهای کمکی هستند که یک عامل (agent) در قالب Agent Skills مصرف میکند: هر مهارت یک SKILL.md با توضیح کوتاه و دستورها دارد، و ممکن است فایلهای مرجع هم داشته باشد. مهارتها از پیش برای 1ai تعریف میشوند و شما فقط فهرست مهارتهای باز برای سطح API کلید خود را میبینید؛ اگر چیزی برایتان باز نباشد، data خالی است. نمونههای این صفحه از invoice-review استفاده میکنند.
مهارت اجرا نمیشود؛ فقط متن و فایل است. این مسیر اعتبار مصرف نمیکند و در سقف تعداد درخواست کلید حساب میشود.
برای متن کامل دستورها به خواندن مهارت و برای بستهی zip به دانلود مهارت بروید.
نمونهها
curl https://1ai.ir/v1/skills \
-H "Authorization: Bearer $ONEAI_API_KEY"{
"object": "list",
"data": [
{
"id": "invoice-review",
"object": "skill",
"name": "Invoice review",
"description": "Checks an invoice against the purchase order and lists mismatches.",
"version": 3,
"files": [
{
"path": "checklist.md",
"bytes": 842,
"mime_type": "text/markdown"
},
{
"path": "templates/report.md",
"bytes": 516,
"mime_type": "text/markdown"
}
],
"updated_at": 1792950000
}
]
}خطاها
invalid_api_key401کلید API نادرست یا غیرفعال است.
rate_limit_exceeded429سقف تعداد درخواست در دقیقهی کلید پر شده.