قد تكون واجهة برمجية (API) موثقة بشكل مثالي للبشر ومع ذلك يكون من المستحيل تقريبًا على وكيل الذكاء الاصطناعي استخدامها.
يصف OpenAPI الواجهة — المسارات والطرق والمخططات. لكن الوكيل يحتاج إلى المزيد: أوصاف على مستوى النية، ومصادقة قابلة للقراءة آليًا، وتلميحات استرداد الأخطاء، وتصنيفات السلامة. الفجوة بين "موثقة للبشر" و"قابلة للفهم من قبل الوكلاء" لا تتعلق بذكاء النموذج. بل تتعلق بطبقات سياق مفقودة.
تحدد هذه المقالة طبقات السياق الثماني التي تحدد ما إذا كان وكيل مستقل يمكنه اكتشاف وفهم واستخدام واجهتك البرمجية بنجاح.
The Agent Context Flow
When an agent receives a task — "find a payment API and process a refund" — it runs through a decision chain:
Agent ↓ "Where is the API?" → Discovery ↓ "What can I do here?" → Capabilities ↓ "What do I need to provide?" → Inputs ↓ "Do I have permission?" → Authentication ↓ "What does this mean?" → Semantics ↓ "What will I get back?" → Output ↓ "What if something breaks?" → Errors ↓ "Is it safe to do this?" → Safety ↓ SUCCESS / FAILURE
Each layer is a potential failure point. A human developer compensates with experience and intuition. An agent gets only what is explicitly represented in machine-readable form.
1. Discovery — "What is this API?"
An agent cannot use an API it cannot find. Machine-readable discovery is the first layer.
Bad: No llms.txt, no .well-known endpoints, no ai-sitemap.xml. The API is invisible to autonomous discovery.
Better: llms.txt at root with API summary. /.well-known/openapi for spec discovery. ai-sitemap.xml listing API endpoints.
لا يوجد تعليقات بعد، كن أول من يبدأ النقاش