BuilderIO/agent-native / packages/core/docs
agent-native-docs
UnverifiedHow to look up version-matched Agent-Native framework docs and source in node_modules. Use before coding against @agent-native/core APIs or advanced features.
content/locales/ar-SA/template-calendar-agent.mdx
View on GitHub---
title: "التقويم: التحدث مع الوكيل"
description: "ما يراه الوكيل عندما تكون في التقويم، والمطالبات المنظمة بحسب المهمة، والوقت الذي يلجأ فيه إلى واجهة برمجة تطبيقات Google Calendar الخام بدلاً من إجراء جاهز."
---
# التحدث مع الوكيل
كل شيء في التقويم متاح للوكيل من خلال نفس الإجراءات التي تستخدمها واجهة
المستخدم، لذا فإن أي شيء يمكنك النقر عليه، يمكنك أيضًا طلبه بلغة طبيعية بسيطة.
تغطي هذه الصفحة كيف يرى الوكيل شاشتك، والمطالبات المفيدة بحسب المهمة، والمكان
الذي يتجاوز فيه الإجراءات المدمجة. راجع [التقويم](/docs/template-calendar)
للحصول على نظرة عامة.
## كيف يرى الوكيل شاشتك
يعرف الوكيل دائمًا عرض التقويم الحالي، والنطاق الزمني الذي تنظر إليه، والحدث
الذي حددته. لهذا السبب تُحل عبارات مثل "أعد جدولة هذا" أو "من في هذه المكالمة"
بشكل صحيح دون أن تسمّي الحدث. يعرف الوكيل مسبقًا ما تشير إليه كلمة "هذا".
## مطالبات مفيدة بحسب المهمة
تتحول كل مطالبة أدناه إلى إجراء حقيقي على تقويمك الفعلي، نفس التقويم الذي
تقرأه وتكتب عليه واجهة المستخدم. وهذا مثال واحد مفصّل:
<Comparison>
### :blue: أنت تسأل
"هل أنا متفرغ بعد ظهر الخميس؟"
### :green: ما يحدث
هذا سؤال للقراءة فقط. يتحقق الوكيل من تقويمك الحقيقي وقواعد توفرك، ثم يجيب
مباشرة في الدردشة، على سبيل المثال "أنت متفرغ من الساعة 1 إلى 4 مساءً." لا
يتغير أي شيء على شاشتك، لأنه لم يُنشأ أو يُنقل أي شيء.
</Comparison>
<Cards columns={2}>
### الجدولة
- **"حدد مكالمة مدتها 30 دقيقة مع أليكس غدًا في الساعة 2 مساءً."** يظهر
الحدث على تقويمك لحظة إنشائه. لا حاجة إلى أي مربع حوار.
- **"أنشئ اجتماع Zoom مع فريق التصميم يوم الخميس في الساعة 10."** نفس ما
سبق، ويُرفق رابط Zoom تلقائيًا.
- **"اجعلني خارج المكتب يوم الجمعة."** يظهر حدث خارج المكتب يستغرق اليوم كله
على تقويمك فورًا.
### العثور على وقت
- **"ابحث عن فترة ساعة واحدة الأسبوع المقبل مع سام وبريا واحجز عليها
'التخطيط'."** يتحقق الوكيل من توفر الجميع الحقيقي، ثم يظهر الحدث الجديد
على تقويمك مباشرة. لا حاجة إلى أي مربع حوار.
### إدارة الأحداث
_مع تحديد حدث، تُحل كلمتا "هذا" و"هذا الاجتماع" من تلقاء نفسهما._
- **"انقل هذا الحدث إلى يوم الجمعة في الساعة 2 مساءً."** ينتقل الحدث على
شبكة تقويمك مباشرة.
- **"أضف جوردان إلى هذا الاجتماع كضيف اختياري."** يظهر جوردان في قائمة
الحاضرين فورًا.
- **"اقبل هذه الدعوة." / "ارفض مع ملاحظة أنني غائب ذلك اليوم."** يُحدَّث
ردّك على الحدث فورًا.
- **"حذف هذا الاجتماع، بالنسبة لي فقط. أنا لست المنظّم."** يختفي الاجتماع
من تقويمك. لا يزال الحاضرون الآخرون يرونه في تقويماتهم.
### روابط الحجز
- **"أنشئ رابط حجز تمهيدي مدته 15 دقيقة مع حقل اسم."** يظهر نوع الاجتماع
الجديد في قائمة روابط الحجز الخاصة بك مباشرة.
- **"أضف برنت كمضيف مشارك مطلوب على رابطي 'Steve + Brent'."** يظهر برنت
كمضيف مشارك فورًا، ولا تُفتح الفترات المستقبلية إلا عندما تكونان متفرغين
كلاكما.
- **"أوقف رابطي '30 min demo' مؤقتًا."** يظهر الرابط متوقفًا مؤقتًا فورًا
ويتوقف عن قبول حجوزات جديدة.
- **"أرني حجوزات هذا الأسبوع."** سؤال للقراءة فقط. يجيب الوكيل في الدردشة
بالقائمة.
### الأشخاص والعرض
- "من هي جين في acme.com؟"
- "أضف تقويم بريا إلى عرضي."
- "بدّل إلى عرض اليوم وانتقل إلى الاثنين المقبل."
</Cards>
## روابط الحجز الجماعية والمضيفين المشاركين
عندما يحتوي رابط الحجز على مضيفين مشاركين مطلوبين، لا يعرض الوكيل (وواجهة
المستخدم) فترة إلا عندما يكون المالك _و_ كل مضيف مشارك متفرغين. يتحقق من
جميع تقويماتهم، لا من تقويم المالك فقط. بعد أن يحجز أحد، يدعو الوكيل كل
مضيف مشارك إلى حدث Google Calendar الذي تم إنشاؤه إلى جانب الزائر.
<Diagram id="doc-block-calendar5" title="كيف يتدفق طلب الجدولة" summary="سواء نقرت في التقويم أو سألت الوكيل، تقرأ نفس الإجراءات مباشرة من Google Calendar وتكتب مرة أخرى إلى نفس العرض. يتصل Zoom والبحث عن الأشخاص بنفس التدفق.">
```html
<div class="diagram-flow">
<div class="diagram-col">
<div class="diagram-node">
أنت تنقر<br /><small class="diagram-muted"
>السحب، شريط الأدوات، الاختصارات</small
>
</div>
<div class="diagram-node">
أنت تسأل الوكيل<br /><small class="diagram-muted"
>"ابحث عن فترة ساعة واحدة الأسبوع المقبل"</small
>
</div>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
<div class="diagram-panel center">
<span class="diagram-pill accent">Actions</span
><small class="diagram-muted"
>list-events · find-a-time · search-people · create-event</small
>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">→</div>
<div class="diagram-col">
<div class="diagram-box">
Google Calendar<br /><small class="diagram-muted"
>مباشر، متعدد الحسابات</small
>
</div>
<div class="diagram-box">
Zoom<br /><small class="diagram-muted">يُنشأ اجتماع عند الحجز</small>
</div>
<div class="diagram-box">
SQL<br /><small class="diagram-muted">الحجوزات · التوفر</small>
</div>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">↻</div>
<div class="diagram-box">يتم تحديث عرض التقويم مباشرة</div>
</div>
```
```css
.diagram-flow {
display: flex;
align-items: center;
gap: 12px;
flex-wrap: wrap;
}
.diagram-flow .diagram-col {
display: flex;
flex-direction: column;
gap: 10px;
}
.diagram-flow .diagram-arrow {
font-size: 22px;
line-height: 1;
}
.diagram-flow .center {
display: flex;
flex-direction: column;
align-items: center;
gap: 4px;
}
```
</Diagram>
## عندما يتوجه الوكيل مباشرة إلى واجهة برمجة تطبيقات Google Calendar
تغطي الإجراءات المدمجة (`list-events` و`search-events` و`find-a-time` وما
شابه) الجدولة اليومية. تحتاج بعض الطلبات إلى نقطة نهاية أو مرشّح أو نمط ترقيم
صفحات محدد في Google Calendar لا تعرضه الإجراءات، مثل فحص كل حدث على مدى ستة
أشهر لإعداد تقرير، أو استعلام غير معتاد عن قائمة التقويمات. في هذه الحالات،
يمكن للوكيل استدعاء واجهة برمجة تطبيقات Google Calendar الحقيقية مباشرة
بدلاً من إجبار الإجابة على المرور عبر إجراء أضيق. بالنسبة للفحوصات الكبيرة،
يُدرج النتائج في مجموعة بيانات مؤقتة ويعمل من ملخص مختصر بدلاً من إلقاء آلاف
الأحداث في المحادثة. ستلاحظ ذلك عادةً كعبارة "دعني أستخرج ذلك مباشرة من
Google Calendar" في الطلبات التي تتجاوز سؤال الجدول الزمني العادي.
## الامتدادات
يدعم التقويم الامتدادات: أدوات صغيرة معزولة يمكنك أنت أو الوكيل بناؤها
وإدراجها في التطبيق. تعرض لوحة تفاصيل الحدث فتحة في الأسفل يمكن أن يُعرض فيها
امتداد، مع توفر معرّف الحدث وعنوانه وأوقاته ومناطقه الزمنية وموقعه وحاضريه
وحسابه له مسبقًا. راجع [الامتدادات](/docs/extensions) لمعرفة كيفية بناء
واحد.
## ما التالي
- [**التقويم**](/docs/template-calendar) — نظرة عامة وخطوات البدء
- [**الميزات**](/docs/template-calendar-features) — طرق العرض، والتوفر، والعثور على وقت مناسب، وروابط الحجز، مع خطوات إعداد لكل منها
- [**التقويم في مساحة عمل متعددة التطبيقات**](/docs/template-calendar-integrations) — استراتيجيات التكامل والاتصال بـ Dispatch
- [**دليل المطور**](/docs/template-calendar-developers) — كل إجراء، ونموذج البيانات، وكيفية توسيع التطبيق
- [**الامتدادات**](/docs/extensions) — بناء أداة لفتحة تفاصيل الحدث
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |