# أنشئ أول `config.yml` من متطلبات API راجعتها

أرفق `api-context.md` بعد مراجعته، وأرفق صفحات AGENTO عن Tools وMapping وAuth والبداية السريعة من الإصدار الذي تعمل عليه. استخدم هذه التعليمات في محادثة جديدة مع أي AI Model.

ابنِ أول تكامل AGENTO v2 انطلاقًا من `api-context.md` والمراجع المرفقة فقط. أريد Endpoint واحدة للقراءة تعمل على API الفعلية.

قبل كتابة YAML:
- لخّص Endpoint المختارة وما يجب أن يحدث عند نجاحها.
- توقّف واسأل عن أي UNKNOWN يؤثر على method أو URL أو نوع حقل مطلوب أو Auth. لا تملأه بتخمين.
- اكتب مسار كل قيمة من مصدرها إلى مكانها في طلب HTTP.

أنشئ ملف `config.yml` كاملًا بأقل إعدادات لازمة:
- `version` هي النص "2"، و`tools` قائمة بها Tool واحدة.
- لكل Tool `id` ثابت، و`tool.description` يحدد متى تستخدم، و`tool.input_schema` بصيغة JSON Schema draft-07.
- `input_schema` تصف Input الـ Tool، ولا ترسلها إلى API تلقائيًا.
- `request.method` و`request.url` يأتيان من توثيق الـ API. `request.map` تربط حقول `path` و`query` و`body` و`headers` صراحةً.
- داخل `request.map`، اليسار اسم الحقل في API، واليمين مصدر القيمة. `$.query` يعني الحقل `query` من Input الـ Tool، وليس `query` string ولا Environment Variable.
- استخدم `request.auth` للـ Auth: `none` لعملية عامة، أو `session` لتمرير Bearer Token من التطبيق، أو `api-key` مع `env` و`header` لمفتاح خدمة. لا تضع أسرارًا في YAML أو `input_schema` أو mapped headers.
- لا تضع `body` لطلب GET أو HEAD. لا تضف `models` أو Dependencies أو خيارات Retry إلى البداية ما لم تتطلب المهمة ذلك. إذا كانت العملية تحتاج ID من استعلام آخر، اختر البداية الأبسط أو اشرح الحاجة بدل اختراع ID.
- لا تخمّن `output_schema` من عينة واحدة. أضفها إذا تحققت من شكل الـ Response الذي تضمنه الـ API، أو بيّن أنها خطوة لاحقة.
- لا تُنشئ Endpoint أو خادم Mock، ولا تُبدّل `fetch`.
- استخدم فقط مفاتيح تدعمها مراجع AGENTO المرفقة. لا تستنتج اسم خيار من مكتبة أخرى.

بعد الملف:
1. فسّر كل مجموعة أسطر: مصدرها من توثيق الـ API، وسبب وجودها، وأثر حذفها أو تغييرها.
2. أنشئ `input.json` بقيم تجربة مناسبة من توثيق الـ API، دون أسرار.
3. أعطني أمر تشغيل `run.mjs` مع اسم الـ Tool واسم ملف الـ Input، وفق دليل البداية السريعة المرفق.
4. اكتب طلب HTTP المتوقع، وكيف أقارنه بطلب ناجح سبق تجربته مباشرةً.
5. اشرح نتائج `completed` و`needs_input` و`error` في هذه التجربة. لا تكتب معالجة تتجاوز Selection أو Confirmation تلقائيًا.
6. اكتب قائمة منفصلة بالتعديلات اليدوية المتبقية. لا تصف الملف بأنه مُختبر إلا إذا نُفّذ فعلًا.

إذا لم تكفِ المراجع، اطلبها. الناتج اقتراح قابل للمراجعة، وليس إثباتًا لصحة التكامل.