الأكاديمية ← ميزات Hermesتوثيق رسمي · إرشاد عربي

وضع التسليم: مخرجات جاهزة داخل المحادثة

Deliverable Mode (Artifacts in Chat)

متوسط5 دقائق قراءةالدرس 48سؤالان✓ 2026-08-18
قبل أن تقرأ

ما هذه الصفحة، وماذا تحتوي.

بوابة المراسلة: الوصلة التي تجعلك تكلّم Hermes من تطبيق تستعمله أصلًا، مثل Telegram أو WhatsApp، بدل الطرفية. الوكيل الذي تصله من هاتفك تستعمله فعلًا. الذي يحتاج فتح الحاسوب تنساه بعد أسبوع. القراءة نحو 5 دقائق. انتبه: افتح القناة لنفسك فقط في البداية عبر قائمة سماح. القناة المفتوحة تعني أن أي شخص يراسل وكيلك.

6أقسام
1أمثلة برمجية
2جداول
0أوامر
798كلمة من المصدر
الوصف الرسمي في سطر

How the agent ships generated charts, PDFs, spreadsheets, and other files as native attachments in messaging platforms.

ماذا ستستطيع بعدها

نتائج مأخوذة من هذه الصفحة، لا من قالب.

  • تعرف ما بوابة المراسلة ولماذا قد تحتاجه.
  • تقرأ الجدول وتأخذ منه السطر الذي يخصّك فقط.
  • تعرف الخطأ الشائع: افتح القناة لنفسك فقط في البداية عبر قائمة سماح. القناة المفتوحة تعني أن أي شخص يراسل وكيلك.
خريطة الصفحة

انتقل مباشرة إلى ما تحتاجه.

  1. 01How it works
  2. 02Supported file extensions
  3. 03Encouraging the agent to produce artifacts
  4. 04Kanban: artifacts ride completion notifications
  5. 05Connecting more services with MCP
  6. 06Comparison to Perplexity Computer in Slack
الصفحة الرسمية كاملة

بلا اختصار أو حذف.

النص أدناه منقول من المصدر الرسمي بالإنجليزية حتى تبقى الأوامر والأسماء دقيقة كما هي. قبل كل قسم شرح عربي يوضّح ما بداخله.

When Hermes Agent runs inside a messaging gateway (Slack, Discord, Telegram, WhatsApp, Signal, etc.), it can deliver generated files directly into the chat — not as paths the user has to copy, but as native attachments.

A chart shows up as an inline image. A PDF report shows up as a file download. A spreadsheet uploads as .xlsx. The agent does not need to write a MEDIA: tag or do anything special — it just generates the file and mentions its absolute path in the response. The gateway picks the path out of the text, removes it from the visible message, and uploads the file natively.

How it works

شرح للفكرة نفسها. اقرأه ببطء، فبقية الأقسام تبني عليه. تذكير: الوصلة التي تجعلك تكلّم Hermes من تطبيق تستعمله أصلًا، مثل Telegram أو WhatsApp، بدل الطرفية.

Three pieces fit together:

  1. The agent has tools that produce files. execute_code for charts via matplotlib, the docx skill for Word documents, the xlsx skill for spreadsheets, the pdf and latex-pdf-report skills for PDFs, the powerpoint skill for decks, image_generate for images, text_to_speech for audio, and so on.
  1. The gateway scans agent responses for file paths. Any absolute path (/tmp/...) or home-relative path (~/...) ending in a supported extension gets extracted. Paths inside code blocks and inline code are ignored so code samples are never mutilated.
  1. The gateway dispatches by file type. Images embed inline where the platform supports it; videos embed inline; audio routes to voice/audio attachments; everything else uploads as a file attachment.

Supported file extensions

جدول مرجعي. لا تقرأه كله، ابحث عن السطر الذي يخصّك فقط.

CategoryExtensionsDelivery
Images.png .jpg .jpeg .gif .webp .bmp .tiff .svgInline embed
Video.mp4 .mov .avi .mkv .webm .3gpInline embed (where supported)
Audio.mp3 .m2a .wav .ogg .opus .m4a .flacVoice / audio attachment
Documents.pdf .docx .doc .odt .rtf .txt .md .epubFile upload
Data.xlsx .xls .ods .csv .tsv .json .xml .yaml .ymlFile upload
Geospatial.kmz .kml .geojson .gpxFile upload
Presentations.pptx .ppt .odp .keyFile upload
Archives.zip .tar .gz .tgz .bz2 .xz .7z .rar .apk .ipaFile upload
Web.html .htmFile upload

.py, .log, and other source-file extensions are intentionally excluded so the agent doesn't auto-ship arbitrary source files; if you want to send code to the user, use a code block.

Encouraging the agent to produce artifacts

شرح للفكرة نفسها. اقرأه ببطء، فبقية الأقسام تبني عليه.

The agent doesn't reach for artifacts by default — it has to know to. Two ways to nudge it:

Per-session: ask explicitly ("send me the comparison as a chart", "return the data as a CSV") or write your own custom-instructions / personality entry that biases toward artifact-style replies on messaging platforms.

Project-level: add the bias to AGENTS.md / CLAUDE.md / .cursorrules in a project the agent works from, to your global persona in ~/.hermes/SOUL.md, or as a named preset under agent.personalities in ~/.hermes/config.yaml (switchable per session via /personality).

The mechanic the agent has to use is simple: render the file to an absolute path (e.g. /tmp/q3-revenue.png) and mention that path as plain text in the reply. The gateway does the rest. Paths inside fenced code blocks or backticks are ignored so code samples are never mutilated.

Kanban: artifacts ride completion notifications

شرح للفكرة نفسها. اقرأه ببطء، فبقية الأقسام تبني عليه.

If you use Hermes' kanban multi-agent workflow, workers can attach deliverable files to their kanban_complete call:

Python7 أسطر
kanban_complete(
    summary="rendered Q3 revenue chart and report",
    artifacts=[
        "/tmp/q3-revenue.png",
        "/tmp/q3-report.pdf",
    ],
)

When the gateway notifier delivers the "task completed" message to whoever subscribed to the task in Slack/Telegram/etc., it also uploads each artifact as a native attachment to that chat. The human gets the deliverable and the summary in one place.

Files that don't exist on disk when the notifier runs are silently skipped.

Connecting more services with MCP

جدول مرجعي. لا تقرأه كله، ابحث عن السطر الذي يخصّك فقط.

Beyond the artifact-delivery pipeline, the agent can reach into other services via MCP (Model Context Protocol). The MCP ecosystem ships community servers for most popular tools — install whichever you need:

ServiceWhat it unlocks
NotionRead/write Notion pages, databases, query workspace
GitHubIssues, PRs, comments, repo search beyond the gh CLI
LinearTickets, projects, cycles
SlackWorkspace-wide search, read other channels
GmailInbox triage, send mail, label management
SalesforceLeads, opportunities, account data
Snowflake / BigQuerySQL against data warehouses
Google DriveFile search, contents, share management

Install MCP servers via ~/.hermes/config.yaml under the mcp_servers section. See MCP integration for the full setup guide.

Comparison to Perplexity Computer in Slack

شرح للفكرة نفسها. اقرأه ببطء، فبقية الأقسام تبني عليه.

Perplexity Computer's Slack integration is built around the same idea: the agent generates a deliverable (chart, PDF, slide deck) and posts it back into the thread as a native attachment. Hermes Agent's deliverable mode provides the same user-facing pattern locally:

  • Generation happens in the user's own venv / sandbox (no remote tenant).
  • Files land in the chat via the same Slack files.uploadV2 API.
  • Connector breadth comes via MCP rather than a curated catalog of 400 hosted integrations — install the ones you actually use.

OAuth tokens stay on the user's machine in auth.json / .env. No hosted token storage. No multi-tenant microVM. Same end result.

اختبار الفهم

سؤالان إجاباتها كلها في هذه الصفحة.

كل خيار اسم حقيقي من توثيق Hermes. حتى الخيارات الخاطئة حقيقية، لكنها من صفحات أخرى.

1. في جدول هذا الدرس، ما «Extensions» المقابل لـ«Web»؟
2. أي عنوان من التالي لا يظهر في هذا الدرس؟