بنية الوكلاءالمهارات العامة

Credentials Management

عمليات بيانات الاعتماد الآمنة — طلب أسرار وقت التشغيل مع التحقق من النطاق، تدوير المفاتيح حسب الجدول، الإبطال عند الاختراق، وتدقيق كل الوصولات.

افتح مصدر المهارة اقرأ الدليل الرسمي ↗

ما تعلمه هذه المهارة

دليل قابل لإعادة الاستخدام لنوع معين من العمل.

يخبر خادم MCP الوكيل بالإجراءات المتاحة. تضيف المهارة الحكم حول تلك الإجراءات: كيفية التعرف على المهمة، التسلسل الذي يجب اتباعه، ما يجب تجنبه، وكيفية تحديد اكتمال النتيجة.

إدارة بيانات الاعتماد بأمان — سرد الأسرار المتاحة، طلب رموز وقت التشغيل، تدوير المفاتيح، إلغاء الوصول، وتدقيق الاستخدام. استخدمه عند استرجاع مفاتيح API، تدوير الأسرار، فحص بيانات الاعتماد، تدقيق الوصول، أو التحقق من نطاقات الأسرار.

الهيكلية

كيف يوجه Credentials Management وكيل ADK-Rust.

تبقى المهارة قابلة للقراءة وقابلة للنقل لأنها تحتوي على تعليمات بدلاً من بيانات اعتماد الخدمة أو بيانات العمل. يوفرها ADK-Rust للوكيل، يختار الوكيل من حدود الأدوات المراجعة، ويؤدي خادم MCP المتصل العملية المصادق عليها.

طلب المستخدم

يتلقى الوكيل هدفًا معبرًا عنه بلغة عادية.

→

مهارة Credentials Management

يطابق النية، يزود دليل القرار، ويضيق حدود الأداة.

→

وكيل ADK-Rust

يخطط سير العمل ويبث كل خطوة ذات معنى عبر بيئة التشغيل.

→

mcp-credentials-vault

ينفذ العمليات المصادق عليها ضد النظام الذي يمتلك القدرة.

→

النتيجة الموثوقة

تشكل قواعد إكمال المهارة الأدلة التي تُعاد إلى المستخدم.

تعليمات محمولة: SKILL.md · حدود القدرة: mcp-credentials-vault · الأدوات المسموح بها: 8

دليل القرار

كيف يحول الوكيل الطلب إلى الإجراء الصحيح.

تأتي هذه المسارات مباشرة من تعليمات المهارة. تساعد النموذج على التعرف على النية واختيار أداة أو سير عمل مركّز بدلاً من الارتجال عبر كامل سطح القدرة.

"get secret", "API key", "token"?

request_runtime_secret / request_workload_token

"rotate", "renew", "refresh"?

rotate_credential

"revoke", "disable", "compromised"?

revoke_credential

"audit", "who accessed", "usage"?

audit_credential_access

"list", "what secrets", "available"?

list_credentials / get_credential_metadata

"validate", "scope", "permission"?

validate_secret_scope

سير عمل مثبتة

تسلسلات قابلة للتكرار لنتائج مفيدة.

يربط سير العمل عدة استدعاءات أدوات في مهمة يتعرف عليها المستخدم فعليًا. تشرح المهارة التسلسل والنتيجة المقصودة بينما يقوم ADK-Rust ببث تقدم الوكيل عبر بيئة التشغيل المشتركة.

011-2 استدعاء

طلب سر

التحقق من النطاق → التسليم مع مدة صلاحية

021 استدعاء

تدوير

إنشاء جديد → التحقق → إيقاف القديم

031 استدعاء

إلغاء

إبطال فوري

041 استدعاء

تدقيق

سجل الوصول حسب بيانات الاعتماد/الوقت

حدود الأداة

قد تستخدم المهارة 8 أدوات موثقة.

يتم إعلان هذه القائمة المسموح بها من قبل المهارة. تحافظ على تركيز الوكيل على الإجراءات اللازمة لهذه المهمة بينما يحتفظ mcp-credentials-vault بالمسؤولية عن المصادقة، التحقق، والنظام المتصل.

list_credentials

get_credential_metadata

request_runtime_secret

request_workload_token

rotate_credential

revoke_credential

audit_credential_access

validate_secret_scope

قواعد العمل

ما الذي يجب على الوكيل القيام به.

حدد الغرض/السياق عند طلب الأسرار
احترم مدة الصلاحية — لا تخزن مؤقتاً بعد انتهاء الصلاحية
قم بالتدوير وفق الجدول، وليس فقط عند الاختراق
دقق كل الوصول للامتثال

حدود التشغيل

ما الذي يجب على الوكيل تجنبه.

لا تسجل أو تعرض قيم بيانات الاعتماد كنص عادي أبداً
لا تخزن الأسرار مؤقتاً بعد انتهاء صلاحيتها
لا تطلب نطاق أوسع من اللازم
لا تتجاهل سجل التدقيق

التثبيت والاتصال

أضف المهارة بجانب القدرة التي تتوقعها.

ثبت المستودع حيث يمكن لمحمّل مهارات ADK-Rust اكتشافه، اتصل بـ mcp-credentials-vault، وتأكد من توفر الأدوات المعلنة قبل طلب الوكيل استخدام سير العمل.

ثبت المهارة

git clone https://github.com/zavora-ai/skill-credentials-management.git \
  ~/.skills/skills/credentials-management

شكل تحميل ADK-Rust

let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("credentials-management").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

بيان التوافق الخاص بالمستودع: يتطلب اتصال بخادم mcp-credentials-vault.

الوثائق الرسمية

اقرأ حزمة المهارة الكاملة.

يبقى المستودع هو المرجع الدقيق لتعليماته، أمثلته، سكريبتات المساعدة، الأصول، متطلبات MCP، الترخيص، والتحديثات اللاحقة.

نظرة عامة ↗README.md تعليمات المهارة ↗SKILL.md سير عمل عبر Mcp ↗references/cross-mcp-workflows.md أمثلة ↗references/examples.md تسلسلات الأدوات ↗references/tool-sequences.md فحص التدوير ↗scripts/rotation_check.py تقرير التدوير ↗assets/rotation-report.md

استمر في الاستكشاف