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-chat-agent.mdx
View on GitHub---
title: "الدردشة: التحدث مع الوكيل"
description: "ما يعرفه الوكيل عن المكان الذي أنت فيه داخل الدردشة، ومطالبات منظمة بحسب المهمة."
---
# التحدث مع الوكيل
في الدردشة، المحادثة هي الطريقة الرئيسية لاستخدام التطبيق. يستطيع الوكيل تشغيل
إجراءات التطبيق، والبحث عن الأشياء، وتذكّر ما تخبره به، ونقلك إلى صفحات أخرى.
تغطي هذه الصفحة ما يعرفه الوكيل عن شاشتك، ومطالبات مفيدة بحسب المهمة، والمكان
الذي يتجاوز فيه الإجراءات المدمجة. راجع [الدردشة](/docs/template-chat) للحصول
على نظرة عامة.
## كيف يرى الوكيل شاشتك
يعرف الوكيل دائمًا في أي صفحة أنت وأي محادثة مفتوحة. لهذا تعمل عبارات مثل
"take me back to Home" أو "what page am I on?" دون أي شرح. يخبر التطبيق الوكيل
بكل تغيير في الصفحة لحظة حدوثه، فلا يضطر الوكيل إلى التخمين.
ليس في الدردشة بيانات عمل يمكن الإشارة إليها، مثل حدث محدد أو مستند مفتوح. كل
ما عدا ذلك يعرفه الوكيل مما تقوله في المحادثة.
## مطالبات مفيدة بحسب المهمة
تعمل كل مطالبة أدناه على التطبيق الحقيقي. وهذا مثال واحد مفصّل:
<Comparison>
### :blue: أنت تسأل
"استدعِ الإجراء hello لـ Alex."
### :green: ما يحدث
يشغّل الوكيل إجراء المثال **hello** بالاسم Alex. يعيد الإجراء "Hello, Alex!"
ويعرضه الوكيل في الدردشة. لا يتغير أي شيء آخر في التطبيق.
</Comparison>
<Cards columns={2}>
### تعرّف على ما يستطيع التطبيق فعله
- **"What can this app do?"** يسرد الوكيل الإجراءات التي لديه وما يفعله كل
منها.
- **"Show me the available actions."** الفكرة نفسها، كقائمة بسيطة بالأسماء.
- **"Help me get started."** يقترح الوكيل أول شيء تجربه.
### تنقّل
- **"Take me to Settings."** يفتح التطبيق الصفحة لك.
- **"Open the Database page."** يفتح الوكيل `/database`، وهي غير مرتبطة من
الشريط الجانبي.
- **"Go back to Home."** تُفتح صفحة Get started.
### علّم الوكيل
- **"Remember that I prefer short answers."** يحفظ الوكيل ذلك في ذاكرته،
ويستخدمه في الدردشات اللاحقة.
- **"From now on, always explain your reasoning before answering."** يستطيع
الوكيل حفظ هذا كتعليمة دائمة.
- **"What do you remember about me?"** يقرأ الوكيل ذاكرته عليك.
### اطّلع على بياناتك
- **"What tables are in this app's database?"** يقرأ الوكيل بنية قاعدة
البيانات ويسرد الجداول.
- **"How many chats do I have?"** ينفّذ الوكيل سؤالًا للقراءة فقط على قاعدة
البيانات ويجيب في الدردشة.
### تعلّم إطار العمل
- **"How do I add a new action to this app?"** يبحث الوكيل في وثائق
Agent-Native ويشرح الخطوات.
- **"What's the difference between an action and a skill?"** الأمر نفسه،
والإجابة من الوثائق.
</Cards>
<Callout tone="info">
يقرأ الوكيل قاعدة البيانات لكنه لا يغيّرها مباشرة. لحفظ معلومات جديدة، يستخدم
إجراءً. يُبقي ذلك كل تغيير على المسار نفسه الذي تستخدمه شاشات التطبيق. يمكن
للمطور تغيير ذلك في إعداد التطبيق.
</Callout>
## ما التالي
- [**الدردشة**](/docs/template-chat) — نظرة عامة
- [**الميزات**](/docs/template-chat-features) — المحادثات، وإجراء المثال، والفرق، وصفحات الإدارة
- [**الدردشة في مساحة عمل متعددة التطبيقات**](/docs/template-chat-integrations) — ربط الدردشة بـ Dispatch وتطبيقات أخرى
- [**دليل المطور**](/docs/template-chat-developers) — البدء السريع، والإجراءات، ومسار الدردشة، وإضافة أول ميزة
- [**الوعي بالسياق**](/docs/context-awareness) — كيف يعرف الوكيل ما على شاشتك
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: 471k | 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 |