ابزارها و مهارت‌ها

خواندن یک مهارت

اطلاعات یک مهارت را همراه متن دستورها و 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

    سقف تعداد درخواست در دقیقه‌ی کلید پر شده.

صفحه‌های مرتبط