ابزارها و مهارتها
خواندن یک مهارت
اطلاعات یک مهارت را همراه متن دستورها و SKILL.md آن بخوانید.
GET
/v1/skills/{slug}علاوه بر فیلدهای فهرست، پاسخ instructions (متن دستورها) و skill_md (فایل SKILL.md کامل با سرآیند name و description) را دارد. فایلهای کمکی را از دانلود مهارت بگیرید. مهارتی که وجود ندارد، یا برای سطح API کلید شما باز نیست، 404 skill_not_found میدهد.
نمونهها
curl https://1ai.ir/v1/skills/invoice-review \
-H "Authorization: Bearer $ONEAI_API_KEY"200پاسخ
{
"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"
}
],
"updated_at": 1792950000,
"instructions": "Compare each invoice line with the purchase order.\nList every mismatch in quantity, price or tax.\nUse checklist.md for the final summary.",
"skill_md": "---\nname: invoice-review\ndescription: \"Checks an invoice against the purchase order and lists mismatches.\"\n---\n\nCompare each invoice line with the purchase order.\nList every mismatch in quantity, price or tax.\nUse checklist.md for the final summary.\n"
}پارامترهای مسیر
slugstringالزامینام مهارت (
idدر فهرست). حروف بزرگ و کوچک فرقی ندارد.
خطاها
skill_not_found404مهارتی با این نام نیست یا برای کلید شما باز نیست.
rate_limit_exceeded429سقف تعداد درخواست در دقیقهی کلید پر شده.