۰۲۱-۲۶۲۳۰۰۵۴ دریافت مشاوره

راهنمای پیاده‌سازی

ارزیابی استقرار داخلی Hermes Agent؛ چک‌لیست بر پایهٔ مستندات رسمی

این راهنما فقط چیزهایی را می‌گوید که مستندات رسمی Hermes Agent پشتیبانی می‌کند و بقیه را به‌صورت چک‌لیست ارزیابی می‌آورد. KSF هنوز این محصول را آزمون نکرده است؛ هیچ‌یک از مراحل زیر نتیجهٔ نصب در محیط KSF نیست.

فناوری: Hermes Agent

پیش‌نیازها

یک سرور آزمایشی ایزوله، Docker یا Podman، یک سرور مدل داخلی با زمینهٔ حداقل ۶۴ هزار توکن، دسترسی کنترل‌شده به مخزن رسمی و تیم امنیت برای تأیید طرح.

چه چیزی مستند است

Hermes Agent با مجوز MIT منتشر شده و برای Linux، macOS، WSL2 و Windows نصب‌کننده دارد. مستندات هفت بک‌اند ترمینال را فهرست می‌کند: local، docker، ssh، singularity، modal، daytona و vercel_sandbox. بک‌اند با کلید terminal.backend انتخاب می‌شود و docker به نصب Docker (یا Podman با متغیر HERMES_DOCKER_BINARY) نیاز دارد.

برای مدل، صفحهٔ ارائه‌دهندگان نقطهٔ پایانی سفارشی با provider: custom و base_url را مستند کرده و نمونه‌هایی برای Ollama، vLLM، llama.cpp و LM Studio دارد.

  1. نصب با نصب‌کنندهٔ رسمی روی سرور آزمایشی
  2. انتخاب terminal.backend: ابتدا docker یا ssh روی میزبان ایزوله
  3. تنظیم model.provider به custom و base_url به سرور مدل داخلی
  4. ثبت نسخهٔ نصب‌شده (مثلاً v0.22.5 در تاریخ 2026-10-24) برای بازتولید

اتصال به مدل داخلی

طبق مستندات، Hermes برای کار عاملی حداقل ۶۴ هزار توکن زمینه را لازم دارد و پنجرهٔ کوچک‌تر در راه‌اندازی رد می‌شود. برای Ollama باید زمینه سمت سرور تنظیم شود (OLLAMA_CONTEXT_LENGTH یا num_ctx) و برای vLLM گزینه‌های فراخوانی ابزار در مثال رسمی آمده است؛ llama.cpp برای فراخوانی ابزار به --jinja نیاز دارد.

کیفیت فارسی، سرعت و پایداری فراخوانی ابزار با مدل محلی در مستندات ضمانت نشده و باید در آزمون خودتان سنجیده شود.

  1. انتخاب یک مدل با زمینهٔ ≥ ۶۴ هزار توکن
  2. راه‌اندازی سرور مدل و آزمون فراخوانی ابزار جداگانه پیش از اتصال به Hermes
  3. اجرای مجموعهٔ آزمون فارسی سازمان و ثبت نتایج

چک‌لیست امنیت (بر پایهٔ مدل امنیتی رسمی)

مستندات هشت لایه معرفی می‌کند: احراز هویت کاربر، تأیید فرمان خطرناک، ایمنی نوشتن فایل، ایزوله‌سازی کانتینر، فیلتر اعتبارنامه MCP، اسکن فایل‌های زمینه، جداسازی نشست‌ها و پاک‌سازی ورودی. حالت‌های approvals.mode شامل smart، manual و off است و در بک‌اندهای کانتینری این بررسی‌ها کنار گذاشته می‌شود چون کانتینر مرز اجراست. مستندات صراحتاً می‌گوید محافظت نوشتن فایل در برابر عامل متخاصم sandbox نیست.

توصیهٔ KSF (نه ادعای مستندات): حالت manual برای شروع، allowlist سخت‌گیرانه در دروازه، کانتینر بدون دسترسی شبکهٔ آزاد و بازبینی لاگ‌ها.

  1. approvals.mode را manual بگذارید و approvals.deny را برای فرمان‌های حساس بنویسید
  2. allowlist هر پلتفرم را صریح تنظیم کنید (بدون allowlist همه رد می‌شوند)
  3. docker_forward_env را خالی بگذارید مگر ضروری باشد
  4. سیاست پاک‌سازی حافظه و لاگ‌ها را تعریف کنید

آنچه باید جداگانه ارزیابی شود

در صفحات بررسی‌شده، این موارد تأیید نشد: API سرور، لاگ ممیزی جامع، کنترل دسترسی نقش‌محور سازمانی و SSO، اقامت داده برای ابزارهای اختیاری Nous Portal، و رفتار با اینترنت قطع. پس عبارت «استقرار داخلی کامل» فقط وقتی درست است که مدل، ابزارها و کانال‌ها همه داخلی باشند و ابزارهای اختیاری ابری غیرفعال بمانند.

  1. فهرست همهٔ اتصال‌های خروجی شبکه در یک آزمون بدون اینترنت
  2. تأیید غیرفعال‌بودن Tool Gateway ابری
  3. تصمیم دربارهٔ لاگ ممیزی بیرونی
  4. تعیین سیاست به‌روزرسانی (نسخه‌ها سریع تغییر می‌کنند)

نکات امنیتی

این راهنما ادعای امن‌بودن Hermes Agent ندارد. کنترل‌های نام‌برده‌شده مطابق مستندات رسمی‌اند؛ هر کنترل باید در محیط شما آزمون شود و برای عامل‌های دارای دسترسی نوشتن یا شبکه، تأیید انسانی و ایزوله‌سازی اضافه لازم است.

منابع رسمی

  1. Hermes Agent — مخزن رسمی Nous Research (پیوند خارجی)
  2. Hermes Agent — فایل LICENSE (پیوند خارجی)
  3. Hermes Agent — مستندات رسمی (پیوند خارجی)
  4. Hermes Agent — مدل امنیتی (پیوند خارجی)
  5. Hermes Agent — پیکربندی (پیوند خارجی)
  6. Hermes Agent — ارائه‌دهندگان مدل (پیوند خارجی)

درخواست مشاوره طراحی و پیاده‌سازی AI Agent

برای اجرای این راهنما در زیرساخت سازمان خود از کارشناسان کهن سیستم فردا کمک بگیرید.