diff --git a/docs/ar/agenteye/codex-capture.mdx b/docs/ar/agenteye/codex-capture.mdx index 7060160f..7a205c56 100644 --- a/docs/ar/agenteye/codex-capture.mdx +++ b/docs/ar/agenteye/codex-capture.mdx @@ -1,53 +1,55 @@ --- title: "التقاط جلسات Codex" -description: "تتبع جلسات OpenAI Codex المحلية لفريقك إلى AgentEye كجلسات وأحداث عادية — دون أي تغيير في طريقة تشغيلهم لـ Codex." +description: "قم بنقل جلسات فريقك المحلية في OpenAI Codex إلى AgentEye كجلسات وأحداث عادية — بدون أي تغيير في طريقة تشغيلهم لـ Codex." --- -مهندسوك يشغلون OpenAI Codex بالفعل كل يوم. التقاط جلسات Codex يجلب تلك جلسات البرمجة إلى AgentEye كجلسات وأحداث عادية، حتى تتمكن من البحث والتشغيل المتكرر وتقييمها جنباً إلى جنب مع كل شيء آخر تلاحظه. إنه يكمل [Python SDK](/ar/agenteye/python-sdk): يقوم الـ SDK بأداة تجهيز الوكلاء التي تكتبها، بينما يلتقط هذا عمل Codex الذي يقوم به فريقك بالفعل — دون أي تغيير في طريقة تشغيله. +مهندسوك يستخدمون OpenAI Codex بالفعل كل يوم. التقاط جلسات Codex يجلب تلك الجلسات البرمجية إلى AgentEye كجلسات وأحداث عادية، بحيث يمكنك البحث عنها وإعادة تشغيلها وتقييمها جنباً إلى جنب مع كل شيء آخر تراقبه. إنه يكمل [Python SDK](/ar/agenteye/python-sdk): الـ SDK يُجهز الوكلاء التي تكتبها، بينما هذا يلتقط عمل Codex الذي يقوم به فريقك بالفعل — بدون أي تغيير في كيفية تشغيله. -جامع خلفي صغير يقرأ نسخ جلسات Codex المحلية عند كتابتها وينقلها إلى AgentEye. جامع واحد لكل جهاز يلتقط كل سطح Codex محلي في وقت واحد — لا توجد عملية إعداد لكل سطح. +محصِّل خلفية صغير يقرأ نصوص جلسات Codex المحلية أثناء كتابتها ويرسلها إلى AgentEye. جهاز جمع واحد لكل جهاز يلتقط كل سطح محلي من Codex في نفس الوقت — لا توجد إعدادات منفصلة لكل سطح. + +نفس الجهاز يلتقط وكلاء آخرين أيضاً — انظر [OpenClaw](/ar/agenteye/openclaw-capture) و [Hermes](/ar/agenteye/hermes-capture). فعّل كل واحد تقوم بتشغيله؛ يمكن لجهاز جمع واحد التقاط عدة أجهزة في نفس الوقت. --- ## ما يتم التقاطه -كل سطح Codex يعمل **محلياً** ينتج نفس نسخ جلسات على القرص، والجامع يلتقط كل منها: +كل سطح Codex يعمل **محلياً** ينتج نفس نصوص جلسات على القرص، وجهاز الجمع يلتقطها جميعاً: -- Codex **CLI** و `codex exec` -- **VS Code / IDE extension** -- **تطبيق سطح المكتب**، عند تشغيله لجلسة محلياً +- **واجهة سطر أوامر** Codex و `codex exec` +- **ملحق VS Code / IDE** +- **تطبيق سطح المكتب**، عندما يقوم بتشغيل جلسة محلياً -تصبح كل جلسة Codex [جلسة](/ar/agenteye/sessions) في AgentEye؛ رسائل المستخدم والمساعد، التفكير، استدعاءات الأدوات، نتائج الأدوات، واستخدام الرموز تصبح [أحداث](/ar/agenteye/event-stream) المطابقة. يتم تسجيل السطح الذي جاءت منه كل جلسة (CLI أو IDE أو سطح المكتب)، حتى تتمكن من التمييز بينها. +تصبح كل جلسة Codex [جلسة](/ar/agenteye/sessions) في AgentEye؛ رسائل المستخدم والمساعد والمنطق واستدعاءات الأدوات ونتائج الأدوات واستخدام الرموز تصبح [أحداث](/ar/agenteye/event-stream) المطابقة. يتم تسجيل السطح الذي جاءت منه كل جلسة (واجهة سطر الأوامر أو IDE أو سطح المكتب)، بحيث يمكنك التمييز بينها. -> **لا يتم التقاط الجلسات السحابية.** يشغل تطبيق سطح المكتب بشكل متزايد الجلسات في سحابة Codex ويحتفظ فقط بالبيانات الوصفية الخاصة بها على الجهاز — لا توجد نسخة محلية للقراءة. يتم التقاط الجلسات المنفذة محلياً فقط. +> **جلسات السحابة لا يتم التقاطها.** يقوم تطبيق سطح المكتب بشكل متزايد بتشغيل الجلسات في سحابة Codex ويحتفظ فقط ببيانات تعريفها على الجهاز — لا يوجد نص محلي للقراءة. يتم التقاط الجلسات المُنفذة محلياً فقط. --- -## تفعيلها +## تشغيله -التقاط معطل حتى تقوم بتفعيله. ثبّت الجامع باستخدام مفتاح API له صلاحية `events:add` (انظر [مفاتيح API](/ar/agenteye/api-keys))، وشغّل التقاط Codex: +التقاط مُطفأ حتى تقوم بتفعيله. ثبّت جهاز الجمع باستخدام مفتاح API له إذن `events:add` (انظر [API keys](/ar/agenteye/api-keys))، وفعّل التقاط Codex: ```bash curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ | sh -s -- --key --codex-enabled ``` -هذا يثبت الجامع، ويسجله كخدمة خلفية، ويبدأ التقاط. تأكد من أنه يعمل: +يثبت هذا جهاز الجمع، ويسجله كخدمة خلفية، ويبدأ الالتقاط. تأكد من أنه يعمل: ```bash agenteye-collector health ``` -عند التشغيل الأول، يتم ملء جلسات Codex الموجودة مرة واحدة وتتدفق النشاط الجديد بعد ذلك في غضون ثوانٍ. ملفات Codex الخاصة بها يتم قراءتها فقط — لا تُعدَّل أو تُنقَل أو تُحذف — وتُرسل كل جلسة مرة واحدة بالضبط، حتى عبر إعادة التشغيل. +عند التشغيل الأول، يتم إعادة ملء جلساتك الموجودة في Codex مرة واحدة ثم يتدفق النشاط الجديد في غضون ثوان. ملفات Codex الخاصة به يتم قراءتها فقط — لا يتم تعديلها أو نقلها أو حذفها — وكل جلسة يتم شحنها مرة واحدة بالضبط، حتى عند إعادة التشغيل. --- ## حيث تظهر -تظهر الجلسات المُلتقطة في **Sessions**، وأحداثها في تدفق **Events**، مثل أي وكيل آخر تلاحظه — لذا فإن [جلسة التشغيل المتكرر](/ar/agenteye/sessions)، و[البحث](/ar/agenteye/queries)، و[التقييمات](/ar/agenteye/evaluations)، و[التنبيهات](/ar/agenteye/alerts) كلها تعمل عليها. قم بالتصفية حسب وكيل Codex لرؤيتها بمفردها. +تظهر الجلسات الملتقطة في **Sessions**، وأحداثها في تدفق **Events**، مثل أي وكيل آخر تراقبه — لذلك [إعادة تشغيل الجلسة](/ar/agenteye/sessions) و [البحث](/ar/agenteye/queries) و [التقييمات](/ar/agenteye/evaluations) و [التنبيهات](/ar/agenteye/alerts) تعمل جميعها عليها. قم بالتصفية حسب وكيل Codex لرؤيتها بمفردها. --- ## الخصوصية -نسخ Codex تحتوي على الجلسة الكاملة — بما في ذلك مخرجات الأوامر ومحتويات الملفات وأي شيء قرأه أو كتبه Codex — ويمكن أن تحتوي على أسرار. يتم شحن الجلسات المُلتقطة كما هي، لذا قم بتفعيل التقاط فقط على الأجهزة والفريق حيث يكون تركيز هذا المحتوى في AgentEye مناسباً، وأعطِ الجامع مفتاحاً محدد النطاق فقط لـ `events:add`. انظر [Security](/ar/agenteye/security) لمعرفة كيفية الحفاظ على عزلة بياناتك. \ No newline at end of file +نصوص Codex تحتوي على الجلسة الكاملة — بما في ذلك إخراج الأوامر ومحتويات الملفات وأي شيء قرأه Codex أو كتبه — وقد تحتوي على أسرار. يتم شحن الجلسات الملتقطة كما هي، لذا فعّل الالتقاط فقط على الأجهزة والفرق حيث يكون من المناسب مركزية هذا المحتوى في AgentEye، وأعط جهاز الجمع مفتاح مقتصر على `events:add` فقط. انظر [Security](/ar/agenteye/security) لمعرفة كيفية عزل بيانات الخاص بك. \ No newline at end of file diff --git a/docs/ar/agenteye/hermes-capture.mdx b/docs/ar/agenteye/hermes-capture.mdx new file mode 100644 index 00000000..b727d62d --- /dev/null +++ b/docs/ar/agenteye/hermes-capture.mdx @@ -0,0 +1,53 @@ +--- +title: "التقاط جلسات Hermes" +description: "أحضر جلسات بوابة Hermes لفريقك — Slack و Telegram و CLI والتشغيلات المجدولة — إلى AgentEye كجلسات وأحداث عادية." +--- + +[Hermes](https://hermes-agent.nousresearch.com) يجيب فريقك من أي مكان يعملون فيه بالفعل — Slack و Telegram و CLI والتشغيلات المجدولة. التقاط جلسات Hermes يأتي بكل ذلك إلى AgentEye كجلسات وأحداث عادية، بحيث يكون المساعد الذي يتحدث معه فريقك يومياً قابلاً للملاحظة مثل الوكلاء التي تكتبها بنفسك. + +جامع خلفية صغير يقرأ مخزن الجلسات المحلي لـ Hermes أثناء كتابته وينقل الجلسات إلى AgentEye. يعمل بنفس الطريقة التي يعمل بها [Codex](/ar/agenteye/codex-capture) و [OpenClaw](/ar/agenteye/openclaw-capture) للالتقاط، ويمكن لجامع واحد التقاط عدة منها في نفس الوقت. + +--- + +## ما يتم التقاطه + +يتم التقاط كل جلسة Hermes على الجهاز، مهما كانت القناة التي جاءت منها. كل واحدة تصبح [جلسة](/ar/agenteye/sessions) في AgentEye؛ رسائل المستخدم والمساعد وأداء الأدوات ونتائج الأدوات تصبح [الأحداث](/ar/agenteye/event-stream) المطابقة. + +يتم تسجيل القناة التي بدأت منها الجلسة — Slack أو Telegram أو CLI أو تشغيل مجدول — على الجلسة، بحيث يمكنك التمييز بينها والتصفية للواحدة تلو الأخرى. إلى جانبها يأتي النموذج الذي تشغلت عليه الجلسة والدردشة والشخص الذي بدأت منه، وعندما تولد الجلسة أخرى، الرابط مرة أخرى إلى أصلها. + +تظهر الجلسات حالما يبدأها Hermes، سواء قيل شيء أم لا، ورد الدور وأداة استدعاءاته تبقى بالترتيب الذي حدثت فيه بالفعل. عندما تنتهي الجلسة تحصل أيضاً على سبب انتهائها وما كلفها وكم رمزاً استخدمت. + +--- + +## تشغيله + +الالتقاط معطل حتى تمكنه. ثبت الجامع مع مفتاح API لديه إذن `events:add` (انظر [مفاتيح API](/ar/agenteye/api-keys))، وقم بتشغيل التقاط Hermes: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --hermes-enabled +``` + +هذا يثبت الجامع ويسجله كخدمة خلفية ويبدأ الالتقاط. تأكد من أنه يعمل: + +```bash +agenteye-collector health +``` + +التقاط أكثر من وكيل واحد على نفس الجهاز؟ أضف علم كل واحد للأمر نفسه — على سبيل المثال `--hermes-enabled --codex-enabled`. + +في التشغيل الأول، يتم ملء جلسات Hermes الحالية مرة واحدة والنشاط الجديد يتدفق بعد ثوان. بيانات Hermes نفسها تُقرأ فقط — لا تُعدّل أو تُحذف — وكل رسالة تُنقل مرة واحدة، حتى عبر إعادات التشغيل. + +`health` يخبرك أيضاً ما إذا كان كل شيء التقطه الجامع وصل بالفعل إلى AgentEye. إذا لم يتم تسليم دفعة يتم الاحتفاظ بها وإعادة المحاولة بدلاً من التخلص منها، والفحص يعيد صحة غير سليمة بينما أي شيء لا يزال معلقاً — لذا "صحي" يعني وصول بياناتك، وليس مجرد أن العملية حية. + +--- + +## حيث يظهر + +تظهر الجلسات المتقاطة في **الجلسات**، وأحداثها في تدفق **الأحداث**، مثل أي وكيل آخر تراقبه — لذا [إعادة تشغيل الجلسة](/ar/agenteye/sessions) و [البحث](/ar/agenteye/queries) و [التقييمات](/ar/agenteye/evaluations) و [التنبيهات](/ar/agenteye/alerts) جميعها تعمل عليها. صفّ حسب وكيل Hermes لرؤيتها بمفردها. + +--- + +## الخصوصية + +جلسات Hermes تحتوي على النص الكامل — بما في ذلك إخراج الأوامر ومحتويات الملفات وأي شيء قرأه الوكيل أو كتبه — ويمكن أن تحتوي على أسرار. يتم نقل الجلسات المتقاطة كما هي، لذا فعّل الالتقاط فقط حيث يكون تركيز هذا المحتوى في AgentEye مناسباً، وأعط الجامع مفتاحاً مقتصراً على `events:add` فقط. انظر [الأمان](/ar/agenteye/security) لكيفية الحفاظ على بياناتك معزولة. \ No newline at end of file diff --git a/docs/ar/agenteye/openclaw-capture.mdx b/docs/ar/agenteye/openclaw-capture.mdx new file mode 100644 index 00000000..5641763c --- /dev/null +++ b/docs/ar/agenteye/openclaw-capture.mdx @@ -0,0 +1,50 @@ +--- +--- +title: "التقاط جلسات OpenClaw" +description: "قم بتتبع جلسات OpenClaw المحلية لفريقك إلى AgentEye كجلسات وأحداث عادية — دون أي تغيير في طريقة تشغيل OpenClaw." +--- + +إذا كان فريقك يستخدم [OpenClaw](https://docs.openclaw.ai)، فإن التقاط جلسات OpenClaw يجلب تلك الجلسات إلى AgentEye كجلسات وأحداث عادية، بحيث يمكنك البحث عنها وإعادة تشغيلها وتقييمها جنباً إلى جنب مع كل شيء آخر تراقبه. يكمل [Python SDK](/ar/agenteye/python-sdk): يقوم SDK بأداة الوكلاء التي تكتبها، بينما يلتقط هذا عمل OpenClaw الذي يقوم به فريقك بالفعل — دون أي تغيير في طريقة تشغيله. + +يقرأ جامع خلفي صغير نصوص جلسات OpenClaw المحلية عند كتابتها وينقلها إلى AgentEye. يعمل بنفس الطريقة التي يعمل بها [التقاط Codex](/ar/agenteye/codex-capture)، ويمكن لجامع واحد التقاط كليهما في نفس الوقت. + +--- + +## ما يتم التقاطه + +يتم التقاط كل وكيل مكوّن في إعداد OpenClaw على جهاز بواسطة جامع ذلك الجهاز — لا توجد إعدادات لكل وكيل. + +تصبح كل جلسة OpenClaw [جلسة](/ar/agenteye/sessions) في AgentEye؛ تصبح رسائل المستخدم والمساعد وطلبات الأدوات ونتائجها [أحداث](/ar/agenteye/event-stream) مطابقة. + +--- + +## تشغيله + +التقاط الإجراءات مغلق حتى تقوم بتفعيله. قم بتثبيت الجامع باستخدام مفتاح API له صلاحية `events:add` (انظر [مفاتيح API](/ar/agenteye/api-keys))، وقم بتشغيل التقاط OpenClaw: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --openclaw-enabled +``` + +هذا يثبت الجامع ويسجله كخدمة خلفية ويبدأ الالتقاط. تأكد من أنه يعمل: + +```bash +agenteye-collector health +``` + +هل تلتقط أكثر من وكيل على نفس الجهاز؟ أضف علم كل واحد منهم إلى نفس الأمر — على سبيل المثال `--openclaw-enabled --codex-enabled`. + +في التشغيل الأول، يتم ملء جلسات OpenClaw الموجودة لديك مرة واحدة والنشاط الجديد يتدفق بعد ثوانٍ. لا يتم قراءة ملفات OpenClaw الخاصة بها أبداً — لا تُعدَّل أو تُنقل أو تُحذف — ويتم نقل كل جلسة مرة واحدة بالضبط، حتى عبر عمليات إعادة التشغيل. + +--- + +## حيث يظهر + +تظهر الجلسات الملتقطة في **الجلسات**، وأحداثها في دفق **الأحداث**، مثل أي وكيل آخر تراقبه — لذلك [إعادة تشغيل الجلسة](/ar/agenteye/sessions) و[البحث](/ar/agenteye/queries) و[التقييمات](/ar/agenteye/evaluations) و[التنبيهات](/ar/agenteye/alerts) تعمل جميعها عليها. قم بالتصفية حسب وكيل OpenClaw لرؤيتها بمفردها. + +--- + +## الخصوصية + +تحتوي نصوص OpenClaw على الجلسة الكاملة — بما في ذلك مخرجات الأوامر ومحتويات الملفات وأي شيء قرأه الوكيل أو كتبه — وقد تحتوي على أسرار. يتم نقل الجلسات الملتقطة كما هي، لذا قم بتفعيل الالتقاط فقط على الأجهزة والفرق التي يكون فيها مركزية هذا المحتوى في AgentEye مناسباً، وأعط الجامع مفتاح محدد النطاق إلى `events:add` فقط. راجع [الأمان](/ar/agenteye/security) لمعرفة كيفية الحفاظ على عزل بيانات. \ No newline at end of file diff --git a/docs/de/agenteye/codex-capture.mdx b/docs/de/agenteye/codex-capture.mdx index e90b714b..a730945c 100644 --- a/docs/de/agenteye/codex-capture.mdx +++ b/docs/de/agenteye/codex-capture.mdx @@ -1,53 +1,55 @@ --- title: "Codex-Sitzungsaufzeichnung" -description: "Leitet die lokalen OpenAI-Codex-Sitzungen Ihres Teams als gewöhnliche Sitzungen und Ereignisse in AgentEye ein – ohne jede Änderung daran, wie sie Codex ausführen." +description: "Leiten Sie die lokalen OpenAI-Codex-Sitzungen Ihres Teams als gewöhnliche Sitzungen und Ereignisse in AgentEye ein — ohne Änderungen an der Art und Weise, wie sie Codex ausführen." --- -Ihre Entwickler führen OpenAI Codex bereits täglich aus. Die Codex-Sitzungsaufzeichnung überträgt diese Codiersitzungen als gewöhnliche Sitzungen und Ereignisse in AgentEye, sodass Sie sie gemeinsam mit allem anderen, was Sie beobachten, durchsuchen, wiedergeben und auswerten können. Sie ergänzt das [Python SDK](/de/agenteye/python-sdk): Das SDK instrumentiert Agents, die Sie selbst schreiben, während diese Funktion die Codex-Arbeit Ihres Teams erfasst – ohne jede Änderung an deren Arbeitsweise. +Ihre Entwickler verwenden OpenAI Codex bereits täglich. Die Codex-Sitzungsaufzeichnung bringt diese Programmiersitzungen als gewöhnliche Sitzungen und Ereignisse in AgentEye, sodass Sie sie zusammen mit allem anderen, was Sie beobachten, durchsuchen, wiedergeben und auswerten können. Sie ergänzt das [Python SDK](/de/agenteye/python-sdk): Das SDK instrumentiert von Ihnen geschriebene Agenten, während diese Funktion die Codex-Arbeit Ihres Teams aufzeichnet — ohne Änderungen an der Arbeitsweise. -Ein kleiner Hintergrundsammler liest Codex' lokale Sitzungstranskripte, während sie geschrieben werden, und überträgt sie an AgentEye. Ein Sammler pro Maschine erfasst gleichzeitig alle lokalen Codex-Oberflächen – es ist keine separate Einrichtung pro Oberfläche erforderlich. +Ein kleiner Hintergrundkollektor liest Codex's lokale Sitzungstranskripte, während sie geschrieben werden, und sendet sie an AgentEye. Ein Kollektor pro Maschine erfasst alle lokalen Codex-Oberflächen auf einmal — es ist keine oberflächen-spezifische Einrichtung erforderlich. + +Derselbe Kollektor erfasst auch andere Agenten — siehe [OpenClaw](/de/agenteye/openclaw-capture) und [Hermes](/de/agenteye/hermes-capture). Aktivieren Sie jeweils die Agenten, die Sie verwenden; ein einzelner Kollektor kann mehrere gleichzeitig erfassen. --- ## Was aufgezeichnet wird -Jede Codex-Oberfläche, die **lokal** ausgeführt wird, erzeugt dieselben Sitzungstranskripte auf der Festplatte, und der Sammler verarbeitet sie alle: +Jede Codex-Oberfläche, die **lokal** ausgeführt wird, erzeugt dieselben lokalen Sitzungstranskripte auf dem Datenträger, die der Kollektor alle aufzeichnet: -- die Codex-**CLI** und `codex exec` +- das Codex **CLI** und `codex exec` - die **VS Code / IDE-Erweiterung** - die **Desktop-App**, wenn sie eine Sitzung lokal ausführt -Jede Codex-Sitzung wird zu einer AgentEye-[Sitzung](/de/agenteye/sessions); ihre Benutzer- und Assistentennachrichten, Überlegungen, Tool-Aufrufe, Tool-Ergebnisse und Token-Nutzung werden zu den entsprechenden [Ereignissen](/de/agenteye/event-stream). Die Oberfläche, von der jede Sitzung stammt (CLI, IDE oder Desktop), wird aufgezeichnet, damit Sie sie unterscheiden können. +Jede Codex-Sitzung wird zu einer AgentEye-[Sitzung](/de/agenteye/sessions); ihre Benutzer- und Assistentennachrichten, Überlegungen, Werkzeugaufrufe, Werkzeugergebnisse und Token-Nutzung werden zu den entsprechenden [Ereignissen](/de/agenteye/event-stream). Die Oberfläche, aus der jede Sitzung stammt (CLI, IDE oder Desktop), wird aufgezeichnet, sodass Sie sie unterscheiden können. -> **Cloud-Sitzungen werden nicht aufgezeichnet.** Die Desktop-App führt Sitzungen zunehmend in der Codex-Cloud aus und speichert auf dem Gerät nur deren Metadaten – es gibt kein lokales Transkript zum Lesen. Nur lokal ausgeführte Sitzungen werden aufgezeichnet. +> **Cloud-Sitzungen werden nicht aufgezeichnet.** Die Desktop-App führt Sitzungen zunehmend in der Codex-Cloud aus und speichert nur deren Metadaten auf dem Gerät — es gibt kein lokales Transkript zum Lesen. Nur lokal ausgeführte Sitzungen werden aufgezeichnet. --- ## Aktivierung -Die Aufzeichnung ist deaktiviert, bis Sie sie einschalten. Installieren Sie den Sammler mit einem API-Schlüssel, der die Berechtigung `events:add` besitzt (siehe [API-Schlüssel](/de/agenteye/api-keys)), und aktivieren Sie die Codex-Aufzeichnung: +Die Aufzeichnung ist deaktiviert, bis Sie sie aktivieren. Installieren Sie den Kollektor mit einem API-Schlüssel, der die Berechtigung `events:add` besitzt (siehe [API-Schlüssel](/de/agenteye/api-keys)), und aktivieren Sie die Codex-Aufzeichnung: ```bash curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ | sh -s -- --key --codex-enabled ``` -Dadurch wird der Sammler installiert, als Hintergrunddienst registriert und die Aufzeichnung gestartet. Überprüfen Sie, ob er läuft: +Dadurch wird der Kollektor installiert, als Hintergrunddienst registriert und die Aufzeichnung gestartet. Überprüfen Sie, ob er läuft: ```bash agenteye-collector health ``` -Beim ersten Start werden Ihre vorhandenen Codex-Sitzungen einmalig nachgefüllt, danach wird neue Aktivität innerhalb von Sekunden gestreamt. Codex' eigene Dateien werden ausschließlich gelesen – niemals verändert, verschoben oder gelöscht – und jede Sitzung wird genau einmal übertragen, auch über Neustarts hinweg. +Beim ersten Start werden Ihre vorhandenen Codex-Sitzungen einmalig nachgefüllt, und neue Aktivitäten werden anschließend innerhalb von Sekunden übertragen. Die Dateien von Codex werden ausschließlich gelesen — niemals geändert, verschoben oder gelöscht — und jede Sitzung wird genau einmal übertragen, auch nach Neustarts. --- ## Wo die Daten erscheinen -Aufgezeichnete Sitzungen erscheinen unter **Sitzungen** und ihre Ereignisse im **Ereignis**-Stream, genauso wie jeder andere beobachtete Agent – daher funktionieren [Sitzungswiedergabe](/de/agenteye/sessions), [Suche](/de/agenteye/queries), [Auswertungen](/de/agenteye/evaluations) und [Benachrichtigungen](/de/agenteye/alerts) für sie genauso. Filtern Sie nach dem Codex-Agent, um sie einzeln anzuzeigen. +Aufgezeichnete Sitzungen erscheinen unter **Sitzungen** und ihre Ereignisse im **Ereignis**-Stream, genauso wie bei jedem anderen beobachteten Agenten — sodass [Sitzungswiedergabe](/de/agenteye/sessions), [Suche](/de/agenteye/queries), [Auswertungen](/de/agenteye/evaluations) und [Warnmeldungen](/de/agenteye/alerts) alle auf ihnen funktionieren. Filtern Sie nach dem Codex-Agenten, um nur diese anzuzeigen. --- ## Datenschutz -Codex-Transkripte enthalten die vollständige Sitzung – einschließlich Befehlsausgaben, Dateiinhalten und allem, was Codex gelesen oder geschrieben hat – und können Geheimnisse enthalten. Aufgezeichnete Sitzungen werden unverändert übertragen. Aktivieren Sie die Aufzeichnung daher nur auf Maschinen und für Teams, bei denen die Zentralisierung dieser Inhalte in AgentEye angemessen ist, und versehen Sie den Sammler mit einem Schlüssel, der ausschließlich auf `events:add` beschränkt ist. Unter [Sicherheit](/de/agenteye/security) erfahren Sie, wie Ihre Daten isoliert aufbewahrt werden. \ No newline at end of file +Codex-Transkripte enthalten die vollständige Sitzung — einschließlich Befehlsausgaben, Dateiinhalte und alles, was Codex gelesen oder geschrieben hat — und können vertrauliche Daten enthalten. Aufgezeichnete Sitzungen werden unverändert übertragen. Aktivieren Sie die Aufzeichnung daher nur auf Geräten und für Teams, bei denen die Zentralisierung dieser Inhalte in AgentEye angemessen ist, und weisen Sie dem Kollektor einen Schlüssel zu, der ausschließlich auf `events:add` beschränkt ist. Weitere Informationen zur Isolation Ihrer Daten finden Sie unter [Sicherheit](/de/agenteye/security). \ No newline at end of file diff --git a/docs/de/agenteye/hermes-capture.mdx b/docs/de/agenteye/hermes-capture.mdx new file mode 100644 index 00000000..ebf07749 --- /dev/null +++ b/docs/de/agenteye/hermes-capture.mdx @@ -0,0 +1,53 @@ +--- +title: "Hermes-Sitzungserfassung" +description: "Führen Sie die Hermes-Gateway-Sitzungen Ihres Teams – Slack, Telegram, CLI und geplante Ausführungen – als normale Sitzungen und Ereignisse in AgentEye zusammen." +--- + +[Hermes](https://hermes-agent.nousresearch.com) beantwortet Anfragen Ihres Teams dort, wo es ohnehin arbeitet – in Slack, Telegram, der CLI oder per geplanter Ausführung. Die Hermes-Sitzungserfassung bringt all das als normale Sitzungen und Ereignisse in AgentEye, sodass der Assistent, mit dem Ihr Team täglich arbeitet, genauso beobachtbar ist wie die Agents, die Sie selbst schreiben. + +Ein kleiner Hintergrundsammler liest Hermes' lokalen Sitzungsspeicher, während er beschrieben wird, und überträgt die Sitzungen an AgentEye. Er funktioniert genauso wie die Erfassung für [Codex](/de/agenteye/codex-capture) und [OpenClaw](/de/agenteye/openclaw-capture), und ein einziger Collector kann mehrere davon gleichzeitig erfassen. + +--- + +## Was erfasst wird + +Alle Hermes-Sitzungen auf dem Rechner werden erfasst, unabhängig davon, über welchen Kanal sie entstanden sind. Jede wird zu einer AgentEye-[Sitzung](/de/agenteye/sessions); ihre Benutzer- und Assistentennachrichten, Tool-Aufrufe und Tool-Ergebnisse werden zu den entsprechenden [Ereignissen](/de/agenteye/event-stream). + +Der Kanal, über den eine Sitzung gestartet wurde – Slack, Telegram, CLI oder eine geplante Ausführung – wird in der Sitzung vermerkt, sodass Sie sie unterscheiden und nach jeweils einem filtern können. Dazu kommen das Modell, auf dem die Sitzung lief, der Chat und die Person, von der sie gestartet wurde, sowie – wenn eine Sitzung eine weitere erzeugt hat – die Verknüpfung zur übergeordneten Sitzung. + +Sitzungen erscheinen, sobald Hermes sie startet, unabhängig davon, ob bereits etwas gesagt wurde. Die Antwort eines Gesprächszugs und seine Tool-Aufrufe bleiben in der tatsächlichen Reihenfolge. Wenn eine Sitzung endet, erfahren Sie auch, warum sie endete, was sie gekostet hat und wie viele Token sie verbrauchte. + +--- + +## Aktivierung + +Die Erfassung ist standardmäßig deaktiviert. Installieren Sie den Collector mit einem API-Schlüssel, der die Berechtigung `events:add` besitzt (siehe [API-Schlüssel](/de/agenteye/api-keys)), und aktivieren Sie die Hermes-Erfassung: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --hermes-enabled +``` + +Dadurch wird der Collector installiert, als Hintergrunddienst registriert und die Erfassung gestartet. Prüfen Sie, ob er läuft: + +```bash +agenteye-collector health +``` + +Erfassen Sie mehrere Agents auf demselben Rechner? Fügen Sie die Flags aller gewünschten Agents in einem einzigen Befehl zusammen – zum Beispiel `--hermes-enabled --codex-enabled`. + +Beim ersten Start werden Ihre vorhandenen Hermes-Sitzungen einmalig nachgeladen, danach werden neue Aktivitäten innerhalb von Sekunden übertragen. Hermes' eigene Daten werden ausschließlich gelesen – nie verändert oder gelöscht – und jede Nachricht wird genau einmal übertragen, auch nach Neustarts. + +`health` zeigt Ihnen außerdem, ob alles, was der Collector erfasst hat, tatsächlich bei AgentEye angekommen ist. Wenn ein Stapel nicht zugestellt werden konnte, wird er aufbewahrt und erneut versucht, anstatt verworfen zu werden. Der Check meldet „unhealthy", solange noch etwas aussteht – „healthy" bedeutet also, dass Ihre Daten angekommen sind, nicht nur, dass der Prozess läuft. + +--- + +## Wo es erscheint + +Erfasste Sitzungen erscheinen unter **Sessions** und ihre Ereignisse im **Events**-Stream – genauso wie bei jedem anderen beobachteten Agent. Damit stehen [Sitzungswiederholung](/de/agenteye/sessions), [Suche](/de/agenteye/queries), [Auswertungen](/de/agenteye/evaluations) und [Benachrichtigungen](/de/agenteye/alerts) für sie zur Verfügung. Filtern Sie nach dem Hermes-Agent, um nur diese anzuzeigen. + +--- + +## Datenschutz + +Hermes-Sitzungen enthalten das vollständige Protokoll – einschließlich Befehlsausgaben, Dateiinhalten und allem, was der Agent gelesen oder geschrieben hat – und können Geheimnisse enthalten. Erfasste Sitzungen werden unverändert übertragen. Aktivieren Sie die Erfassung daher nur dort, wo es sinnvoll ist, diese Inhalte in AgentEye zu zentralisieren, und versehen Sie den Collector-Schlüssel ausschließlich mit der Berechtigung `events:add`. Unter [Sicherheit](/de/agenteye/security) erfahren Sie, wie Ihre Daten isoliert aufbewahrt werden. \ No newline at end of file diff --git a/docs/de/agenteye/openclaw-capture.mdx b/docs/de/agenteye/openclaw-capture.mdx new file mode 100644 index 00000000..2f783760 --- /dev/null +++ b/docs/de/agenteye/openclaw-capture.mdx @@ -0,0 +1,49 @@ +--- +title: "OpenClaw-Sitzungsaufzeichnung" +description: "Leiten Sie die lokalen OpenClaw-Sitzungen Ihres Teams als normale Sitzungen und Ereignisse in AgentEye ein – ohne Änderungen daran, wie OpenClaw ausgeführt wird." +--- + +Wenn Ihr Team [OpenClaw](https://docs.openclaw.ai) verwendet, bringt die OpenClaw-Sitzungsaufzeichnung diese Sitzungen als normale Sitzungen und Ereignisse in AgentEye, sodass Sie sie zusammen mit allem anderen, was Sie beobachten, durchsuchen, wiedergeben und auswerten können. Sie ergänzt das [Python SDK](/de/agenteye/python-sdk): Das SDK instrumentiert Agenten, die Sie selbst schreiben, während diese Funktion die OpenClaw-Arbeit aufzeichnet, die Ihr Team bereits erledigt – ohne Änderungen an der Ausführung. + +Ein kleiner Hintergrund-Collector liest OpenClaw's lokale Sitzungstranskripte, während sie geschrieben werden, und übermittelt sie an AgentEye. Er funktioniert genauso wie die [Codex-Aufzeichnung](/de/agenteye/codex-capture), und ein Collector kann beide gleichzeitig erfassen. + +--- + +## Was aufgezeichnet wird + +Jeder Agent, der im OpenClaw-Setup eines Computers konfiguriert ist, wird vom Collector dieses Computers erfasst – es ist keine agentenbezogene Einrichtung erforderlich. + +Jede OpenClaw-Sitzung wird zu einer AgentEye-[Sitzung](/de/agenteye/sessions); ihre Benutzer- und Assistentennachrichten, Tool-Aufrufe und Tool-Ergebnisse werden zu den entsprechenden [Ereignissen](/de/agenteye/event-stream). + +--- + +## Aktivierung + +Die Aufzeichnung ist deaktiviert, bis Sie sie aktivieren. Installieren Sie den Collector mit einem API-Schlüssel, der die Berechtigung `events:add` hat (siehe [API-Schlüssel](/de/agenteye/api-keys)), und aktivieren Sie die OpenClaw-Aufzeichnung: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --openclaw-enabled +``` + +Dadurch wird der Collector installiert, als Hintergrunddienst registriert und die Aufzeichnung gestartet. Bestätigen Sie, dass er läuft: + +```bash +agenteye-collector health +``` + +Mehr als einen Agenten auf demselben Computer aufzeichnen? Fügen Sie das Flag jedes Agenten zum selben Befehl hinzu – zum Beispiel `--openclaw-enabled --codex-enabled`. + +Beim ersten Start werden Ihre vorhandenen OpenClaw-Sitzungen einmalig nachgefüllt, und neue Aktivitäten werden danach innerhalb von Sekunden übertragen. OpenClaw's eigene Dateien werden dabei ausschließlich gelesen – niemals geändert, verschoben oder gelöscht – und jede Sitzung wird genau einmal übermittelt, auch nach Neustarts. + +--- + +## Wo die Aufzeichnungen erscheinen + +Aufgezeichnete Sitzungen erscheinen unter **Sessions** und ihre Ereignisse im **Events**-Stream, genauso wie bei jedem anderen beobachteten Agenten – sodass [Sitzungswiedergabe](/de/agenteye/sessions), [Suche](/de/agenteye/queries), [Auswertungen](/de/agenteye/evaluations) und [Benachrichtigungen](/de/agenteye/alerts) darauf angewendet werden können. Filtern Sie nach dem OpenClaw-Agenten, um nur dessen Sitzungen anzuzeigen. + +--- + +## Datenschutz + +OpenClaw-Transkripte enthalten die vollständige Sitzung – einschließlich Befehlsausgaben, Dateiinhalten und allem, was der Agent gelesen oder geschrieben hat – und können vertrauliche Informationen enthalten. Aufgezeichnete Sitzungen werden unverändert übermittelt. Aktivieren Sie die Aufzeichnung daher nur auf Computern und für Teams, bei denen die Zentralisierung dieser Inhalte in AgentEye angemessen ist, und statten Sie den Collector nur mit einem auf `events:add` beschränkten Schlüssel aus. Informationen zur Datenisolierung finden Sie unter [Sicherheit](/de/agenteye/security). \ No newline at end of file diff --git a/docs/docs.json b/docs/docs.json index 5e2d62f1..76eb1a3e 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -177,6 +177,8 @@ "zh/agenteye/python-sdk", "zh/agenteye/python-sdk-skill", "zh/agenteye/codex-capture", + "zh/agenteye/openclaw-capture", + "zh/agenteye/hermes-capture", "zh/agenteye/cli", "zh/agenteye/cli-skill", "zh/agenteye/cli-recipes", @@ -287,6 +289,8 @@ "ja/agenteye/python-sdk", "ja/agenteye/python-sdk-skill", "ja/agenteye/codex-capture", + "ja/agenteye/openclaw-capture", + "ja/agenteye/hermes-capture", "ja/agenteye/cli", "ja/agenteye/cli-skill", "ja/agenteye/cli-recipes", @@ -397,6 +401,8 @@ "ko/agenteye/python-sdk", "ko/agenteye/python-sdk-skill", "ko/agenteye/codex-capture", + "ko/agenteye/openclaw-capture", + "ko/agenteye/hermes-capture", "ko/agenteye/cli", "ko/agenteye/cli-skill", "ko/agenteye/cli-recipes", @@ -507,6 +513,8 @@ "es/agenteye/python-sdk", "es/agenteye/python-sdk-skill", "es/agenteye/codex-capture", + "es/agenteye/openclaw-capture", + "es/agenteye/hermes-capture", "es/agenteye/cli", "es/agenteye/cli-skill", "es/agenteye/cli-recipes", @@ -617,6 +625,8 @@ "pt-br/agenteye/python-sdk", "pt-br/agenteye/python-sdk-skill", "pt-br/agenteye/codex-capture", + "pt-br/agenteye/openclaw-capture", + "pt-br/agenteye/hermes-capture", "pt-br/agenteye/cli", "pt-br/agenteye/cli-skill", "pt-br/agenteye/cli-recipes", @@ -727,6 +737,8 @@ "de/agenteye/python-sdk", "de/agenteye/python-sdk-skill", "de/agenteye/codex-capture", + "de/agenteye/openclaw-capture", + "de/agenteye/hermes-capture", "de/agenteye/cli", "de/agenteye/cli-skill", "de/agenteye/cli-recipes", @@ -837,6 +849,8 @@ "fr/agenteye/python-sdk", "fr/agenteye/python-sdk-skill", "fr/agenteye/codex-capture", + "fr/agenteye/openclaw-capture", + "fr/agenteye/hermes-capture", "fr/agenteye/cli", "fr/agenteye/cli-skill", "fr/agenteye/cli-recipes", @@ -947,6 +961,8 @@ "ru/agenteye/python-sdk", "ru/agenteye/python-sdk-skill", "ru/agenteye/codex-capture", + "ru/agenteye/openclaw-capture", + "ru/agenteye/hermes-capture", "ru/agenteye/cli", "ru/agenteye/cli-skill", "ru/agenteye/cli-recipes", @@ -1057,6 +1073,8 @@ "hi/agenteye/python-sdk", "hi/agenteye/python-sdk-skill", "hi/agenteye/codex-capture", + "hi/agenteye/openclaw-capture", + "hi/agenteye/hermes-capture", "hi/agenteye/cli", "hi/agenteye/cli-skill", "hi/agenteye/cli-recipes", @@ -1167,6 +1185,8 @@ "tr/agenteye/python-sdk", "tr/agenteye/python-sdk-skill", "tr/agenteye/codex-capture", + "tr/agenteye/openclaw-capture", + "tr/agenteye/hermes-capture", "tr/agenteye/cli", "tr/agenteye/cli-skill", "tr/agenteye/cli-recipes", @@ -1277,6 +1297,8 @@ "vi/agenteye/python-sdk", "vi/agenteye/python-sdk-skill", "vi/agenteye/codex-capture", + "vi/agenteye/openclaw-capture", + "vi/agenteye/hermes-capture", "vi/agenteye/cli", "vi/agenteye/cli-skill", "vi/agenteye/cli-recipes", @@ -1387,6 +1409,8 @@ "it/agenteye/python-sdk", "it/agenteye/python-sdk-skill", "it/agenteye/codex-capture", + "it/agenteye/openclaw-capture", + "it/agenteye/hermes-capture", "it/agenteye/cli", "it/agenteye/cli-skill", "it/agenteye/cli-recipes", @@ -1497,6 +1521,8 @@ "ar/agenteye/python-sdk", "ar/agenteye/python-sdk-skill", "ar/agenteye/codex-capture", + "ar/agenteye/openclaw-capture", + "ar/agenteye/hermes-capture", "ar/agenteye/cli", "ar/agenteye/cli-skill", "ar/agenteye/cli-recipes", @@ -1607,6 +1633,8 @@ "he/agenteye/python-sdk", "he/agenteye/python-sdk-skill", "he/agenteye/codex-capture", + "he/agenteye/openclaw-capture", + "he/agenteye/hermes-capture", "he/agenteye/cli", "he/agenteye/cli-skill", "he/agenteye/cli-recipes", diff --git a/docs/es/agenteye/codex-capture.mdx b/docs/es/agenteye/codex-capture.mdx index 8d305516..538c909d 100644 --- a/docs/es/agenteye/codex-capture.mdx +++ b/docs/es/agenteye/codex-capture.mdx @@ -1,53 +1,55 @@ --- title: "Captura de sesiones de Codex" -description: "Transmite las sesiones locales de OpenAI Codex de tu equipo a AgentEye como sesiones y eventos ordinarios, sin cambiar en absoluto su forma de usar Codex." +description: "Envía las sesiones locales de OpenAI Codex de tu equipo a AgentEye como sesiones y eventos ordinarios, sin modificar la forma en que las ejecutan." --- -Tus ingenieros ya ejecutan OpenAI Codex a diario. La captura de sesiones de Codex incorpora esas sesiones de programación a AgentEye como sesiones y eventos ordinarios, para que puedas buscarlas, reproducirlas y evaluarlas junto a todo lo demás que observas. Complementa al [SDK de Python](/es/agenteye/python-sdk): el SDK instrumenta los agentes que tú escribes, mientras que esto captura el trabajo de Codex que tu equipo ya realiza, sin cambiar en absoluto su forma de ejecutarlo. +Tus ingenieros ya usan OpenAI Codex a diario. La captura de sesiones de Codex lleva esas sesiones de programación a AgentEye como sesiones y eventos ordinarios, para que puedas buscarlas, reproducirlas y evaluarlas junto a todo lo demás que observas. Complementa el [SDK de Python](/es/agenteye/python-sdk): el SDK instrumenta los agentes que tú escribes, mientras que esto captura el trabajo de Codex que tu equipo ya realiza, sin cambiar en absoluto cómo lo ejecutan. -Un pequeño recolector en segundo plano lee los transcriptos de sesión locales de Codex a medida que se escriben y los envía a AgentEye. Un recolector por máquina captura todas las interfaces locales de Codex a la vez — no se necesita configuración por interfaz. +Un pequeño recolector en segundo plano lee los registros de sesión locales de Codex a medida que se escriben y los envía a AgentEye. Un solo recolector por máquina captura todas las superficies locales de Codex a la vez; no hace falta configurar nada por superficie. + +El mismo recolector también captura otros agentes: consulta [OpenClaw](/es/agenteye/openclaw-capture) y [Hermes](/es/agenteye/hermes-capture). Activa cada uno que uses; un único recolector puede capturar varios a la vez. --- ## Qué captura -Cada interfaz de Codex que se ejecuta **localmente** produce los mismos transcriptos de sesión en disco, y el recolector los recoge todos: +Todas las superficies de Codex que se ejecutan **localmente** producen los mismos registros de sesión en disco, y el recolector los recoge todos: - la **CLI** de Codex y `codex exec` - la **extensión para VS Code / IDE** -- la **aplicación de escritorio**, cuando ejecuta una sesión de forma local +- la **aplicación de escritorio**, cuando ejecuta una sesión localmente -Cada sesión de Codex se convierte en una [sesión](/es/agenteye/sessions) de AgentEye; sus mensajes de usuario y asistente, razonamiento, llamadas a herramientas, resultados de herramientas y uso de tokens se convierten en los [eventos](/es/agenteye/event-stream) correspondientes. La interfaz de origen de cada sesión (CLI, IDE o escritorio) queda registrada para que puedas distinguirlas. +Cada sesión de Codex se convierte en una [sesión](/es/agenteye/sessions) de AgentEye; sus mensajes de usuario y asistente, razonamiento, llamadas a herramientas, resultados de herramientas y uso de tokens se convierten en los [eventos](/es/agenteye/event-stream) correspondientes. La superficie desde la que se originó cada sesión (CLI, IDE o escritorio) queda registrada, para que puedas distinguirlas. -> **Las sesiones en la nube no se capturan.** La aplicación de escritorio ejecuta cada vez más sesiones en la nube de Codex y solo conserva sus metadatos en la máquina — no hay ningún transcripto local que leer. Solo se capturan las sesiones ejecutadas localmente. +> **Las sesiones en la nube no se capturan.** La aplicación de escritorio ejecuta cada vez más sesiones en la nube de Codex y solo conserva sus metadatos en la máquina; no hay ningún registro local que leer. Solo se capturan las sesiones ejecutadas localmente. --- ## Cómo activarlo -La captura está desactivada hasta que la habilites. Instala el recolector con una clave de API que tenga el permiso `events:add` (consulta [Claves de API](/es/agenteye/api-keys)) y activa la captura de Codex: +La captura está desactivada hasta que la habilitas. Instala el recolector con una clave de API que tenga el permiso `events:add` (consulta [Claves de API](/es/agenteye/api-keys)) y activa la captura de Codex: ```bash curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ | sh -s -- --key --codex-enabled ``` -Esto instala el recolector, lo registra como servicio en segundo plano y comienza la captura. Confirma que está en ejecución: +Esto instala el recolector, lo registra como servicio en segundo plano y comienza a capturar. Confirma que está en ejecución: ```bash agenteye-collector health ``` -En la primera ejecución, las sesiones de Codex existentes se importan de una vez y la nueva actividad se transmite en cuestión de segundos. Los archivos propios de Codex solo se leen — nunca se modifican, mueven ni eliminan — y cada sesión se envía exactamente una vez, incluso tras reinicios. +En la primera ejecución, tus sesiones de Codex existentes se importan de forma retroactiva una sola vez; a partir de entonces, la nueva actividad llega en cuestión de segundos. Los archivos propios de Codex solo se leen; nunca se modifican, mueven ni eliminan, y cada sesión se envía exactamente una vez, incluso tras reinicios. --- ## Dónde aparece -Las sesiones capturadas aparecen en **Sessions**, y sus eventos en el flujo de **Events**, igual que cualquier otro agente que observes — por lo que la [reproducción de sesiones](/es/agenteye/sessions), la [búsqueda](/es/agenteye/queries), las [evaluaciones](/es/agenteye/evaluations) y las [alertas](/es/agenteye/alerts) funcionan con ellas del mismo modo. Filtra por el agente de Codex para verlas de forma independiente. +Las sesiones capturadas aparecen en **Sessions**, y sus eventos en el flujo de **Events**, igual que cualquier otro agente que observes. Por lo tanto, [la reproducción de sesiones](/es/agenteye/sessions), la [búsqueda](/es/agenteye/queries), las [evaluaciones](/es/agenteye/evaluations) y las [alertas](/es/agenteye/alerts) funcionan con ellas. Filtra por el agente de Codex para verlas por separado. --- ## Privacidad -Los transcriptos de Codex contienen la sesión completa — incluyendo la salida de comandos, el contenido de archivos y todo lo que Codex leyó o escribió — y pueden contener secretos. Las sesiones capturadas se envían tal cual, así que activa la captura solo en máquinas y para equipos donde centralizar ese contenido en AgentEye sea apropiado, y proporciona al recolector una clave con alcance exclusivo de `events:add`. Consulta [Seguridad](/es/agenteye/security) para saber cómo se mantienen aislados tus datos. \ No newline at end of file +Los registros de Codex contienen la sesión completa, incluida la salida de comandos, el contenido de archivos y cualquier cosa que Codex haya leído o escrito, y pueden contener información confidencial. Las sesiones capturadas se envían tal cual, así que activa la captura solo en las máquinas y para los equipos en los que centralizar ese contenido en AgentEye sea apropiado, y proporciona al recolector una clave con alcance exclusivo de `events:add`. Consulta [Seguridad](/es/agenteye/security) para saber cómo se mantienen tus datos aislados. \ No newline at end of file diff --git a/docs/es/agenteye/hermes-capture.mdx b/docs/es/agenteye/hermes-capture.mdx new file mode 100644 index 00000000..d7da9ebc --- /dev/null +++ b/docs/es/agenteye/hermes-capture.mdx @@ -0,0 +1,53 @@ +--- +title: "Captura de sesiones de Hermes" +description: "Incorpora las sesiones del gateway Hermes de tu equipo — Slack, Telegram, CLI y ejecuciones programadas — en AgentEye como sesiones y eventos ordinarios." +--- + +[Hermes](https://hermes-agent.nousresearch.com) responde a tu equipo desde donde ya trabajan — Slack, Telegram, la CLI, ejecuciones programadas. La captura de sesiones de Hermes trae todo eso a AgentEye como sesiones y eventos ordinarios, de modo que el asistente con el que tu equipo interactúa cada día sea tan observable como los agentes que tú mismo escribes. + +Un pequeño recolector en segundo plano lee el almacén de sesiones local de Hermes a medida que se escribe y envía las sesiones a AgentEye. Funciona de la misma manera que la captura de [Codex](/es/agenteye/codex-capture) y [OpenClaw](/es/agenteye/openclaw-capture), y un solo recolector puede capturar varios a la vez. + +--- + +## Qué captura + +Se captura cada sesión de Hermes en la máquina, independientemente del canal de origen. Cada una se convierte en una [sesión](/es/agenteye/sessions) de AgentEye; sus mensajes de usuario y asistente, llamadas a herramientas y resultados de herramientas se convierten en los [eventos](/es/agenteye/event-stream) correspondientes. + +El canal desde el que se inició una sesión — Slack, Telegram, CLI o una ejecución programada — queda registrado en la sesión, de modo que puedes distinguirlas y filtrar por una a la vez. Junto con ello se almacenan el modelo con el que corrió la sesión, el chat y la persona desde la que se inició y, cuando una sesión generó otra, el vínculo de vuelta a su sesión padre. + +Las sesiones aparecen en cuanto Hermes las inicia, independientemente de si se ha dicho algo todavía, y la respuesta de un turno y sus llamadas a herramientas se mantienen en el orden en que ocurrieron. Cuando una sesión finaliza, también obtienes el motivo del cierre, su coste y la cantidad de tokens utilizados. + +--- + +## Cómo activarlo + +La captura está desactivada hasta que la habilites. Instala el recolector con una clave de API que tenga el permiso `events:add` (consulta [Claves de API](/es/agenteye/api-keys)) y activa la captura de Hermes: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --hermes-enabled +``` + +Esto instala el recolector, lo registra como servicio en segundo plano y comienza la captura. Confirma que está en ejecución: + +```bash +agenteye-collector health +``` + +¿Capturas más de un agente en la misma máquina? Añade el indicador de cada uno al mismo comando — por ejemplo, `--hermes-enabled --codex-enabled`. + +En la primera ejecución, tus sesiones de Hermes existentes se importan retroactivamente una vez y la actividad nueva fluye en cuestión de segundos. Los datos propios de Hermes solo se leen — nunca se modifican ni eliminan — y cada mensaje se envía una sola vez, incluso tras reinicios. + +`health` también te indica si todo lo que capturó el recolector llegó realmente a AgentEye. Si un lote no pudo enviarse, se conserva y se reintenta en lugar de descartarse, y la verificación reporta estado no saludable mientras haya algo pendiente — así que «saludable» significa que tus datos llegaron, no simplemente que el proceso está activo. + +--- + +## Dónde aparece + +Las sesiones capturadas aparecen en **Sesiones**, y sus eventos en el flujo de **Eventos**, igual que cualquier otro agente que observes — por lo que la [reproducción de sesiones](/es/agenteye/sessions), la [búsqueda](/es/agenteye/queries), las [evaluaciones](/es/agenteye/evaluations) y las [alertas](/es/agenteye/alerts) funcionan sobre ellas. Filtra por el agente Hermes para verlas por separado. + +--- + +## Privacidad + +Las sesiones de Hermes contienen la transcripción completa — incluyendo la salida de comandos, contenido de archivos y todo lo que el agente leyó o escribió — y pueden contener secretos. Las sesiones capturadas se envían tal cual, por lo que activa la captura solo donde centralizar ese contenido en AgentEye sea apropiado, y proporciona al recolector una clave con ámbito únicamente para `events:add`. Consulta [Seguridad](/es/agenteye/security) para saber cómo se mantienen aislados tus datos. \ No newline at end of file diff --git a/docs/es/agenteye/openclaw-capture.mdx b/docs/es/agenteye/openclaw-capture.mdx new file mode 100644 index 00000000..dd18cb73 --- /dev/null +++ b/docs/es/agenteye/openclaw-capture.mdx @@ -0,0 +1,49 @@ +--- +title: "Captura de sesiones de OpenClaw" +description: "Transmite las sesiones locales de OpenClaw de tu equipo a AgentEye como sesiones y eventos ordinarios, sin ningún cambio en cómo se ejecuta OpenClaw." +--- + +Si tu equipo utiliza [OpenClaw](https://docs.openclaw.ai), la captura de sesiones de OpenClaw incorpora esas sesiones en AgentEye como sesiones y eventos ordinarios, para que puedas buscarlas, reproducirlas y evaluarlas junto al resto de lo que observas. Complementa el [SDK de Python](/es/agenteye/python-sdk): el SDK instrumenta los agentes que tú escribes, mientras que esta función captura el trabajo de OpenClaw que tu equipo ya realiza, sin ningún cambio en cómo lo ejecutan. + +Un pequeño recolector en segundo plano lee los transcriptos de sesión locales de OpenClaw a medida que se escriben y los envía a AgentEye. Funciona igual que la [captura de Codex](/es/agenteye/codex-capture), y un solo recolector puede capturar ambos a la vez. + +--- + +## Qué captura + +Cada agente configurado en la instalación de OpenClaw de una máquina es capturado por el recolector de esa máquina; no se requiere configuración por agente. + +Cada sesión de OpenClaw se convierte en una [sesión](/es/agenteye/sessions) de AgentEye; sus mensajes de usuario y asistente, llamadas a herramientas y resultados de herramientas se convierten en los [eventos](/es/agenteye/event-stream) correspondientes. + +--- + +## Cómo activarla + +La captura está desactivada hasta que la habilites. Instala el recolector con una clave API que tenga el permiso `events:add` (consulta [Claves API](/es/agenteye/api-keys)) y activa la captura de OpenClaw: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --openclaw-enabled +``` + +Esto instala el recolector, lo registra como un servicio en segundo plano y comienza a capturar. Confirma que está en ejecución: + +```bash +agenteye-collector health +``` + +¿Necesitas capturar más de un agente en la misma máquina? Añade el indicador de cada uno al mismo comando; por ejemplo, `--openclaw-enabled --codex-enabled`. + +En la primera ejecución, tus sesiones de OpenClaw existentes se importan retroactivamente una sola vez y la actividad nueva se transmite en segundos. Los archivos propios de OpenClaw solo se leen; nunca se modifican, mueven ni eliminan, y cada sesión se envía exactamente una vez, incluso tras reinicios. + +--- + +## Dónde aparece + +Las sesiones capturadas aparecen en **Sesiones**, y sus eventos en el flujo de **Eventos**, igual que cualquier otro agente que observes. Así, la [reproducción de sesiones](/es/agenteye/sessions), la [búsqueda](/es/agenteye/queries), las [evaluaciones](/es/agenteye/evaluations) y las [alertas](/es/agenteye/alerts) funcionan sobre ellas. Filtra por el agente de OpenClaw para verlas por separado. + +--- + +## Privacidad + +Los transcriptos de OpenClaw contienen la sesión completa, incluyendo la salida de comandos, el contenido de archivos y todo lo que el agente leyó o escribió, y pueden contener información confidencial. Las sesiones capturadas se envían tal cual, por lo que activa la captura únicamente en máquinas y para equipos donde centralizar ese contenido en AgentEye sea apropiado, y asigna al recolector una clave con alcance exclusivo de `events:add`. Consulta [Seguridad](/es/agenteye/security) para conocer cómo se mantienen aislados tus datos. \ No newline at end of file diff --git a/docs/fr/agenteye/codex-capture.mdx b/docs/fr/agenteye/codex-capture.mdx index 27f6f53b..34a5c244 100644 --- a/docs/fr/agenteye/codex-capture.mdx +++ b/docs/fr/agenteye/codex-capture.mdx @@ -1,53 +1,55 @@ --- title: "Capture de sessions Codex" -description: "Transmettez les sessions OpenAI Codex locales de votre équipe vers AgentEye sous forme de sessions et d'événements ordinaires — sans modifier leur façon d'utiliser Codex." +description: "Transmettez les sessions OpenAI Codex locales de votre équipe vers AgentEye sous forme de sessions et d'événements ordinaires, sans modifier leur façon de l'utiliser." --- -Vos ingénieurs utilisent déjà OpenAI Codex au quotidien. La capture de sessions Codex intègre ces sessions de développement dans AgentEye sous forme de sessions et d'événements ordinaires, afin que vous puissiez les rechercher, les rejouer et les évaluer aux côtés de tout ce que vous observez. Elle complète le [SDK Python](/fr/agenteye/python-sdk) : le SDK instrumente les agents que vous écrivez, tandis que cette fonctionnalité capture le travail Codex que votre équipe effectue déjà — sans aucune modification de leur façon de l'utiliser. +Vos ingénieurs utilisent OpenAI Codex au quotidien. La capture de sessions Codex intègre ces sessions de développement dans AgentEye sous forme de sessions et d'événements ordinaires, afin que vous puissiez les rechercher, les rejouer et les évaluer aux côtés de tout ce que vous observez. Elle complète le [SDK Python](/fr/agenteye/python-sdk) : le SDK instrumente les agents que vous écrivez, tandis que cette fonctionnalité capture le travail Codex que votre équipe effectue déjà — sans rien changer à la façon dont ils l'utilisent. -Un petit collecteur d'arrière-plan lit les transcripts de sessions locaux de Codex au fur et à mesure de leur écriture et les envoie à AgentEye. Un seul collecteur par machine capture simultanément toutes les surfaces Codex locales — aucune configuration par surface n'est nécessaire. +Un petit collecteur en arrière-plan lit les transcripts de sessions locaux de Codex au fur et à mesure de leur écriture et les envoie à AgentEye. Un seul collecteur par machine capture simultanément toutes les interfaces locales Codex — aucune configuration par interface n'est nécessaire. + +Ce même collecteur capture également d'autres agents — voir [OpenClaw](/fr/agenteye/openclaw-capture) et [Hermes](/fr/agenteye/hermes-capture). Activez chacun de ceux que vous utilisez ; un seul collecteur peut en capturer plusieurs à la fois. --- ## Ce qui est capturé -Chaque surface Codex fonctionnant **localement** produit les mêmes transcripts de session sur disque, et le collecteur les récupère tous : +Chaque interface Codex qui s'exécute **localement** produit les mêmes transcripts de session sur disque, et le collecteur les récupère tous : -- le **CLI** Codex et `codex exec` +- la **CLI** Codex et `codex exec` - l'**extension VS Code / IDE** -- l'**application de bureau**, lorsqu'elle exécute une session localement +- l'**application desktop**, lorsqu'elle exécute une session localement -Chaque session Codex devient une [session](/fr/agenteye/sessions) AgentEye ; ses messages utilisateur et assistant, son raisonnement, ses appels d'outils, ses résultats d'outils et son utilisation de tokens deviennent les [événements](/fr/agenteye/event-stream) correspondants. La surface d'origine de chaque session (CLI, IDE ou bureau) est enregistrée, ce qui vous permet de les distinguer. +Chaque session Codex devient une [session](/fr/agenteye/sessions) AgentEye ; ses messages utilisateur et assistant, le raisonnement, les appels d'outils, les résultats d'outils et l'utilisation des tokens deviennent les [événements](/fr/agenteye/event-stream) correspondants. L'interface d'origine de chaque session (CLI, IDE ou desktop) est enregistrée, ce qui vous permet de les distinguer. -> **Les sessions cloud ne sont pas capturées.** L'application de bureau exécute de plus en plus de sessions dans le cloud Codex et ne conserve que leurs métadonnées sur la machine — il n'y a aucun transcript local à lire. Seules les sessions exécutées localement sont capturées. +> **Les sessions cloud ne sont pas capturées.** L'application desktop exécute de plus en plus de sessions dans le cloud Codex et ne conserve sur la machine que leurs métadonnées — il n'existe pas de transcript local à lire. Seules les sessions exécutées localement sont capturées. --- ## Activation -La capture est désactivée jusqu'à ce que vous l'activiez. Installez le collecteur avec une clé API disposant de la permission `events:add` (voir [Clés API](/fr/agenteye/api-keys)), puis activez la capture Codex : +La capture est désactivée jusqu'à ce que vous l'activiez. Installez le collecteur avec une clé API disposant de la permission `events:add` (voir [Clés API](/fr/agenteye/api-keys)), et activez la capture Codex : ```bash curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ | sh -s -- --key --codex-enabled ``` -Cela installe le collecteur, l'enregistre en tant que service d'arrière-plan et démarre la capture. Vérifiez qu'il fonctionne : +Cela installe le collecteur, l'enregistre en tant que service en arrière-plan et démarre la capture. Vérifiez qu'il est bien en cours d'exécution : ```bash agenteye-collector health ``` -Au premier démarrage, vos sessions Codex existantes sont importées rétroactivement une seule fois, puis la nouvelle activité est transmise en quelques secondes. Les fichiers de Codex sont uniquement lus — jamais modifiés, déplacés ni supprimés — et chaque session est envoyée exactement une fois, même après des redémarrages. +Au premier démarrage, vos sessions Codex existantes sont importées rétroactivement une fois, puis toute nouvelle activité est transmise en quelques secondes. Les fichiers de Codex ne sont qu'en lecture — jamais modifiés, déplacés ou supprimés — et chaque session est envoyée exactement une fois, même après un redémarrage. --- -## Où les retrouver +## Où retrouver les données -Les sessions capturées apparaissent dans **Sessions**, et leurs événements dans le flux **Events**, comme pour tout autre agent que vous observez — ainsi, la [relecture de session](/fr/agenteye/sessions), la [recherche](/fr/agenteye/queries), les [évaluations](/fr/agenteye/evaluations) et les [alertes](/fr/agenteye/alerts) fonctionnent toutes avec elles. Filtrez par l'agent Codex pour les afficher séparément. +Les sessions capturées apparaissent dans **Sessions**, et leurs événements dans le flux **Events**, exactement comme n'importe quel autre agent que vous observez — ainsi, la [relecture de session](/fr/agenteye/sessions), la [recherche](/fr/agenteye/queries), les [évaluations](/fr/agenteye/evaluations) et les [alertes](/fr/agenteye/alerts) fonctionnent toutes sur ces données. Filtrez par l'agent Codex pour les visualiser séparément. --- ## Confidentialité -Les transcripts Codex contiennent l'intégralité de la session — y compris la sortie des commandes, le contenu des fichiers et tout ce que Codex a lu ou écrit — et peuvent contenir des informations sensibles. Les sessions capturées sont transmises telles quelles ; n'activez donc la capture que sur les machines et pour les équipes pour lesquelles la centralisation de ce contenu dans AgentEye est appropriée, et attribuez au collecteur une clé limitée à `events:add` uniquement. Consultez [Sécurité](/fr/agenteye/security) pour en savoir plus sur l'isolation de vos données. \ No newline at end of file +Les transcripts Codex contiennent l'intégralité de la session — y compris la sortie des commandes, le contenu des fichiers et tout ce que Codex a lu ou écrit — et peuvent contenir des informations sensibles. Les sessions capturées sont transmises telles quelles. N'activez donc la capture que sur les machines et pour les équipes pour lesquelles la centralisation de ce contenu dans AgentEye est appropriée, et fournissez au collecteur une clé limitée uniquement à `events:add`. Consultez [Sécurité](/fr/agenteye/security) pour savoir comment vos données sont maintenues isolées. \ No newline at end of file diff --git a/docs/fr/agenteye/hermes-capture.mdx b/docs/fr/agenteye/hermes-capture.mdx new file mode 100644 index 00000000..c960bb8c --- /dev/null +++ b/docs/fr/agenteye/hermes-capture.mdx @@ -0,0 +1,53 @@ +--- +title: "Capture de sessions Hermes" +description: "Intégrez les sessions de votre passerelle Hermes — Slack, Telegram, CLI et exécutions planifiées — dans AgentEye en tant que sessions et événements ordinaires." +--- + +[Hermes](https://hermes-agent.nousresearch.com) répond à votre équipe depuis n'importe où — Slack, Telegram, la CLI, des exécutions planifiées. La capture de sessions Hermes intègre tout cela dans AgentEye sous forme de sessions et d'événements ordinaires, de sorte que l'assistant avec lequel votre équipe interagit au quotidien est aussi observable que les agents que vous développez vous-même. + +Un petit collecteur en arrière-plan lit le dépôt de sessions local de Hermes au fur et à mesure de son écriture, puis envoie les sessions vers AgentEye. Il fonctionne de la même manière que les captures [Codex](/fr/agenteye/codex-capture) et [OpenClaw](/fr/agenteye/openclaw-capture), et un seul collecteur peut en capturer plusieurs à la fois. + +--- + +## Ce qui est capturé + +Toutes les sessions Hermes de la machine sont capturées, quel que soit le canal d'origine. Chacune devient une [session](/fr/agenteye/sessions) AgentEye ; ses messages utilisateur et assistant, ses appels d'outils et leurs résultats deviennent les [événements](/fr/agenteye/event-stream) correspondants. + +Le canal depuis lequel une session a démarré — Slack, Telegram, CLI ou une exécution planifiée — est enregistré sur la session, ce qui vous permet de les distinguer et de filtrer sur l'un d'eux à la fois. Sont également enregistrés le modèle sur lequel la session a tourné, la conversation et la personne à l'origine de son démarrage, et, lorsqu'une session en a engendré une autre, le lien vers la session parente. + +Les sessions apparaissent dès que Hermes les démarre, qu'il y ait eu ou non des échanges, et les réponses d'un tour ainsi que ses appels d'outils conservent l'ordre dans lequel ils se sont réellement produits. Lorsqu'une session se termine, vous obtenez également la raison de sa fin, son coût et le nombre de tokens utilisés. + +--- + +## Activation + +La capture est désactivée par défaut. Installez le collecteur avec une clé API disposant de la permission `events:add` (voir [Clés API](/fr/agenteye/api-keys)), puis activez la capture Hermes : + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --hermes-enabled +``` + +Cela installe le collecteur, l'enregistre en tant que service en arrière-plan et démarre la capture. Vérifiez qu'il est bien actif : + +```bash +agenteye-collector health +``` + +Vous capturez plusieurs agents sur la même machine ? Ajoutez le flag de chacun dans la même commande — par exemple `--hermes-enabled --codex-enabled`. + +Au premier démarrage, vos sessions Hermes existantes sont importées une seule fois, puis la nouvelle activité est transmise en quelques secondes. Les données propres à Hermes sont uniquement lues — jamais modifiées ni supprimées — et chaque message n'est envoyé qu'une seule fois, même après un redémarrage. + +`health` vous indique également si tout ce que le collecteur a capturé est bien parvenu à AgentEye. Si un lot ne peut pas être livré, il est conservé et réessayé plutôt que supprimé, et la vérification signale un état non sain tant que des éléments sont en attente — ainsi, « sain » signifie que vos données sont bien arrivées, pas seulement que le processus est en cours d'exécution. + +--- + +## Où les retrouver + +Les sessions capturées apparaissent dans **Sessions**, et leurs événements dans le flux **Events**, comme pour tout autre agent observé — ainsi, la [relecture de session](/fr/agenteye/sessions), la [recherche](/fr/agenteye/queries), les [évaluations](/fr/agenteye/evaluations) et les [alertes](/fr/agenteye/alerts) s'y appliquent toutes. Filtrez sur l'agent Hermes pour les afficher seuls. + +--- + +## Confidentialité + +Les sessions Hermes contiennent la transcription complète — y compris les sorties de commandes, le contenu des fichiers et tout ce que l'agent a lu ou écrit — et peuvent contenir des secrets. Les sessions capturées sont transmises telles quelles ; n'activez donc la capture que dans les contextes où la centralisation de ce contenu dans AgentEye est appropriée, et attribuez au collecteur une clé limitée à la seule permission `events:add`. Consultez [Sécurité](/fr/agenteye/security) pour en savoir plus sur l'isolation de vos données. \ No newline at end of file diff --git a/docs/fr/agenteye/openclaw-capture.mdx b/docs/fr/agenteye/openclaw-capture.mdx new file mode 100644 index 00000000..eea4a3ac --- /dev/null +++ b/docs/fr/agenteye/openclaw-capture.mdx @@ -0,0 +1,49 @@ +--- +title: "Capture de sessions OpenClaw" +description: "Transmettez les sessions OpenClaw locales de votre équipe dans AgentEye en tant que sessions et événements ordinaires — sans rien changer à la façon dont OpenClaw fonctionne." +--- + +Si votre équipe utilise [OpenClaw](https://docs.openclaw.ai), la capture de sessions OpenClaw intègre ces sessions dans AgentEye comme des sessions et des événements ordinaires, afin que vous puissiez les rechercher, les rejouer et les évaluer aux côtés de tout ce que vous observez par ailleurs. Cette fonctionnalité complète le [SDK Python](/fr/agenteye/python-sdk) : le SDK instrumente les agents que vous écrivez, tandis que la capture enregistre le travail OpenClaw que votre équipe effectue déjà — sans rien changer à la façon dont elle l'exécute. + +Un petit collecteur en arrière-plan lit les transcripts de sessions locaux d'OpenClaw au fur et à mesure de leur écriture et les envoie à AgentEye. Il fonctionne de la même manière que la [capture Codex](/fr/agenteye/codex-capture), et un seul collecteur peut capturer les deux simultanément. + +--- + +## Ce qui est capturé + +Chaque agent configuré dans l'installation OpenClaw d'une machine est capturé par le collecteur de cette machine — aucune configuration par agent n'est nécessaire. + +Chaque session OpenClaw devient une [session](/fr/agenteye/sessions) AgentEye ; ses messages utilisateur et assistant, ses appels d'outils et ses résultats d'outils deviennent les [événements](/fr/agenteye/event-stream) correspondants. + +--- + +## Activation + +La capture est désactivée jusqu'à ce que vous l'activiez. Installez le collecteur avec une clé API disposant de la permission `events:add` (voir [Clés API](/fr/agenteye/api-keys)), puis activez la capture OpenClaw : + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --openclaw-enabled +``` + +Cela installe le collecteur, l'enregistre en tant que service en arrière-plan et démarre la capture. Vérifiez qu'il fonctionne : + +```bash +agenteye-collector health +``` + +Vous capturez plusieurs agents sur la même machine ? Ajoutez le flag de chacun à la même commande — par exemple `--openclaw-enabled --codex-enabled`. + +Au premier démarrage, vos sessions OpenClaw existantes sont rétroimportées une seule fois, puis la nouvelle activité est transmise en quelques secondes. Les fichiers d'OpenClaw sont uniquement lus — jamais modifiés, déplacés ou supprimés — et chaque session est envoyée exactement une fois, même après des redémarrages. + +--- + +## Où retrouver les données + +Les sessions capturées apparaissent dans **Sessions**, et leurs événements dans le flux **Events**, au même titre que tout autre agent observé — ainsi, le [replay de session](/fr/agenteye/sessions), la [recherche](/fr/agenteye/queries), les [évaluations](/fr/agenteye/evaluations) et les [alertes](/fr/agenteye/alerts) fonctionnent tous sur ces données. Filtrez par l'agent OpenClaw pour les afficher séparément. + +--- + +## Confidentialité + +Les transcripts OpenClaw contiennent l'intégralité de la session — notamment la sortie des commandes, le contenu des fichiers et tout ce que l'agent a lu ou écrit — et peuvent contenir des secrets. Les sessions capturées sont transmises telles quelles ; n'activez donc la capture que sur les machines et pour les équipes où la centralisation de ce contenu dans AgentEye est appropriée, et fournissez au collecteur une clé limitée uniquement à `events:add`. Consultez [Sécurité](/fr/agenteye/security) pour savoir comment vos données sont maintenues isolées. \ No newline at end of file diff --git a/docs/he/agenteye/codex-capture.mdx b/docs/he/agenteye/codex-capture.mdx index cb3e700f..4f43c611 100644 --- a/docs/he/agenteye/codex-capture.mdx +++ b/docs/he/agenteye/codex-capture.mdx @@ -1,53 +1,56 @@ --- +--- title: "Codex session capture" -description: "Tail your team's local OpenAI Codex sessions into AgentEye as ordinary sessions and events — with no change to how they run Codex." +description: "עקוב אחר הפעלות Codex המקומיות של הצוות שלך ב-AgentEye כפעלות ואירועים רגילים — ללא שינוי בדרך ההפעלה שלהם." --- -המהנדסים שלך כבר מריצים OpenAI Codex כל יום. Codex session capture מביא את הסשנים של coding האלה ל-AgentEye כסשנים ואירועים רגילים, כך שתוכל לחפש, להשמיע חוזר (replay) ולהעריך אותם לצד הכל השני שאתה צופה בו. זה משלים את [Python SDK](/he/agenteye/python-sdk): ה-SDK מכנסת אג'נטים שאתה כותב, בעוד שזה תופס את עבודת Codex של הצוות שלך — ללא שינוי בדרך שהם מריצים אותו. +המהנדסים שלך כבר מפעילים OpenAI Codex כל יום. Codex session capture מביא את הפעלות הקידוד הללו ל-AgentEye כפעלות ואירועים רגילים, כך שתוכל לחפש, להשמיע שוב ולהעריך אותם לצד כל שאר מה שאתה צופה. זה משלים את [Python SDK](/he/agenteye/python-sdk): ה-SDK מציידים agents שאתה כותב, בעוד שזה תופס את עבודת Codex של הצוות שלך כבר — ללא שינוי בדרך הפעלתם. + +קולט רקע קטן קורא תמלילי הפעלות Codex המקומיים כשהם נכתבים וגורם להם להיות משודרים ל-AgentEye. קולט אחד למכונה תופס כל משטח Codex מקומי בו-זמנית — אין הגדרה per-surface. -אספן רקע קטן קורא את תמלול הסשן המקומי של Codex כפי שהוא נכתב וגורם להם להגיע ל-AgentEye. אספן אחד למכונה תופס כל משטח Codex מקומי בו זמנית — אין הגדרה לכל משטח. +אותו קולט תופס agents אחרים גם — ראה [OpenClaw](/he/agenteye/openclaw-capture) ו-[Hermes](/he/agenteye/hermes-capture). הפעל כל אחד מהם שאתה משתמש בו; קולט יחיד יכול לתפוס כמה ערוצים בו-זמנית. --- -## מה זה תופס +## מה הוא תופס -כל משטח Codex שרץ **locally** מייצר את אותם תמלול סשן על הדיסק, והאספן באוצר אותם: +כל משטח Codex שרץ **באופן מקומי** מייצר את אותם תמלילי הפעלות על-דיסק, והקולט קוטף את כולם: -- Codex **CLI** ו-`codex exec` -- **VS Code / IDE extension** -- **desktop app**, כאשר הוא מריץ סשן locally +- ה-Codex **CLI** ו-`codex exec` +- ה-**VS Code / IDE extension** +- ה-**desktop app**, כשהוא מפעיל הפעלה באופן מקומי -כל סשן Codex הופך ל-AgentEye [session](/he/agenteye/sessions); הודעות המשתמש והעוזר שלו, חשיבה, קריאות כלים (tool calls), תוצאות כלים וסימון שימוש הופכים ל-[events](/he/agenteye/event-stream) התואמים. המשטח שכל סשן הגיע ממנו (CLI, IDE, או desktop) מתועד, כך שתוכל להבדיל ביניהם. +כל הפעלת Codex הופכת ל-AgentEye [session](/he/agenteye/sessions); ההודעות שלה של משתמש ועוזר, הנמקה, קריאות כלים, תוצאות כלים והשימוש בטוקנים הופכים ל-[events](/he/agenteye/event-stream) התואמים. המשטח שממנו הגיעה כל הפעלה (CLI, IDE, או desktop) נרשם, כך שתוכל להבדיל ביניהם. -> **Cloud sessions are not captured.** ה-desktop app כל יום יותר מריץ סשנים בענן של Codex ומשמר רק את המטא-דטה שלהם במכונה — אין תמלול מקומי לקריאה. רק סשנים שמבוצעים locally תופסים. +> **הפעלות ענן אינן תפוסות.** ה-desktop app הולך ורב מפעיל הפעלות בענן Codex ושומר רק את המטא-נתונים שלהם על המכונה — אין תמליל מקומי לקרוא. רק הפעלות שבוצעו באופן מקומי תפוסות. --- -## הפעל את זה +## הפוך את זה להפעלה -capture כבויה עד שתפעיל אותה. התקן את האספן עם API key שיש לו את ההרשאה `events:add` (ראה [API keys](/he/agenteye/api-keys)), והפעל את Codex capture: +Capture כבויה עד שתוכל להפעיל אותה. התקן את הקולט עם מפתח API שיש לו את ההרשאה `events:add` (ראה [API keys](/he/agenteye/api-keys)), והפעל את Codex capture: ```bash curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ | sh -s -- --key --codex-enabled ``` -זה מתקין את האספן, רושם אותו כשירות רקע, ומתחיל לתפוס. אשר שהוא רץ: +זה מתקין את הקולט, רושם אותו כשירות רקע, והחל לתפוס. אשר שהוא רץ: ```bash agenteye-collector health ``` -בריצה ראשונה, הסשנים קיימים של Codex שלך מלאים חזרה פעם אחת ופעילות חדשה אז זורמת בתוך שניות. הקבצים של Codex עצמו נקראים בלבד — לעולם לא שונים, הועברו או נמחקו — וכל סשן נשלח בדיוק פעם אחת, אפילו על פני restarts. +בהרצה הראשונה, הפעלות Codex הקיימות שלך מתמלאות חזרה פעם אחת והפעילות חדשה משודרת בתוך שניות. קובצים שלהם של Codex קוראים בלבד — לעולם לא משונים, מועברים, או מחוקים — וכל הפעלה משודרת בדיוק פעם אחת, גם על פני restarts. --- ## איפה זה מופיע -סשנים תופסו מופיעים ב-**Sessions**, ואירועיהם בזרם **Events**, בדיוק כמו כל אג'נט אחר שאתה צופה בו — כך [session replay](/he/agenteye/sessions), [search](/he/agenteye/queries), [evaluations](/he/agenteye/evaluations), ו-[alerts](/he/agenteye/alerts) כולם עובדים עליהם. סנן לפי ה-agent של Codex כדי לראות אותם בעצמם. +הפעלות שתפוסות מופיעות ב-**Sessions**, והאירועים שלהם ב-**Events** stream, אותו דבר כמו כל agent אחר שאתה צופה — אז [session replay](/he/agenteye/sessions), [search](/he/agenteye/queries), [evaluations](/he/agenteye/evaluations), ו-[alerts](/he/agenteye/alerts) כולם עובדים עליהם. סנן לפי ה-Codex agent כדי לראות אותם בעצמם. --- ## פרטיות -תמלול של Codex מכיל את הסשן המלא — כולל פלט פקודה, תוכן קבצים, וכל דבר שCodex קרא או כתב — ויכול להכיל סודות. סשנים תפסו נשלחים כמו שהם, כך שהפעל capture רק על מכונות וצוותים שבהם ריכוז תוכן זה ב-AgentEye מתאים, ותן לאספן key שמתוחם ל-`events:add` בלבד. ראה [Security](/he/agenteye/security) לקבלת מידע כיצד הנתונים שלך מובדלים. \ No newline at end of file +תמלילי Codex מכילים את הפעלה המלאה — כולל פלט הפקודה, תוכן הקובץ, וכל מה ש-Codex קרא או כתב — ויכול להכיל סודות. הפעלות שתפוסות משודרות כמו שהן, אז הפעל capture רק על מכונות ובשביל צוותים שבהם ריכוז תוכן זה ב-AgentEye מתאים, וגיברת לקולט מפתח מוגבל ל-`events:add` בלבד. ראה [Security](/he/agenteye/security) לדיון בכיצד הנתונים שלך משמרים בדידים. \ No newline at end of file diff --git a/docs/he/agenteye/hermes-capture.mdx b/docs/he/agenteye/hermes-capture.mdx new file mode 100644 index 00000000..7015cb47 --- /dev/null +++ b/docs/he/agenteye/hermes-capture.mdx @@ -0,0 +1,53 @@ +--- +title: "תפיסת הפעלות Hermes" +description: "הבא את הפעלות ה־Hermes gateway של הצוות שלך — Slack, Telegram, CLI וריצות מתוזמנות — ל־AgentEye כהפעלות ואירועים רגילים." +--- + +[Hermes](https://hermes-agent.nousresearch.com) משיב לצוות שלך מכל מקום שבו הם כבר עובדים — Slack, Telegram, ה־CLI וריצות מתוזמנות. תפיסת הפעלות Hermes מביאה הכל ל־AgentEye כהפעלות ואירועים רגילים, כך שהעוזר שהצוות שלך מדבר איתו כל יום נראה באותה מידה כמו הסוכנים שאתה כותב בעצמך. + +אוסף רקע קטן קורא את חנות ההפעלות המקומית של Hermes כשהיא נכתבת ושולח הפעלות ל־AgentEye. זה עובד באותה דרך כמו תפיסת [Codex](/he/agenteye/codex-capture) ו־[OpenClaw](/he/agenteye/openclaw-capture), ואוסף אחד יכול לתפוס כמה בו־זמנית. + +--- + +## מה הוא תופס + +כל הפעלת Hermes במכונה נתפסת, מאיזה ערוץ שהיא הגיעה. כל אחת הופכת ל־[הפעלה](/he/agenteye/sessions) של AgentEye; הודעות המשתמש וההעוזר שלה, קריאות כלים ותוצאות כלים הופכות ל־[אירועים](/he/agenteye/event-stream) תואמים. + +הערוץ שממנו התחילה הפעלה — Slack, Telegram, CLI או ריצה מתוזמנת — נרשם בהפעלה, כך שאתה יכול להבדיל ביניהם ולסנן לאחד בכל פעם. לצידו מגיעים המודל שעליו רצה ההפעלה, הצ'אט והאדם שממנו היא התחילה, וכאשר הפעלה יצרה אחרת, הקישור חזרה להורה שלה. + +הפעלות מופיעות ברגע שHeems מתחיל אותן, בין אם משהו נאמר או לא, והתשובה של תור וקריאות הכלים שלו נשארות בסדר שבו הן בעצם התרחשו. כאשר הפעלה מסתיימת אתה גם מקבל למה היא הסתיימה, מה היא עלתה וכמה טוקנים היא השתמשה. + +--- + +## הפעל זאת + +התפיסה כבויה עד שתפעילה. התקן את האוסף עם מפתח API שיש לו את הרשות `events:add` (ראה [מפתחות API](/he/agenteye/api-keys)), והפעל תפיסת Hermes: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --hermes-enabled +``` + +זה מתקין את האוסף, רושם אותו כשירות רקע ומתחיל בתפיסה. אשר שהוא פועל: + +```bash +agenteye-collector health +``` + +תופס יותר מסוכן אחד באותה מכונה? הוסף את הדגל של כל אחד לאותו פקודה — לדוגמה `--hermes-enabled --codex-enabled`. + +בריצה הראשונה, ההפעלות Hermes הקיימות שלך מחוזרות עמודים פעם אחת והפעילות חדשה אז מזרימות תוך שניות. הנתונים של Hermes עצמו נקראים בלבד — לעולם לא משונים או נמחקים — וכל הודעה נשלחת פעם אחת, אפילו על פני הפעלות מחדש. + +`health` גם אומר לך האם הכל שהאוסף תפס בעצם הגיע ל־AgentEye. אם תיקיה לא יכלה להיות מסופקת היא נשמרת וחוזרת על עצמה במקום להיות מושלכת, והבדיקה מדווחת לא בריאה בעוד שום דבר עדיין חי — כך שבריא פירוש הוא שהנתונים שלך הגיעו, לא רק שהתהליך חי. + +--- + +## היכן זה מופיע + +הפעלות שנתפסו מופיעות ב־**Sessions**, והאירועים שלהם בזרם **Events**, כמו כל סוכן אחר שאתה צופה — כך [replay של הפעלה](/he/agenteye/sessions), [חיפוש](/he/agenteye/queries), [הערכות](/he/agenteye/evaluations) ו־[התראות](/he/agenteye/alerts) כולם עובדים עליהם. סנן לפי סוכן ה־Hermes כדי לראות אותם בעצמם. + +--- + +## פרטיות + +הפעלות Hermes מכילות את העמלה המלאה — כולל פלט פקודה, תוכן קובצים וכל דבר שהסוכן קרא או כתב — ויכול להכיל סודות. הפעלות שנתפסו נשלחות כפי שהן, כך שהפעל תפיסה רק כאשר מרכוז תוכן זה ב־AgentEye מתאים, ותן לאוסף מפתח בהיקף של `events:add` בלבד. ראה [Security](/he/agenteye/security) לקבלת פרטים כיצד הנתונים שלך מוחזקים מבודדים. \ No newline at end of file diff --git a/docs/he/agenteye/openclaw-capture.mdx b/docs/he/agenteye/openclaw-capture.mdx new file mode 100644 index 00000000..037bcb19 --- /dev/null +++ b/docs/he/agenteye/openclaw-capture.mdx @@ -0,0 +1,50 @@ +--- +--- +title: "תיעוד OpenClaw" +description: "עקוב אחר הפעילויות המקומיות של OpenClaw של הצוות שלך ב-AgentEye כפי שהן וקורים — ללא כל שינוי בדרך שבה OpenClaw פועל." +--- + +אם הצוות שלך משתמש ב-[OpenClaw](https://docs.openclaw.ai), תיעוד OpenClaw מעביר את הפעילויות הללו ל-AgentEye כפעילויות ואירועים רגילים, כך שתוכלו לחפש, להשמיע שוב, והערכת כל דבר שאתם צופים. זה משלים את [Python SDK](/he/agenteye/python-sdk): ה-SDK מייעצ חכמים שכתבתם, בעוד שזה משום את עבודת OpenClaw שהצוות שלך כבר עושה — ללא כל שינוי בדרך שבה הם מריצים אותה. + +אספן רקע קטן קורא את תמלילי הפעילות המקומיות של OpenClaw בזמן שהם נכתבים ושולח אותם ל-AgentEye. זה עובד בדיוק כמו [Codex capture](/he/agenteye/codex-capture), ואספן אחד יכול לתעד את שניהם בו-זמנית. + +--- + +## מה הוא תיעוד + +כל חכם שמוגדר בהגדרת OpenClaw של מכונה תועד על ידי אספן המכונה של המכונה הזו — אין הגדרה לכל חכם. + +כל פעילות OpenClaw הופכת ל-[session](/he/agenteye/sessions) ב-AgentEye; ההודעות שלה מהמשתמש והסייע, קריאות כלים, ותוצאות כלים הופכות ל-[events](/he/agenteye/event-stream) תואמות. + +--- + +## הפעילו אותו + +התיעוד כבוי עד שתפעילו אותו. התקינו את האספן עם מפתח API שיש לו הרשאת `events:add` (ראו [API keys](/he/agenteye/api-keys)), והפעילו תיעוד OpenClaw: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --openclaw-enabled +``` + +זה מתקין את האספן, רושם אותו כשירות רקע, והתחיל לתעד. אישרו שהוא פועל: + +```bash +agenteye-collector health +``` + +מתעדים יותר מחכם אחד על אותה מכונה? הוסיפו כל דגל של אחד לאותה פקודה — לדוגמה `--openclaw-enabled --codex-enabled`. + +בהרצה הראשונה, הפעילויות OpenClaw הקיימות שלך מופעלות בחזרה פעם אחת ופעילות חדשה זורמת תוך שניות. קבצי OpenClaw שלו נקראים בלבד — לעולם לא משונים, מועברים, או נמחקים — וכל פעילות נשלחת בדיוק פעם אחת, אפילו על פני הפעלות חוזרות. + +--- + +## איפה זה מופיע + +פעילויות תועדות מופיעות ב-**Sessions**, והאירועים שלהן בזרם **Events**, בדיוק כמו כל חכם אחר שאתם צופים — כך ש[session replay](/he/agenteye/sessions), [search](/he/agenteye/queries), [evaluations](/he/agenteye/evaluations), ו[alerts](/he/agenteye/alerts) כולם עובדים עליהם. סננו לפי חכם OpenClaw כדי לראות אותם בעצמם. + +--- + +## פרטיות + +תמלילי OpenClaw מכילים את הפעילות המלאה — כולל פלט פקודה, תוכן קבצים, ודבר שהחכם קרא או כתב — ויכולים להכיל סודות. פעילויות תועדות משלחות כמו שהן, כך שהפעילו תיעוד רק על מכונות ועבור צוותים שבהם ריכוז הזה של תוכן ב-AgentEye הוא הולם, ותנו לאספן מפתח מוגבל ל-`events:add` בלבד. ראו [Security](/he/agenteye/security) כדי לראות כיצד הנתונים שלך נשמרים בידוד. \ No newline at end of file diff --git a/docs/hi/agenteye/codex-capture.mdx b/docs/hi/agenteye/codex-capture.mdx index 5dfff6bd..b219e35a 100644 --- a/docs/hi/agenteye/codex-capture.mdx +++ b/docs/hi/agenteye/codex-capture.mdx @@ -1,53 +1,56 @@ --- -title: "Codex session capture" -description: "अपनी टीम के स्थानीय OpenAI Codex सेशन को AgentEye में सामान्य सेशन और इवेंट के रूप में कैप्चर करें — Codex चलाने के तरीके में कोई बदलाव नहीं।" --- +title: "Codex सत्र कैप्चर" +description: "अपनी टीम के स्थानीय OpenAI Codex सत्रों को AgentEye में सामान्य सत्र और इवेंट्स के रूप में कैप्चर करें — Codex चलाने के तरीके में कोई बदलाव नहीं।" +--- + +आपके इंजीनियर पहले से ही हर दिन OpenAI Codex चलाते हैं। Codex सत्र कैप्चर उन कोडिंग सत्रों को AgentEye में सामान्य सत्र और इवेंट्स के रूप में लाता है, ताकि आप उन्हें खोज सकें, रीप्ले कर सकें, और आपके द्वारा देखी गई अन्य सभी चीजों के साथ मिलाकर मूल्यांकन कर सकें। यह [Python SDK](/hi/agenteye/python-sdk) को पूरक बनाता है: SDK आपके द्वारा लिखे गए agents को साधन करता है, जबकि यह आपकी टीम द्वारा पहले से किए जा रहे Codex काम को कैप्चर करता है — इसे चलाने के तरीके में कोई बदलाव नहीं। -आपके engineers पहले से ही हर दिन OpenAI Codex चलाते हैं। Codex session capture उन कोडिंग सेशन को AgentEye में सामान्य सेशन और इवेंट के रूप में लाता है, ताकि आप उन्हें खोज सकें, replay कर सकें, और आप जो कुछ और देखते हैं उसके साथ मूल्यांकन कर सकें। यह [Python SDK](/hi/agenteye/python-sdk) को पूरक करता है: SDK उन agents को instrument करता है जो आप लिखते हैं, जबकि यह Codex कार्य को कैप्चर करता है जो आपकी टीम पहले से करती है — इसे चलाने के तरीके में कोई बदलाव नहीं। +एक छोटा बैकग्राउंड कलेक्टर Codex के स्थानीय सत्र ट्रांसक्रिप्ट्स को पढ़ता है जैसे ही वे लिखे जाते हैं और उन्हें AgentEye में भेजता है। एक मशीन प्रति कलेक्टर एक ही समय में हर स्थानीय Codex सतह को कैप्चर करता है — प्रति-सतह सेटअप की कोई आवश्यकता नहीं है। -एक छोटा background collector Codex के स्थानीय session transcripts को पढ़ता है जैसे वे लिखे जाते हैं और उन्हें AgentEye को भेजता है। एक मशीन प्रति collector एक साथ हर स्थानीय Codex surface को कैप्चर करता है — कोई per-surface setup नहीं है। +वही कलेक्टर अन्य agents को भी कैप्चर करता है — [OpenClaw](/hi/agenteye/openclaw-capture) और [Hermes](/hi/agenteye/hermes-capture) देखें। प्रत्येक को सक्षम करें जो आप चलाते हैं; एक ही कलेक्टर एक ही समय में कई को कैप्चर कर सकता है। --- ## यह क्या कैप्चर करता है -हर Codex surface जो **स्थानीय रूप से** चलता है, समान on-disk session transcripts बनाता है, और collector सभी को उठाता है: +हर Codex सतह जो **स्थानीय रूप से** चलती है, वही डिस्क-पर सत्र ट्रांसक्रिप्ट्स बनाती है, और कलेक्टर उन सभी को उठाता है: - Codex **CLI** और `codex exec` -- **VS Code / IDE extension** -- **desktop app**, जब यह स्थानीय रूप से सेशन चलाता है +- **VS Code / IDE एक्सटेंशन** +- **डेस्कटॉप ऐप**, जब वह स्थानीय रूप से कोई सत्र चलाता है -प्रत्येक Codex session एक AgentEye [session](/hi/agenteye/sessions) बन जाता है; इसके user और assistant messages, reasoning, tool calls, tool results, और token usage matching [events](/hi/agenteye/event-stream) बन जाते हैं। वह surface जहां से प्रत्येक session आया है (CLI, IDE, या desktop) दर्ज किया जाता है, ताकि आप उन्हें अलग बता सकें। +प्रत्येक Codex सत्र AgentEye [सत्र](/hi/agenteye/sessions) बन जाता है; इसके उपयोगकर्ता और सहायक संदेश, तर्क, टूल कॉल, टूल परिणाम, और टोकन उपयोग मिलान करने वाले [इवेंट्स](/hi/agenteye/event-stream) बन जाते हैं। जिस सतह से प्रत्येक सत्र आया है (CLI, IDE, या डेस्कटॉप) वह रिकॉर्ड किया जाता है, ताकि आप उन्हें अलग बता सकें। -> **Cloud sessions कैप्चर नहीं किए जाते।** Desktop app तेजी से Codex cloud में sessions चलाता है और मशीन पर केवल उनके metadata रखता है — कोई local transcript नहीं है। केवल स्थानीय रूप से निष्पादित sessions कैप्चर किए जाते हैं। +> **क्लाउड सत्र कैप्चर नहीं किए जाते हैं।** डेस्कटॉप ऐप बढ़ती हुई Codex क्लाउड में सत्रों को चलाता है और मशीन पर केवल उनके मेटाडेटा को रखता है — पढ़ने के लिए कोई स्थानीय ट्रांसक्रिप्ट नहीं है। केवल स्थानीय रूप से निष्पादित सत्र कैप्चर किए जाते हैं। --- ## इसे चालू करें -Capture तब तक बंद है जब तक आप इसे सक्षम न करें। Collector को एक API key के साथ install करें जिसके पास `events:add` permission है ([API keys](/hi/agenteye/api-keys) देखें), और Codex capture चालू करें: +कैप्चर तब तक बंद रहता है जब तक आप इसे सक्षम न करें। एक API key के साथ कलेक्टर को इंस्टॉल करें जिसके पास `events:add` अनुमति है ([API keys](/hi/agenteye/api-keys) देखें), और Codex कैप्चर चालू करें: ```bash curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ | sh -s -- --key --codex-enabled ``` -यह collector को install करता है, इसे background service के रूप में register करता है, और capture शुरू करता है। पुष्टि करें कि यह चल रहा है: +यह कलेक्टर को इंस्टॉल करता है, इसे एक बैकग्राउंड सेवा के रूप में पंजीकृत करता है, और कैप्चर करना शुरू करता है। पुष्टि करें कि यह चल रहा है: ```bash agenteye-collector health ``` -पहली run पर, आपके मौजूदा Codex sessions एक बार backfill किए जाते हैं और नई activity फिर कुछ सेकंड में stream होती है। Codex की अपनी files को केवल read किया जाता है — कभी modified, moved, या deleted नहीं — और प्रत्येक session को बिल्कुल एक बार shipped किया जाता है, restarts के भी बाद। +पहली बार चलाने पर, आपके मौजूदा Codex सत्रों को एक बार बैकफिल किया जाता है और नई गतिविधि फिर सेकंड के भीतर स्ट्रीम होती है। Codex की अपनी फाइलें केवल कभी पढ़ी जाती हैं — कभी संशोधित, स्थानांतरित, या हटाई नहीं जाती हैं — और प्रत्येक सत्र को बिल्कुल एक बार भेजा जाता है, यहां तक कि पुनरारंभ के भी। --- -## यह कहां दिखाई देता है +## यह कहां दिखता है -कैप्चर किए गए sessions **Sessions** में दिखाई देते हैं, और उनके events **Events** stream में, जैसे कि कोई अन्य agent जिसे आप देखते हैं — इसलिए [session replay](/hi/agenteye/sessions), [search](/hi/agenteye/queries), [evaluations](/hi/agenteye/evaluations), और [alerts](/hi/agenteye/alerts) सभी इन पर काम करते हैं। उन्हें अपने आप पर देखने के लिए Codex agent के अनुसार filter करें। +कैप्चर किए गए सत्र **सत्र** में दिखाई देते हैं, और उनके इवेंट्स **इवेंट्स** स्ट्रीम में, किसी अन्य agent के समान जिसे आप देखते हैं — इसलिए [सत्र रीप्ले](/hi/agenteye/sessions), [खोज](/hi/agenteye/queries), [मूल्यांकन](/hi/agenteye/evaluations), और [सतर्कताएं](/hi/agenteye/alerts) सभी उन पर काम करती हैं। Codex agent द्वारा फ़िल्टर करें उन्हें अपने आप पर देखने के लिए। --- ## गोपनीयता -Codex transcripts में पूरा session होता है — command output, file contents सहित, और कुछ भी जो Codex ने read या write किया — और में secrets हो सकते हैं। कैप्चर किए गए sessions को जैसे हैं वैसे ही shipped किया जाता है, इसलिए capture को केवल उन मशीनों पर और उन टीमों के लिए enable करें जहां उस content को AgentEye में centralize करना appropriate है, और collector को केवल `events:add` के लिए scoped key दें। देखें [Security](/hi/agenteye/security) कि आपके डेटा को कैसे isolated रखा जाता है। \ No newline at end of file +Codex ट्रांसक्रिप्ट्स में पूरा सत्र होता है — कमांड आउटपुट, फ़ाइल सामग्री, और कुछ भी Codex ने पढ़ा या लिखा — और इसमें गोपनीय चीजें हो सकती हैं। कैप्चर किए गए सत्रों को ऐसे भेजा जाता है, इसलिए केवल उन मशीनों और टीमों पर कैप्चर सक्षम करें जहां उस सामग्री को AgentEye में केंद्रीकृत करना उपयुक्त है, और कलेक्टर को केवल `events:add` तक सीमित एक key दें। अपने डेटा को कैसे अलग रखा जाता है इसके बारे में [Security](/hi/agenteye/security) देखें। \ No newline at end of file diff --git a/docs/hi/agenteye/hermes-capture.mdx b/docs/hi/agenteye/hermes-capture.mdx new file mode 100644 index 00000000..5d249924 --- /dev/null +++ b/docs/hi/agenteye/hermes-capture.mdx @@ -0,0 +1,53 @@ +--- +title: "Hermes session capture" +description: "अपनी टीम के Hermes gateway सेशन — Slack, Telegram, CLI, और scheduled runs — को AgentEye में साधारण सेशन और events के रूप में लाएं।" +--- + +[Hermes](https://hermes-agent.nousresearch.com) आपकी टीम को उन्हीं जगहों से जवाब देता है जहां वह पहले से काम कर रही है — Slack, Telegram, CLI, scheduled runs। Hermes session capture सभी चीजों को AgentEye में साधारण सेशन और events के रूप में लाता है, ताकि आपकी टीम जो asistant के साथ हर दिन बात करती है वह उतना ही observable हो जितने agents आप खुद लिखते हैं। + +एक छोटा background collector Hermes के local session store को पढ़ता है जैसे वह लिखा जाता है और sessions को AgentEye में भेजता है। यह [Codex](/hi/agenteye/codex-capture) और [OpenClaw](/hi/agenteye/openclaw-capture) capture के समान तरीके से काम करता है, और एक collector एक बार में कई को capture कर सकता है। + +--- + +## यह क्या capture करता है + +मशीन पर हर Hermes session capture किया जाता है, चाहे वह किसी भी channel से आया हो। प्रत्येक एक AgentEye [session](/hi/agenteye/sessions) बन जाता है; इसके user और assistant messages, tool calls, और tool results संबंधित [events](/hi/agenteye/event-stream) बन जाते हैं। + +वह channel जिससे session शुरू हुआ था — Slack, Telegram, CLI, या एक scheduled run — session पर रिकॉर्ड किया जाता है, ताकि आप उन्हें अलग कर सकें और एक बार में एक को filter कर सकें। इसके साथ वह model आता है जिस पर session चला, chat और person जिससे यह शुरू हुआ था, और जब एक session ने दूसरे को spawn किया, तो इसके parent के साथ का लिंक। + +Sessions जैसे ही Hermes उन्हें शुरू करता है वैसे ही दिखाई देते हैं, चाहे कुछ कहा गया हो या नहीं, और एक turn का reply और इसके tool calls वास्तव में जिस क्रम में हुए थे उसी क्रम में रहते हैं। जब कोई session समाप्त होता है तो आपको यह भी मिलता है कि यह क्यों समाप्त हुआ, इसकी लागत क्या थी, और इसने कितने tokens का उपयोग किया। + +--- + +## इसे चालू करें + +Capture तब तक बंद रहता है जब तक आप इसे enable न करें। एक API key के साथ collector को install करें जिसके पास `events:add` permission हो (देखें [API keys](/hi/agenteye/api-keys)), और Hermes capture को चालू करें: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --hermes-enabled +``` + +यह collector को install करता है, इसे एक background service के रूप में register करता है, और capturing शुरू करता है। पुष्टि करें कि यह चल रहा है: + +```bash +agenteye-collector health +``` + +एक ही मशीन पर एक से अधिक agent को capture कर रहे हैं? एक ही command में प्रत्येक का flag जोड़ें — उदाहरण के लिए `--hermes-enabled --codex-enabled`। + +पहली बार चलाने पर, आपके मौजूदा Hermes sessions को एक बार backfill किया जाता है और नई activity फिर कुछ सेकंड में stream होती है। Hermes के अपने डेटा को केवल पढ़ा जाता है — कभी modified या deleted नहीं किया जाता — और प्रत्येक message एक बार भेजा जाता है, यहां तक कि restarts के पार भी। + +`health` यह भी बताता है कि क्या collector ने जो कुछ भी capture किया वह वास्तव में AgentEye तक पहुंचा। यदि एक batch deliver नहीं हो सकी तो उसे रखा जाता है और discarded करने के बजाय retry किया जाता है, और check तब तक unhealthy रिपोर्ट करता है जब तक कुछ भी outstanding है — तो "healthy" का मतलब है कि आपका डेटा पहुंचा, केवल यह नहीं कि process alive है। + +--- + +## यह कहां दिखाई देता है + +Captured sessions **Sessions** में दिखाई देते हैं, और उनके events **Events** stream में, किसी भी अन्य agent की तरह जिसे आप observe करते हैं — तो [session replay](/hi/agenteye/sessions), [search](/hi/agenteye/queries), [evaluations](/hi/agenteye/evaluations), और [alerts](/hi/agenteye/alerts) सभी उन पर काम करते हैं। Hermes agent के लिए filter करें उन्हें अपने आप देखने के लिए। + +--- + +## गोपनीयता + +Hermes sessions में पूरा transcript होता है — command output, file contents, और कुछ भी जो agent ने पढ़ा या लिखा — और इसमें secrets हो सकते हैं। Captured sessions को जैसे हैं वैसे भेजा जाता है, तो capture को केवल वहां enable करें जहां इस content को AgentEye में centralize करना appropriate है, और collector को एक key दें जो केवल `events:add` के लिए scoped हो। देखें [Security](/hi/agenteye/security) कि आपका डेटा कैसे isolated रखा जाता है। \ No newline at end of file diff --git a/docs/hi/agenteye/openclaw-capture.mdx b/docs/hi/agenteye/openclaw-capture.mdx new file mode 100644 index 00000000..f058dbfb --- /dev/null +++ b/docs/hi/agenteye/openclaw-capture.mdx @@ -0,0 +1,49 @@ +--- +title: "OpenClaw session capture" +description: "अपनी टीम के स्थानीय OpenClaw सेशन को AgentEye में सामान्य सेशन और इवेंट के रूप में कैप्चर करें — OpenClaw के चलने के तरीके में कोई बदलाव नहीं।" +--- + +यदि आपकी टीम [OpenClaw](https://docs.openclaw.ai) चलाती है, तो OpenClaw session capture उन सेशन को AgentEye में सामान्य सेशन और इवेंट के रूप में लाता है, ताकि आप उन्हें खोज सकें, दोबारा चला सकें, और आप जो कुछ और देखते हैं उसके साथ-साथ उनका मूल्यांकन कर सकें। यह [Python SDK](/hi/agenteye/python-sdk) को पूरक बनाता है: SDK आपके द्वारा लिखे गए एजेंट को उपकरण प्रदान करता है, जबकि यह आपकी टीम द्वारा पहले से किए जा रहे OpenClaw कार्य को कैप्चर करता है — इसे चलाने के तरीके में कोई बदलाव नहीं। + +एक छोटा बैकग्राउंड कलेक्टर OpenClaw की स्थानीय सेशन ट्रांसक्रिप्ट को पढ़ता है जैसे ही वे लिखे जाते हैं और उन्हें AgentEye को भेजता है। यह [Codex capture](/hi/agenteye/codex-capture) के समान ही काम करता है, और एक कलेक्टर एक ही समय में दोनों को कैप्चर कर सकता है। + +--- + +## यह क्या कैप्चर करता है + +किसी मशीन के OpenClaw सेटअप में कॉन्फ़िगर किए गए प्रत्येक एजेंट को उस मशीन के कलेक्टर द्वारा कैप्चर किया जाता है — कोई प्रति-एजेंट सेटअप नहीं है। + +प्रत्येक OpenClaw सेशन एक AgentEye [session](/hi/agenteye/sessions) बन जाता है; इसके यूजर और असिस्टेंट संदेश, टूल कॉल, और टूल परिणाम मेल खाने वाले [events](/hi/agenteye/event-stream) बन जाते हैं। + +--- + +## इसे चालू करें + +कैप्चर तब तक बंद रहता है जब तक आप इसे सक्षम नहीं करते। `events:add` अनुमति वाली API कुंजी के साथ कलेक्टर इंस्टॉल करें ([API keys](/hi/agenteye/api-keys) देखें), और OpenClaw कैप्चर चालू करें: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --openclaw-enabled +``` + +यह कलेक्टर को इंस्टॉल करता है, इसे एक बैकग्राउंड सेवा के रूप में पंजीकृत करता है, और कैप्चरिंग शुरू करता है। पुष्टि करें कि यह चल रहा है: + +```bash +agenteye-collector health +``` + +एक ही मशीन पर एक से अधिक एजेंट कैप्चर कर रहे हैं? एक ही कमांड में प्रत्येक का फ्लैग जोड़ें — उदाहरण के लिए `--openclaw-enabled --codex-enabled`। + +पहली बार चलने पर, आपके मौजूदा OpenClaw सेशन एक बार बैकफिल किए जाते हैं और नई गतिविधि फिर सेकंड के भीतर स्ट्रीम होती है। OpenClaw की अपनी फाइलें केवल पढ़ी जाती हैं — कभी संशोधित, स्थानांतरित, या हटाई नहीं जाती — और प्रत्येक सेशन को बिल्कुल एक बार भेजा जाता है, यहां तक कि पुनरारंभ के दौरान भी। + +--- + +## यह कहाँ दिखाई देता है + +कैप्चर किए गए सेशन **Sessions** में दिखाई देते हैं, और उनके इवेंट **Events** स्ट्रीम में, किसी अन्य एजेंट की तरह जिसे आप देखते हैं — इसलिए [session replay](/hi/agenteye/sessions), [search](/hi/agenteye/queries), [evaluations](/hi/agenteye/evaluations), और [alerts](/hi/agenteye/alerts) सभी उन पर काम करते हैं। उन्हें अलग से देखने के लिए OpenClaw एजेंट द्वारा फ़िल्टर करें। + +--- + +## गोपनीयता + +OpenClaw ट्रांसक्रिप्ट में पूरा सेशन होता है — कमांड आउटपुट, फाइल सामग्री, और कुछ भी जो एजेंट ने पढ़ा या लिखा, सहित — और इसमें रहस्य हो सकते हैं। कैप्चर किए गए सेशन ऐसे ही भेजे जाते हैं, इसलिए केवल ऐसी मशीनों और टीमों के लिए कैप्चर सक्षम करें जहाँ उस सामग्री को AgentEye में केंद्रीकृत करना उपयुक्त है, और कलेक्टर को केवल `events:add` के लिए सीमांकित एक कुंजी दें। देखें [Security](/hi/agenteye/security) कि आपका डेटा कैसे अलग रखा जाता है। \ No newline at end of file diff --git a/docs/it/agenteye/codex-capture.mdx b/docs/it/agenteye/codex-capture.mdx index 81bf48a6..ae8b0a3a 100644 --- a/docs/it/agenteye/codex-capture.mdx +++ b/docs/it/agenteye/codex-capture.mdx @@ -1,54 +1,55 @@ --- +title: "Acquisizione sessioni Codex" +description: "Registra le sessioni locali di OpenAI Codex del tuo team in AgentEye come sessioni ed eventi ordinari — senza modificare come eseguono Codex." --- -title: "Acquisizione sessione Codex" -description: "Acquisisci le sessioni locali OpenAI Codex del tuo team in AgentEye come sessioni ed eventi ordinari — senza alcun cambiamento nel modo in cui eseguono Codex." ---- -I tuoi ingegneri eseguono già OpenAI Codex ogni giorno. L'acquisizione della sessione Codex porta quelle sessioni di codifica in AgentEye come sessioni ed eventi ordinari, così puoi cercarle, riprodurle e valutarle insieme a tutto il resto che osservi. Completa l'[SDK Python](/it/agenteye/python-sdk): l'SDK strumenta gli agenti che scrivi, mentre questo cattura il lavoro Codex che il tuo team già fa — senza alcun cambiamento nel modo in cui lo eseguono. +I tuoi ingegneri eseguono già OpenAI Codex ogni giorno. L'acquisizione sessioni Codex porta quelle sessioni di codifica in AgentEye come sessioni ed eventi ordinari, così puoi cercarle, riprodurle e valutarle insieme a tutto il resto che osservi. Completa l'[SDK Python](/it/agenteye/python-sdk): l'SDK strumenta gli agenti che scrivi, mentre questo acquisisce il lavoro Codex che il tuo team già svolge — senza alcuna modifica a come lo eseguono. + +Un piccolo raccoglitore in background legge i trascritti delle sessioni locali di Codex mentre vengono scritti e li invia ad AgentEye. Un raccoglitore per macchina acquisisce tutte le superfici Codex locali contemporaneamente — non è necessaria alcuna configurazione per superficie. -Un piccolo raccoglitore in background legge i transcript locali delle sessioni Codex mentre vengono scritti e li invia ad AgentEye. Un raccoglitore per macchina cattura ogni superficie Codex locale contemporaneamente — non è necessaria alcuna configurazione per superficie. +Lo stesso raccoglitore acquisisce anche altri agenti — vedi [OpenClaw](/it/agenteye/openclaw-capture) e [Hermes](/it/agenteye/hermes-capture). Abilita quelli che esegui; un singolo raccoglitore può acquisirne diversi contemporaneamente. --- ## Cosa acquisisce -Ogni superficie Codex che viene eseguita **localmente** produce gli stessi transcript di sessione su disco, e il raccoglitore li rileva tutti: +Ogni superficie Codex che viene eseguita **localmente** produce gli stessi trascritti di sessione su disco, e il raccoglitore li raccoglie tutti: -- la **CLI** Codex e `codex exec` +- il **CLI** di Codex e `codex exec` - l'**estensione VS Code / IDE** - l'**app desktop**, quando esegue una sessione localmente -Ogni sessione Codex diventa una [sessione](/it/agenteye/sessions) AgentEye; i suoi messaggi utente e assistente, il ragionamento, le chiamate di strumenti, i risultati degli strumenti e l'utilizzo dei token diventano i corrispondenti [eventi](/it/agenteye/event-stream). La superficie da cui proviene ogni sessione (CLI, IDE o desktop) viene registrata, così puoi distinguerle. +Ogni sessione Codex diventa una [sessione](/it/agenteye/sessions) di AgentEye; i suoi messaggi utente e assistente, il ragionamento, le chiamate ai tool, i risultati dei tool e l'utilizzo dei token diventano gli [eventi](/it/agenteye/event-stream) corrispondenti. Viene registrata la superficie da cui proviene ogni sessione (CLI, IDE o desktop), così puoi distinguerle. -> **Le sessioni cloud non vengono acquisite.** L'app desktop esegue sempre più sessioni nel cloud Codex e mantiene solo i loro metadati sulla macchina — non c'è alcun transcript locale da leggere. Solo le sessioni eseguite localmente vengono acquisite. +> **Le sessioni cloud non vengono acquisite.** L'app desktop esegue sempre più sessioni nel cloud Codex e mantiene solo i loro metadati sulla macchina — non c'è alcun trascritto locale da leggere. Solo le sessioni eseguite localmente vengono acquisite. --- -## Attivalo +## Attivala -L'acquisizione è disattivata finché non la abiliti. Installa il raccoglitore con una chiave API che ha il permesso `events:add` (vedi [Chiavi API](/it/agenteye/api-keys)), e attiva l'acquisizione Codex: +L'acquisizione è disattivata fino a quando non la abiliti. Installa il raccoglitore con una chiave API che dispone dell'autorizzazione `events:add` (vedi [Chiavi API](/it/agenteye/api-keys)) e attiva l'acquisizione Codex: ```bash curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ | sh -s -- --key --codex-enabled ``` -Questo installa il raccoglitore, lo registra come servizio in background e inizia l'acquisizione. Conferma che è in esecuzione: +Questo installa il raccoglitore, lo registra come servizio in background e avvia l'acquisizione. Conferma che è in esecuzione: ```bash agenteye-collector health ``` -Alla prima esecuzione, le tue sessioni Codex esistenti vengono ripopolate una volta e la nuova attività quindi viene trasmessa entro pochi secondi. I file di Codex vengono letti solamente — mai modificati, spostati o eliminati — e ogni sessione viene trasmessa esattamente una volta, anche tra i riavvii. +Al primo avvio, le tue sessioni Codex esistenti vengono acquisite una volta e la nuova attività viene trasmessa entro pochi secondi. I file di Codex vengono solo letti — mai modificati, spostati o eliminati — e ogni sessione viene inviata esattamente una volta, anche dopo i riavvii. --- ## Dove appare -Le sessioni acquisite appaiono in **Sessions**, e i loro eventi nel flusso **Events**, come qualsiasi altro agente che osservi — quindi la [riproduzione della sessione](/it/agenteye/sessions), la [ricerca](/it/agenteye/queries), le [valutazioni](/it/agenteye/evaluations) e gli [avvisi](/it/agenteye/alerts) funzionano tutti su di esse. Filtra per l'agente Codex per vederle da sole. +Le sessioni acquisite vengono visualizzate in **Sessions** e i loro eventi nel flusso **Events**, come qualsiasi altro agente che osservi — quindi la [riproduzione sessione](/it/agenteye/sessions), la [ricerca](/it/agenteye/queries), le [valutazioni](/it/agenteye/evaluations) e gli [avvisi](/it/agenteye/alerts) funzionano tutti su di esse. Filtra per l'agente Codex per vederle da sole. --- ## Privacy -I transcript Codex contengono la sessione completa — incluso l'output dei comandi, il contenuto dei file e qualsiasi cosa Codex abbia letto o scritto — e possono contenere segreti. Le sessioni acquisite vengono inviate così come sono, quindi abilita l'acquisizione solo su macchine e per team dove centralizzare quel contenuto in AgentEye è appropriato, e fornisci al raccoglitore una chiave limitata a `events:add` solamente. Vedi [Sicurezza](/it/agenteye/security) per come i tuoi dati vengono mantenuti isolati. \ No newline at end of file +I trascritti Codex contengono la sessione completa — incluso l'output dei comandi, i contenuti dei file e tutto ciò che Codex ha letto o scritto — e possono contenere segreti. Le sessioni acquisite vengono inviate così come sono, quindi abilita l'acquisizione solo su macchine e per team dove centralizzare quel contenuto in AgentEye è appropriato, e fornisci al raccoglitore una chiave limitata a `events:add` solamente. Vedi [Sicurezza](/it/agenteye/security) per scoprire come i tuoi dati vengono mantenuti isolati. \ No newline at end of file diff --git a/docs/it/agenteye/hermes-capture.mdx b/docs/it/agenteye/hermes-capture.mdx new file mode 100644 index 00000000..8eef3079 --- /dev/null +++ b/docs/it/agenteye/hermes-capture.mdx @@ -0,0 +1,53 @@ +--- +title: "Cattura sessioni Hermes" +description: "Porta le sessioni del gateway Hermes del tuo team — Slack, Telegram, CLI e esecuzioni programmate — in AgentEye come sessioni ed eventi ordinari." +--- + +[Hermes](https://hermes-agent.nousresearch.com) risponde al tuo team da qualunque posto lavori già — Slack, Telegram, la CLI, esecuzioni programmate. La cattura sessioni Hermes porta tutto in AgentEye come sessioni ed eventi ordinari, così l'assistente con cui il tuo team parla ogni giorno è osservabile quanto gli agenti che scrivi tu stesso. + +Un piccolo collector in background legge l'archivio sessioni locale di Hermes man mano che viene scritto e invia le sessioni ad AgentEye. Funziona nello stesso modo della cattura [Codex](/it/agenteye/codex-capture) e [OpenClaw](/it/agenteye/openclaw-capture), e un singolo collector può catturare diversi agenti contemporaneamente. + +--- + +## Cosa cattura + +Ogni sessione Hermes sulla macchina viene catturata, indipendentemente dal canale da cui proviene. Ognuna diventa una [sessione](/it/agenteye/sessions) di AgentEye; i messaggi utente e assistente, le chiamate agli strumenti e i risultati degli strumenti diventano gli [eventi](/it/agenteye/event-stream) corrispondenti. + +Il canale da cui è stata avviata una sessione — Slack, Telegram, CLI o un'esecuzione programmata — viene registrato nella sessione, così puoi distinguerli e filtrare uno alla volta. Insieme ad esso vengono il modello su cui è stata eseguita la sessione, la chat e la persona da cui è stata avviata, e, quando una sessione ha generato un'altra, il collegamento alla sessione genitore. + +Le sessioni appaiono non appena Hermes le avvia, indipendentemente dal fatto che sia stato detto qualcosa, e la risposta di un turno e le sue chiamate agli strumenti rimangono nell'ordine in cui sono effettivamente avvenute. Quando una sessione termina ricevi anche il motivo per cui è terminata, quanto è costata e quanti token ha utilizzato. + +--- + +## Attivalo + +La cattura è disattivata finché non la abiliti. Installa il collector con una chiave API che ha il permesso `events:add` (vedi [Chiavi API](/it/agenteye/api-keys)) e attiva la cattura Hermes: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --hermes-enabled +``` + +Questo installa il collector, lo registra come servizio in background e inizia la cattura. Conferma che è in esecuzione: + +```bash +agenteye-collector health +``` + +Stai catturando più di un agente sulla stessa macchina? Aggiungi il flag di ognuno allo stesso comando — ad esempio `--hermes-enabled --codex-enabled`. + +Al primo avvio, le sessioni Hermes esistenti vengono riempite una volta e la nuova attività viene quindi trasmessa entro pochi secondi. I dati di Hermes vengono solo letti — mai modificati o eliminati — e ogni messaggio viene inviato una sola volta, anche dopo i riavvi. + +`health` ti dice anche se tutto quello che il collector ha catturato è effettivamente arrivato ad AgentEye. Se un batch non potesse essere consegnato viene mantenuto e riprovato piuttosto che scartato, e il controllo segnala uno stato non sano mentre c'è ancora qualcosa in sospeso — quindi "sano" significa che i tuoi dati sono arrivati, non solo che il processo è in esecuzione. + +--- + +## Dove appare + +Le sessioni catturate appaiono in **Sessions** e i loro eventi nel flusso **Events**, come qualunque altro agente che osservi — quindi [session replay](/it/agenteye/sessions), [ricerca](/it/agenteye/queries), [valutazioni](/it/agenteye/evaluations) e [avvisi](/it/agenteye/alerts) funzionano tutti su di essi. Filtra per l'agente Hermes per vederli da soli. + +--- + +## Privacy + +Le sessioni Hermes contengono la trascrizione completa — incluso l'output dei comandi, il contenuto dei file e qualunque cosa l'agente abbia letto o scritto — e possono contenere segreti. Le sessioni catturate vengono inviate così come sono, quindi abilita la cattura solo dove centralizzare quel contenuto in AgentEye è appropriato, e fornisci al collector una chiave limitata a `events:add` solamente. Vedi [Security](/it/agenteye/security) per come i tuoi dati vengono mantenuti isolati. \ No newline at end of file diff --git a/docs/it/agenteye/openclaw-capture.mdx b/docs/it/agenteye/openclaw-capture.mdx new file mode 100644 index 00000000..f98d051a --- /dev/null +++ b/docs/it/agenteye/openclaw-capture.mdx @@ -0,0 +1,49 @@ +--- +title: "Acquisizione di sessioni OpenClaw" +description: "Raccogli le sessioni OpenClaw locali del tuo team in AgentEye come sessioni ed eventi ordinari — senza alcuna modifica al modo in cui OpenClaw funziona." +--- + +Se il tuo team utilizza [OpenClaw](https://docs.openclaw.ai), l'acquisizione di sessioni OpenClaw porta quelle sessioni in AgentEye come sessioni ed eventi ordinari, permettendoti di cercarle, riprodurle e valutarle insieme a tutto il resto che osservi. Completa l'[SDK Python](/it/agenteye/python-sdk): l'SDK strumenta gli agent che scrivi, mentre questa funzione cattura il lavoro OpenClaw che il tuo team già svolge — senza alcuna modifica al modo in cui lo eseguono. + +Un piccolo raccoglitore in background legge i transcript delle sessioni locali di OpenClaw mentre vengono scritti e li invia a AgentEye. Funziona allo stesso modo di [Codex capture](/it/agenteye/codex-capture), e un raccoglitore può catturare entrambi contemporaneamente. + +--- + +## Cosa viene catturato + +Ogni agent configurato nella configurazione OpenClaw di una macchina viene catturato dal raccoglitore di quella macchina — non c'è configurazione per singolo agent. + +Ogni sessione OpenClaw diventa una [sessione](/it/agenteye/sessions) di AgentEye; i suoi messaggi utente e assistente, le chiamate agli strumenti e i risultati degli strumenti diventano i corrispondenti [eventi](/it/agenteye/event-stream). + +--- + +## Attivalo + +L'acquisizione è disattivata fino a quando non la abiliti. Installa il raccoglitore con una chiave API che abbia il permesso `events:add` (vedi [Chiavi API](/it/agenteye/api-keys)), e attiva l'acquisizione OpenClaw: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --openclaw-enabled +``` + +Questo installa il raccoglitore, lo registra come servizio in background e avvia l'acquisizione. Verifica che sia in esecuzione: + +```bash +agenteye-collector health +``` + +Stai catturando più di un agent sulla stessa macchina? Aggiungi il flag di ciascuno allo stesso comando — ad esempio `--openclaw-enabled --codex-enabled`. + +Al primo esecuzione, le tue sessioni OpenClaw esistenti vengono ripopolate una volta e la nuova attività viene trasmessa entro pochi secondi. I file di OpenClaw stesso vengono solo letti — mai modificati, spostati o eliminati — e ogni sessione viene inviata esattamente una volta, anche tra i riavvii. + +--- + +## Dove appare + +Le sessioni catturate appaiono in **Sessions** e i loro eventi nello stream **Events**, come qualsiasi altro agent che osservi — quindi la [riproduzione delle sessioni](/it/agenteye/sessions), la [ricerca](/it/agenteye/queries), le [valutazioni](/it/agenteye/evaluations) e gli [avvisi](/it/agenteye/alerts) funzionano tutti su di essi. Filtra per l'agent OpenClaw per vederli isolatamente. + +--- + +## Privacy + +I transcript OpenClaw contengono la sessione completa — compreso l'output dei comandi, i contenuti dei file e qualsiasi cosa l'agent abbia letto o scritto — e possono contenere segreti. Le sessioni catturate vengono spedite così come sono, quindi abilita l'acquisizione solo su macchine e per team dove centralizzare quel contenuto in AgentEye è appropriato, e fornisci al raccoglitore una chiave limitata a `events:add` solo. Vedi [Security](/it/agenteye/security) per come i tuoi dati vengono mantenuti isolati. \ No newline at end of file diff --git a/docs/ja/agenteye/codex-capture.mdx b/docs/ja/agenteye/codex-capture.mdx index a83a20f7..eafeca6a 100644 --- a/docs/ja/agenteye/codex-capture.mdx +++ b/docs/ja/agenteye/codex-capture.mdx @@ -1,53 +1,55 @@ --- title: "Codexセッションキャプチャ" -description: "チームのローカルOpenAI CodexセッションをAgentEyeに通常のセッションおよびイベントとして取り込めます。Codexの使い方を変える必要はありません。" +description: "チームのローカルOpenAI Codexセッションを通常のセッションとイベントとしてAgentEyeに取り込みます — Codexの実行方法を変更することなく。" --- -エンジニアはすでに毎日OpenAI Codexを使っています。Codexセッションキャプチャは、それらのコーディングセッションをAgentEyeの通常のセッションおよびイベントとして取り込み、他のすべての観測データと並べて検索・再生・評価できるようにします。これは[Python SDK](/ja/agenteye/python-sdk)を補完する機能です。SDKは自分で書いたエージェントを計装するのに対し、このキャプチャ機能はチームがすでに行っているCodexの作業を—使い方を変えることなく—取り込みます。 +エンジニアはすでに毎日OpenAI Codexを使用しています。Codexセッションキャプチャは、それらのコーディングセッションを通常のセッションとイベントとしてAgentEyeに取り込み、他のすべての観測対象と並べて検索・再生・評価できるようにします。[Python SDK](/ja/agenteye/python-sdk)を補完する機能です。SDKは自分で作成したエージェントを計装するのに対し、こちらはチームがすでに行っているCodexの作業を、実行方法を一切変えることなくキャプチャします。 -小さなバックグラウンドコレクターが、Codexのローカルセッショントランスクリプトが書き込まれる都度読み取り、AgentEyeに送信します。1台のマシンにコレクターを1つ導入するだけで、そのマシン上のすべてのローカルCodexサーフェスを一括してキャプチャできます。サーフェスごとのセットアップは不要です。 +小さなバックグラウンドコレクターが、Codexのローカルセッショントランスクリプトが書き込まれる際にそれを読み取り、AgentEyeに送信します。1台のマシンにつき1つのコレクターで、すべてのローカルCodexサーフェスを一括してキャプチャします — サーフェスごとのセットアップは不要です。 + +同じコレクターは他のエージェントもキャプチャします — [OpenClaw](/ja/agenteye/openclaw-capture)や[Hermes](/ja/agenteye/hermes-capture)も参照してください。使用しているものをそれぞれ有効化してください。1つのコレクターで複数を同時にキャプチャできます。 --- ## キャプチャされる内容 -**ローカル**で実行されるすべてのCodexサーフェスは同じ形式のオンディスクセッショントランスクリプトを生成し、コレクターはそれらすべてを取り込みます。 +**ローカル**で実行されるすべてのCodexサーフェスは同じオンディスクセッショントランスクリプトを生成し、コレクターがそれらをすべて取得します： -- Codex **CLI** および `codex exec` +- Codex **CLI**および`codex exec` - **VS Code / IDE拡張機能** -- **デスクトップアプリ**（セッションをローカルで実行している場合） +- **デスクトップアプリ**（ローカルでセッションを実行する場合） -各CodexセッションはAgentEyeの[セッション](/ja/agenteye/sessions)になり、ユーザーとアシスタントのメッセージ、推論、ツール呼び出し、ツール結果、トークン使用量が対応する[イベント](/ja/agenteye/event-stream)になります。各セッションの発生元（CLI、IDE、またはデスクトップ）も記録されるため、区別することができます。 +各CodexセッションはAgentEyeの[セッション](/ja/agenteye/sessions)になります。ユーザーとアシスタントのメッセージ、推論、ツール呼び出し、ツール結果、トークン使用量が対応する[イベント](/ja/agenteye/event-stream)になります。各セッションの発生元サーフェス（CLI、IDE、またはデスクトップ）も記録されるため、区別することができます。 -> **クラウドセッションはキャプチャされません。** デスクトップアプリはセッションをCodexクラウドで実行することが増えており、マシンにはメタデータのみが保持されます。ローカルに読み取れるトランスクリプトがないため、ローカルで実行されたセッションのみがキャプチャ対象となります。 +> **クラウドセッションはキャプチャされません。** デスクトップアプリはセッションをCodexクラウドで実行することが増えており、マシン上にはメタデータのみが保持されます — ローカルに読み取れるトランスクリプトが存在しません。ローカルで実行されたセッションのみがキャプチャされます。 --- -## 有効化の手順 +## 有効化する方法 -キャプチャは、明示的に有効化するまで無効です。`events:add` 権限を持つAPIキーを使ってコレクターをインストールし（[APIキー](/ja/agenteye/api-keys)を参照）、Codexキャプチャを有効にします。 +キャプチャは有効化するまでオフになっています。`events:add`権限を持つAPIキーでコレクターをインストールし（[APIキー](/ja/agenteye/api-keys)を参照）、Codexキャプチャを有効化します： ```bash curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ | sh -s -- --key --codex-enabled ``` -これによりコレクターがインストールされ、バックグラウンドサービスとして登録され、キャプチャが開始されます。動作確認は次のコマンドで行えます。 +これにより、コレクターがインストールされ、バックグラウンドサービスとして登録され、キャプチャが開始されます。実行中であることを確認します： ```bash agenteye-collector health ``` -初回実行時には、既存のCodexセッションが一度バックフィルされ、それ以降の新しいアクティビティは数秒以内にストリーミングされます。Codexのファイルは読み取り専用で扱われ、変更・移動・削除は一切行われません。また、各セッションは再起動をまたいでも正確に1回だけ送信されます。 +初回実行時に既存のCodexセッションが一度バックフィルされ、その後の新しいアクティビティは数秒以内にストリーミングされます。Codexのファイルは読み取られるのみで、変更・移動・削除されることはありません。また、再起動をまたいでも各セッションは正確に1回だけ送信されます。 --- -## 表示場所 +## 表示される場所 -キャプチャされたセッションは**Sessions**に表示され、そのイベントは**Events**ストリームに表示されます。これは他のエージェントと同様です。そのため、[セッションリプレイ](/ja/agenteye/sessions)、[検索](/ja/agenteye/queries)、[評価](/ja/agenteye/evaluations)、[アラート](/ja/agenteye/alerts)もすべて利用できます。Codexエージェントでフィルタリングすると、そのセッションのみを表示できます。 +キャプチャされたセッションは**Sessions**に表示され、そのイベントは**Events**ストリームに表示されます。他の観測対象エージェントと同様に扱われるため、[セッション再生](/ja/agenteye/sessions)、[検索](/ja/agenteye/queries)、[評価](/ja/agenteye/evaluations)、[アラート](/ja/agenteye/alerts)もすべて利用できます。Codexエージェントでフィルタリングすると、そのセッションだけを表示できます。 --- ## プライバシー -Codexのトランスクリプトにはセッション全体が含まれており、コマンド出力、ファイルの内容、Codexが読み書きしたあらゆる情報が記録されます。機密情報が含まれる可能性もあります。キャプチャされたセッションはそのまま送信されるため、AgentEyeにその内容を集約することが適切なマシンおよびチームに限り、キャプチャを有効にしてください。また、コレクターには `events:add` のみにスコープを絞ったキーを使用してください。データがどのように分離・保護されるかについては、[セキュリティ](/ja/agenteye/security)を参照してください。 \ No newline at end of file +Codexのトランスクリプトには、コマンド出力、ファイルの内容、Codexが読み書きしたすべての内容を含む完全なセッションデータが含まれており、シークレット情報が含まれる場合があります。キャプチャされたセッションはそのまま送信されるため、AgentEyeにそのコンテンツを集約することが適切なマシンおよびチームに限定してキャプチャを有効化してください。また、コレクターには`events:add`のみにスコープを絞ったキーを付与してください。データの隔離方法については[セキュリティ](/ja/agenteye/security)を参照してください。 \ No newline at end of file diff --git a/docs/ja/agenteye/hermes-capture.mdx b/docs/ja/agenteye/hermes-capture.mdx new file mode 100644 index 00000000..9b7f3f00 --- /dev/null +++ b/docs/ja/agenteye/hermes-capture.mdx @@ -0,0 +1,53 @@ +--- +title: "Hermesセッションキャプチャ" +description: "チームのHermesゲートウェイセッション（Slack、Telegram、CLI、スケジュール実行）をAgentEyeに通常のセッションおよびイベントとして取り込みます。" +--- + +[Hermes](https://hermes-agent.nousresearch.com)は、チームがすでに使っている場所（Slack、Telegram、CLI、スケジュール実行）からの問い合わせに答えます。HermesセッションキャプチャはそれらすべてをAgentEyeに通常のセッションおよびイベントとして取り込むため、チームが毎日使っているアシスタントも、自分で書いたエージェントと同じように監視できます。 + +小さなバックグラウンドコレクターが、Hermesのローカルセッションストアへの書き込みをリアルタイムで読み取り、セッションをAgentEyeに送信します。[Codex](/ja/agenteye/codex-capture)や[OpenClaw](/ja/agenteye/openclaw-capture)のキャプチャと同じ仕組みで動作し、1つのコレクターで複数を同時にキャプチャすることもできます。 + +--- + +## キャプチャされる内容 + +どのチャネルから来たものかを問わず、マシン上のすべてのHermesセッションがキャプチャされます。各セッションはAgentEyeの[セッション](/ja/agenteye/sessions)になり、ユーザーおよびアシスタントのメッセージ、ツール呼び出し、ツールの結果が対応する[イベント](/ja/agenteye/event-stream)になります。 + +セッションが開始されたチャネル（Slack、Telegram、CLI、スケジュール実行）はセッションに記録されるため、区別したり、特定のチャネルだけに絞って表示したりできます。あわせて、そのセッションで使用されたモデル、開始元のチャットや人物、そして別のセッションから生成された場合は親セッションへのリンクも記録されます。 + +セッションは、まだ何もやり取りが行われていない段階でもHermesが開始した時点で表示されます。また、1ターンの返答とそのツール呼び出しは、実際に発生した順序で記録されます。セッションが終了すると、終了理由、コスト、使用トークン数も取得できます。 + +--- + +## 有効にする方法 + +キャプチャは有効化するまで無効です。`events:add`権限を持つAPIキー（[APIキー](/ja/agenteye/api-keys)を参照）を使用してコレクターをインストールし、Hermesキャプチャを有効にします。 + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --hermes-enabled +``` + +これによりコレクターがインストールされ、バックグラウンドサービスとして登録され、キャプチャが開始されます。動作を確認するには次を実行してください。 + +```bash +agenteye-collector health +``` + +同じマシンで複数のエージェントをキャプチャしますか？それぞれのフラグを同じコマンドに追加してください。例えば `--hermes-enabled --codex-enabled` のように指定します。 + +初回実行時は、既存のHermesセッションが一括で取り込まれ、以降の新しいアクティビティは数秒以内にストリーミングされます。Hermesのデータは読み取られるだけで、変更や削除は一切行われません。また、各メッセージは再起動をまたいでも1回だけ送信されます。 + +`health`コマンドは、コレクターがキャプチャしたすべての内容が実際にAgentEyeに届いたかどうかも確認できます。バッチの送信に失敗した場合は破棄されず保持され、再試行されます。未送信のものが残っている間は異常（unhealthy）と報告されます。つまり「正常（healthy）」は、プロセスが生きているだけでなく、データが届いたことを意味します。 + +--- + +## 表示される場所 + +キャプチャされたセッションは**Sessions**に表示され、そのイベントは**Events**ストリームに表示されます。これは他のエージェントと同様です。そのため、[セッションリプレイ](/ja/agenteye/sessions)、[検索](/ja/agenteye/queries)、[評価](/ja/agenteye/evaluations)、[アラート](/ja/agenteye/alerts)がすべて利用できます。Hermesエージェントでフィルタリングすると、そのセッションだけを表示できます。 + +--- + +## プライバシー + +Hermesセッションには、コマンドの出力、ファイルの内容、エージェントが読み書きしたものを含む完全なトランスクリプトが含まれており、シークレット情報が含まれることもあります。キャプチャされたセッションはそのまま送信されるため、AgentEyeにその内容を集約することが適切な環境でのみキャプチャを有効にしてください。また、コレクターには`events:add`のみにスコープを絞ったキーを付与してください。データがどのように分離して保管されるかについては、[セキュリティ](/ja/agenteye/security)を参照してください。 \ No newline at end of file diff --git a/docs/ja/agenteye/openclaw-capture.mdx b/docs/ja/agenteye/openclaw-capture.mdx new file mode 100644 index 00000000..c87b4832 --- /dev/null +++ b/docs/ja/agenteye/openclaw-capture.mdx @@ -0,0 +1,49 @@ +--- +title: "OpenClaw セッションキャプチャ" +description: "チームのローカル OpenClaw セッションを通常のセッションおよびイベントとして AgentEye に取り込みます — OpenClaw の実行方法は一切変更不要です。" +--- + +チームが [OpenClaw](https://docs.openclaw.ai) を利用している場合、OpenClaw セッションキャプチャを使うと、それらのセッションを通常のセッションおよびイベントとして AgentEye に取り込めます。これにより、他のエージェントの観測結果と並べて検索・再生・評価が行えます。[Python SDK](/ja/agenteye/python-sdk) と組み合わせて使うことを想定しており、SDK が自作エージェントを計装するのに対し、こちらはチームがすでに行っている OpenClaw の作業を — 実行方法を一切変えることなく — キャプチャします。 + +小さなバックグラウンドコレクターが、OpenClaw のローカルセッショントランスクリプトを書き込まれるたびに読み取り、AgentEye に送信します。動作の仕組みは [Codex キャプチャ](/ja/agenteye/codex-capture) と同じで、1 つのコレクターで両方を同時にキャプチャできます。 + +--- + +## キャプチャされる内容 + +マシンの OpenClaw セットアップで設定されているすべてのエージェントが、そのマシンのコレクターによってキャプチャされます — エージェントごとのセットアップは不要です。 + +各 OpenClaw セッションは AgentEye の [セッション](/ja/agenteye/sessions) になり、ユーザーおよびアシスタントのメッセージ、ツール呼び出し、ツールの結果が対応する [イベント](/ja/agenteye/event-stream) になります。 + +--- + +## 有効にする + +キャプチャは有効にするまでオフのままです。`events:add` 権限を持つ API キー（[API キー](/ja/agenteye/api-keys) を参照）を使ってコレクターをインストールし、OpenClaw キャプチャをオンにします。 + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --openclaw-enabled +``` + +これでコレクターがインストールされ、バックグラウンドサービスとして登録され、キャプチャが開始されます。正常に動作しているか確認するには： + +```bash +agenteye-collector health +``` + +同じマシンで複数のエージェントをキャプチャする場合は、それぞれのフラグを同じコマンドに追加してください — 例：`--openclaw-enabled --codex-enabled`。 + +初回実行時、既存の OpenClaw セッションが一度バックフィルされ、以降の新しいアクティビティは数秒以内にストリームされます。OpenClaw 自身のファイルは読み取り専用であり、変更・移動・削除されることはありません。また、再起動をまたいでも各セッションはちょうど一度だけ送信されます。 + +--- + +## 表示される場所 + +キャプチャされたセッションは **Sessions** に表示され、そのイベントは **Events** ストリームに表示されます — 他のエージェントの観測結果と同様です。そのため、[セッション再生](/ja/agenteye/sessions)、[検索](/ja/agenteye/queries)、[評価](/ja/agenteye/evaluations)、[アラート](/ja/agenteye/alerts) もすべて利用できます。OpenClaw エージェントでフィルタリングすると、そのセッションのみを表示できます。 + +--- + +## プライバシー + +OpenClaw のトランスクリプトにはセッションの全内容が含まれます — コマンドの出力、ファイルの内容、エージェントが読み書きしたすべての情報が含まれており、シークレットが含まれることもあります。キャプチャされたセッションはそのまま送信されるため、AgentEye にコンテンツを集約することが適切なマシンおよびチームに対してのみキャプチャを有効にしてください。また、コレクターには `events:add` のみにスコープされたキーを付与してください。データがどのように分離して保持されるかについては、[セキュリティ](/ja/agenteye/security) を参照してください。 \ No newline at end of file diff --git a/docs/ko/agenteye/codex-capture.mdx b/docs/ko/agenteye/codex-capture.mdx index d3df2f3d..6dec3fbf 100644 --- a/docs/ko/agenteye/codex-capture.mdx +++ b/docs/ko/agenteye/codex-capture.mdx @@ -1,53 +1,55 @@ --- title: "Codex 세션 캡처" -description: "팀원들의 로컬 OpenAI Codex 세션을 AgentEye에 일반 세션 및 이벤트로 수집합니다 — Codex 사용 방식을 변경할 필요가 없습니다." +description: "팀의 로컬 OpenAI Codex 세션을 일반 세션 및 이벤트로 AgentEye에 수집합니다 — Codex 실행 방식은 전혀 변경되지 않습니다." --- -엔지니어들은 이미 매일 OpenAI Codex를 사용하고 있습니다. Codex 세션 캡처는 그 코딩 세션들을 AgentEye에 일반 세션 및 이벤트로 가져와서, 다른 모든 관찰 데이터와 함께 검색하고, 재생하고, 평가할 수 있게 해줍니다. 이 기능은 [Python SDK](/ko/agenteye/python-sdk)를 보완합니다. SDK는 직접 작성한 에이전트를 계측하는 반면, Codex 세션 캡처는 팀이 이미 사용 중인 Codex 작업을 — 사용 방식을 변경하지 않고 — 수집합니다. +엔지니어들은 이미 매일 OpenAI Codex를 사용하고 있습니다. Codex 세션 캡처는 이러한 코딩 세션을 AgentEye에 일반 세션 및 이벤트로 가져와, 다른 모든 관찰 대상과 함께 검색하고, 재생하며, 평가할 수 있게 해줍니다. 이 기능은 [Python SDK](/ko/agenteye/python-sdk)를 보완합니다. SDK는 직접 작성한 에이전트를 계측하는 반면, 이 기능은 팀이 이미 사용 중인 Codex 작업을 — 실행 방식의 변경 없이 — 캡처합니다. -소형 백그라운드 수집기가 Codex의 로컬 세션 트랜스크립트를 작성되는 즉시 읽어 AgentEye로 전송합니다. 머신 한 대당 수집기 하나로 모든 로컬 Codex 환경을 동시에 캡처하며 — 환경별 별도 설정이 필요하지 않습니다. +소형 백그라운드 수집기가 Codex의 로컬 세션 트랜스크립트를 작성되는 즉시 읽어 AgentEye로 전송합니다. 머신당 하나의 수집기로 모든 로컬 Codex 인터페이스를 한 번에 캡처할 수 있어 인터페이스별 별도 설정이 필요하지 않습니다. + +동일한 수집기가 다른 에이전트도 캡처합니다 — [OpenClaw](/ko/agenteye/openclaw-capture) 및 [Hermes](/ko/agenteye/hermes-capture)를 참조하세요. 사용 중인 각 에이전트를 활성화하면 하나의 수집기로 여러 에이전트를 동시에 캡처할 수 있습니다. --- ## 캡처 대상 -**로컬**에서 실행되는 모든 Codex 환경은 동일한 디스크 내 세션 트랜스크립트를 생성하며, 수집기가 이를 모두 수집합니다: +**로컬**에서 실행되는 모든 Codex 인터페이스는 동일한 온디스크 세션 트랜스크립트를 생성하며, 수집기가 이를 모두 수집합니다: - Codex **CLI** 및 `codex exec` - **VS Code / IDE 확장** -- 로컬에서 세션을 실행하는 경우의 **데스크톱 앱** +- **데스크톱 앱** (로컬에서 세션을 실행하는 경우) -각 Codex 세션은 AgentEye [세션](/ko/agenteye/sessions)이 되고, 사용자 및 어시스턴트 메시지, 추론, 도구 호출, 도구 결과, 토큰 사용량은 해당 [이벤트](/ko/agenteye/event-stream)가 됩니다. 각 세션이 어느 환경(CLI, IDE, 데스크톱)에서 시작되었는지 기록되므로 구분할 수 있습니다. +각 Codex 세션은 AgentEye [세션](/ko/agenteye/sessions)이 되며, 사용자 및 어시스턴트 메시지, 추론, 도구 호출, 도구 결과, 토큰 사용량이 대응하는 [이벤트](/ko/agenteye/event-stream)가 됩니다. 각 세션의 출처(CLI, IDE 또는 데스크톱)도 기록되어 구분할 수 있습니다. -> **클라우드 세션은 캡처되지 않습니다.** 데스크톱 앱은 점점 더 많은 세션을 Codex 클라우드에서 실행하고 머신에는 메타데이터만 보관하므로 — 읽을 수 있는 로컬 트랜스크립트가 없습니다. 로컬에서 실행된 세션만 캡처됩니다. +> **클라우드 세션은 캡처되지 않습니다.** 데스크톱 앱은 점점 더 많은 세션을 Codex 클라우드에서 실행하고 메타데이터만 로컬에 보관하므로 읽을 수 있는 로컬 트랜스크립트가 존재하지 않습니다. 로컬에서 실행된 세션만 캡처됩니다. --- ## 활성화 방법 -캡처는 활성화하기 전까지 비활성 상태입니다. `events:add` 권한이 있는 API 키([API 키](/ko/agenteye/api-keys) 참조)로 수집기를 설치하고 Codex 캡처를 활성화합니다: +캡처는 활성화하기 전까지 비활성 상태입니다. `events:add` 권한이 있는 API 키로 수집기를 설치하고([API keys](/ko/agenteye/api-keys) 참조), Codex 캡처를 활성화하세요: ```bash curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ | sh -s -- --key --codex-enabled ``` -이 명령은 수집기를 설치하고 백그라운드 서비스로 등록한 후 캡처를 시작합니다. 실행 중인지 확인하려면: +이 명령은 수집기를 설치하고, 백그라운드 서비스로 등록하며, 캡처를 시작합니다. 실행 중인지 확인하세요: ```bash agenteye-collector health ``` -최초 실행 시 기존 Codex 세션이 한 번 백필되며, 이후 새로운 활동은 몇 초 내에 스트리밍됩니다. Codex의 파일은 읽기만 할 뿐 — 수정, 이동, 삭제되지 않으며 — 각 세션은 재시작 후에도 정확히 한 번만 전송됩니다. +최초 실행 시 기존 Codex 세션이 한 번 백필되며, 이후 새로운 활동은 수 초 내에 스트리밍됩니다. Codex의 파일은 읽기만 할 뿐 — 수정, 이동, 삭제되지 않으며 — 재시작이 발생하더라도 각 세션은 정확히 한 번만 전송됩니다. --- ## 확인 위치 -캡처된 세션은 **Sessions**에 표시되고, 이벤트는 **Events** 스트림에 표시됩니다. 다른 에이전트 관찰 데이터와 동일하게 처리되므로 [세션 재생](/ko/agenteye/sessions), [검색](/ko/agenteye/queries), [평가](/ko/agenteye/evaluations), [알림](/ko/agenteye/alerts) 기능 모두 사용할 수 있습니다. Codex 에이전트로 필터링하면 해당 세션만 따로 볼 수 있습니다. +캡처된 세션은 **Sessions**에, 해당 이벤트는 **Events** 스트림에 표시됩니다. 다른 에이전트와 동일하게 [세션 재생](/ko/agenteye/sessions), [검색](/ko/agenteye/queries), [평가](/ko/agenteye/evaluations), [알림](/ko/agenteye/alerts)이 모두 적용됩니다. Codex 에이전트로 필터링하면 해당 세션만 별도로 볼 수 있습니다. --- ## 개인정보 보호 -Codex 트랜스크립트에는 명령 출력, 파일 내용, Codex가 읽거나 쓴 모든 내용을 포함한 전체 세션이 담겨 있으며, 비밀 정보가 포함될 수 있습니다. 캡처된 세션은 있는 그대로 전송되므로, 해당 콘텐츠를 AgentEye에 중앙화하는 것이 적절한 머신과 팀에 한해서만 캡처를 활성화하고, 수집기에는 `events:add` 권한만 부여된 키를 사용하세요. 데이터 격리 방법에 대해서는 [보안](/ko/agenteye/security)을 참조하세요. \ No newline at end of file +Codex 트랜스크립트에는 명령 출력, 파일 내용, Codex가 읽거나 쓴 모든 내용을 포함한 전체 세션이 담겨 있으며, 시크릿 정보가 포함될 수 있습니다. 캡처된 세션은 있는 그대로 전송되므로, AgentEye에 해당 콘텐츠를 중앙 집중화하는 것이 적절한 머신과 팀에서만 캡처를 활성화하고, 수집기에는 `events:add`만으로 범위가 제한된 키를 사용하세요. 데이터 격리 방법에 대한 자세한 내용은 [보안](/ko/agenteye/security)을 참조하세요. \ No newline at end of file diff --git a/docs/ko/agenteye/hermes-capture.mdx b/docs/ko/agenteye/hermes-capture.mdx new file mode 100644 index 00000000..7eb83f9b --- /dev/null +++ b/docs/ko/agenteye/hermes-capture.mdx @@ -0,0 +1,53 @@ +--- +title: "Hermes 세션 캡처" +description: "팀의 Hermes 게이트웨이 세션(Slack, Telegram, CLI, 예약 실행)을 일반 세션 및 이벤트로 AgentEye에 가져옵니다." +--- + +[Hermes](https://hermes-agent.nousresearch.com)는 팀이 이미 사용하는 어느 채널에서든 — Slack, Telegram, CLI, 예약 실행 — 질문에 답합니다. Hermes 세션 캡처는 이 모든 활동을 AgentEye의 일반 세션 및 이벤트로 가져오므로, 팀이 매일 대화하는 어시스턴트를 직접 작성한 에이전트만큼 투명하게 관찰할 수 있습니다. + +소형 백그라운드 수집기가 Hermes의 로컬 세션 저장소를 기록되는 즉시 읽어 AgentEye로 전송합니다. [Codex](/ko/agenteye/codex-capture) 및 [OpenClaw](/ko/agenteye/openclaw-capture) 캡처와 동일한 방식으로 작동하며, 하나의 수집기로 여러 에이전트를 동시에 캡처할 수 있습니다. + +--- + +## 캡처되는 내용 + +채널에 관계없이 해당 머신의 모든 Hermes 세션이 캡처됩니다. 각 세션은 AgentEye [세션](/ko/agenteye/sessions)으로 생성되며, 사용자 및 어시스턴트 메시지, 도구 호출, 도구 결과는 해당 [이벤트](/ko/agenteye/event-stream)로 변환됩니다. + +세션이 시작된 채널(Slack, Telegram, CLI, 예약 실행)은 세션에 기록되므로 구분하고 원하는 채널만 필터링할 수 있습니다. 함께 기록되는 정보로는 세션이 실행된 모델, 세션이 시작된 채팅 및 사용자, 그리고 세션이 다른 세션을 생성한 경우 상위 세션에 대한 링크가 포함됩니다. + +세션은 Hermes가 시작하는 즉시 표시되며, 아직 대화가 없어도 마찬가지입니다. 한 턴의 응답과 도구 호출은 실제 발생 순서대로 유지됩니다. 세션이 종료되면 종료 이유, 비용, 사용된 토큰 수도 함께 확인할 수 있습니다. + +--- + +## 활성화 방법 + +캡처는 기본적으로 비활성화되어 있습니다. `events:add` 권한이 있는 API 키([API 키](/ko/agenteye/api-keys) 참조)로 수집기를 설치하고 Hermes 캡처를 활성화합니다. + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --hermes-enabled +``` + +이 명령은 수집기를 설치하고 백그라운드 서비스로 등록한 뒤 캡처를 시작합니다. 정상 실행 여부를 확인하려면: + +```bash +agenteye-collector health +``` + +같은 머신에서 여러 에이전트를 캡처하는 경우, 동일한 명령에 각 에이전트의 플래그를 추가하면 됩니다. 예: `--hermes-enabled --codex-enabled` + +첫 실행 시 기존 Hermes 세션이 한 번 백필되고, 이후 새 활동은 몇 초 내에 스트리밍됩니다. Hermes의 데이터는 읽기만 하며 절대 수정하거나 삭제하지 않습니다. 재시작 여부와 관계없이 각 메시지는 한 번만 전송됩니다. + +`health` 명령은 수집기가 캡처한 데이터가 실제로 AgentEye에 도달했는지도 알려줍니다. 배치 전송에 실패한 경우 폐기하지 않고 보관했다가 재시도하며, 미전송 데이터가 남아 있는 동안은 비정상 상태로 표시됩니다. 따라서 "정상"은 단순히 프로세스가 살아있다는 뜻이 아니라 데이터가 실제로 도달했다는 의미입니다. + +--- + +## 확인 위치 + +캡처된 세션은 **Sessions**에, 이벤트는 **Events** 스트림에 표시되며, 다른 에이전트와 동일하게 처리됩니다. [세션 리플레이](/ko/agenteye/sessions), [검색](/ko/agenteye/queries), [평가](/ko/agenteye/evaluations), [알림](/ko/agenteye/alerts) 기능을 모두 사용할 수 있습니다. Hermes 에이전트로 필터링하면 해당 세션만 볼 수 있습니다. + +--- + +## 개인정보 보호 + +Hermes 세션에는 전체 대화 내용(명령 출력, 파일 내용, 에이전트가 읽거나 작성한 모든 내용)이 포함되며 민감한 정보가 담길 수 있습니다. 캡처된 세션은 있는 그대로 전송되므로, AgentEye에 해당 내용을 중앙화하는 것이 적절한 환경에서만 캡처를 활성화하고, 수집기에는 `events:add` 범위만 가진 키를 제공하세요. 데이터 격리 방식에 대한 자세한 내용은 [보안](/ko/agenteye/security)을 참조하세요. \ No newline at end of file diff --git a/docs/ko/agenteye/openclaw-capture.mdx b/docs/ko/agenteye/openclaw-capture.mdx new file mode 100644 index 00000000..19e39538 --- /dev/null +++ b/docs/ko/agenteye/openclaw-capture.mdx @@ -0,0 +1,49 @@ +--- +title: "OpenClaw 세션 캡처" +description: "팀의 로컬 OpenClaw 세션을 AgentEye로 가져와 일반 세션 및 이벤트로 활용하세요 — OpenClaw 실행 방식은 그대로 유지됩니다." +--- + +팀이 [OpenClaw](https://docs.openclaw.ai)를 사용하고 있다면, OpenClaw 세션 캡처를 통해 해당 세션을 AgentEye의 일반 세션 및 이벤트로 가져올 수 있습니다. 이를 통해 다른 모든 관측 데이터와 함께 검색, 재생, 평가가 가능합니다. 이 기능은 [Python SDK](/ko/agenteye/python-sdk)를 보완합니다. SDK는 직접 작성한 에이전트를 계측하는 반면, 이 기능은 팀이 이미 사용 중인 OpenClaw 작업을 캡처합니다 — 실행 방식을 변경할 필요가 없습니다. + +소형 백그라운드 수집기가 OpenClaw의 로컬 세션 트랜스크립트를 작성되는 즉시 읽어 AgentEye로 전송합니다. [Codex 캡처](/ko/agenteye/codex-capture)와 동일한 방식으로 동작하며, 하나의 수집기로 두 가지를 동시에 캡처할 수 있습니다. + +--- + +## 캡처 대상 + +머신의 OpenClaw 설정에 구성된 모든 에이전트는 해당 머신의 수집기에 의해 캡처됩니다 — 에이전트별 별도 설정은 필요하지 않습니다. + +각 OpenClaw 세션은 AgentEye [세션](/ko/agenteye/sessions)으로 변환되며, 사용자 및 어시스턴트 메시지, 도구 호출, 도구 결과는 해당하는 [이벤트](/ko/agenteye/event-stream)로 변환됩니다. + +--- + +## 활성화 방법 + +캡처는 기본적으로 비활성화되어 있습니다. `events:add` 권한이 있는 API 키([API 키](/ko/agenteye/api-keys) 참조)로 수집기를 설치하고 OpenClaw 캡처를 활성화하세요: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --openclaw-enabled +``` + +이 명령은 수집기를 설치하고, 백그라운드 서비스로 등록한 뒤 캡처를 시작합니다. 정상 실행 여부를 확인하려면: + +```bash +agenteye-collector health +``` + +동일한 머신에서 여러 에이전트를 캡처하려면? 각 에이전트의 플래그를 같은 명령에 추가하면 됩니다 — 예: `--openclaw-enabled --codex-enabled`. + +최초 실행 시 기존 OpenClaw 세션이 한 번 백필되고, 이후 새로운 활동은 몇 초 내에 스트리밍됩니다. OpenClaw의 파일은 읽기 전용으로만 접근되며 — 수정, 이동, 삭제는 절대 발생하지 않습니다 — 각 세션은 재시작이 발생해도 정확히 한 번만 전송됩니다. + +--- + +## 표시 위치 + +캡처된 세션은 **Sessions**에, 해당 이벤트는 **Events** 스트림에 표시됩니다. 다른 에이전트와 동일하게 관측되므로 [세션 재생](/ko/agenteye/sessions), [검색](/ko/agenteye/queries), [평가](/ko/agenteye/evaluations), [알림](/ko/agenteye/alerts) 모두 적용됩니다. OpenClaw 에이전트를 필터링하면 해당 세션만 별도로 볼 수 있습니다. + +--- + +## 개인정보 보호 + +OpenClaw 트랜스크립트에는 명령 출력, 파일 내용, 에이전트가 읽거나 쓴 모든 내용 등 전체 세션 데이터가 포함되며 시크릿이 담길 수 있습니다. 캡처된 세션은 있는 그대로 전송되므로, 해당 콘텐츠를 AgentEye에 중앙 집중화하는 것이 적절한 머신과 팀에 한해서만 캡처를 활성화하고, 수집기 키는 `events:add` 권한으로만 범위를 제한하세요. 데이터 격리 방식에 대한 자세한 내용은 [보안](/ko/agenteye/security)을 참조하세요. \ No newline at end of file diff --git a/docs/pt-br/agenteye/codex-capture.mdx b/docs/pt-br/agenteye/codex-capture.mdx index c82190af..4ba3596c 100644 --- a/docs/pt-br/agenteye/codex-capture.mdx +++ b/docs/pt-br/agenteye/codex-capture.mdx @@ -1,31 +1,33 @@ --- -title: "Captura de sessão do Codex" -description: "Transmita as sessões locais do OpenAI Codex da sua equipe para o AgentEye como sessões e eventos comuns — sem nenhuma alteração na forma como eles executam o Codex." +title: "Captura de sessões do Codex" +description: "Transmita as sessões locais do OpenAI Codex da sua equipe para o AgentEye como sessões e eventos comuns — sem nenhuma mudança na forma como eles executam o Codex." --- -Seus engenheiros já executam o OpenAI Codex todos os dias. A captura de sessão do Codex traz essas sessões de codificação para o AgentEye como sessões e eventos comuns, para que você possa pesquisar, reproduzir e avaliar junto com tudo mais que você observa. Ela complementa o [Python SDK](/pt-br/agenteye/python-sdk): o SDK instrumenta os agentes que você escreve, enquanto esta captura o trabalho do Codex que sua equipe já faz — sem nenhuma alteração na forma como eles o executam. +Seus engenheiros já executam o OpenAI Codex todos os dias. A captura de sessões do Codex traz essas sessões de codificação para o AgentEye como sessões e eventos comuns, para que você possa pesquisar, reproduzir e avaliar tudo junto com o restante do que você observa. Ela complementa o [Python SDK](/pt-br/agenteye/python-sdk): o SDK instrumenta agentes que você escreve, enquanto este captura o trabalho do Codex que sua equipe já realiza — sem nenhuma mudança na forma como eles o executam. Um pequeno coletor em segundo plano lê os transcritos de sessão locais do Codex conforme são gravados e os envia para o AgentEye. Um coletor por máquina captura todas as superfícies locais do Codex de uma vez — não há configuração por superfície. +O mesmo coletor captura outros agentes também — veja [OpenClaw](/pt-br/agenteye/openclaw-capture) e [Hermes](/pt-br/agenteye/hermes-capture). Ative cada um que você utiliza; um único coletor pode capturar vários ao mesmo tempo. + --- ## O que é capturado -Toda superfície do Codex que executa **localmente** produz os mesmos transcritos de sessão em disco, e o coletor captura todos eles: +Toda superfície do Codex executada **localmente** produz os mesmos transcritos de sessão em disco, e o coletor os recolhe todos: -- o **CLI** do Codex e `codex exec` +- o **CLI** do Codex e o `codex exec` - a **extensão para VS Code / IDE** - o **aplicativo desktop**, quando executa uma sessão localmente -Cada sessão do Codex torna-se uma [sessão](/pt-br/agenteye/sessions) do AgentEye; suas mensagens de usuário e assistente, raciocínio, chamadas de ferramentas, resultados de ferramentas e uso de tokens tornam-se os [eventos](/pt-br/agenteye/event-stream) correspondentes. A superfície de origem de cada sessão (CLI, IDE ou desktop) é registrada, para que você possa diferenciá-las. +Cada sessão do Codex se torna uma [sessão](/pt-br/agenteye/sessions) do AgentEye; suas mensagens de usuário e assistente, raciocínio, chamadas de ferramentas, resultados de ferramentas e uso de tokens se tornam os [eventos](/pt-br/agenteye/event-stream) correspondentes. A superfície de onde cada sessão se originou (CLI, IDE ou desktop) é registrada, para que você possa distingui-las. -> **Sessões na nuvem não são capturadas.** O aplicativo desktop executa cada vez mais sessões na nuvem do Codex e mantém apenas os metadados delas na máquina — não há transcrito local para ler. Apenas sessões executadas localmente são capturadas. +> **Sessões na nuvem não são capturadas.** O aplicativo desktop executa cada vez mais sessões na nuvem do Codex e mantém apenas os metadados delas na máquina — não há transcrito local para leitura. Apenas sessões executadas localmente são capturadas. --- ## Como ativar -A captura fica desativada até que você a habilite. Instale o coletor com uma chave de API que tenha a permissão `events:add` (consulte [Chaves de API](/pt-br/agenteye/api-keys)) e ative a captura do Codex: +A captura fica desativada até que você a habilite. Instale o coletor com uma chave de API que tenha a permissão `events:add` (veja [Chaves de API](/pt-br/agenteye/api-keys)) e ative a captura do Codex: ```bash curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ @@ -38,16 +40,16 @@ Isso instala o coletor, registra-o como um serviço em segundo plano e inicia a agenteye-collector health ``` -Na primeira execução, suas sessões do Codex existentes são importadas retroativamente uma vez, e a nova atividade passa a ser transmitida em segundos. Os arquivos do próprio Codex são apenas lidos — nunca modificados, movidos ou excluídos — e cada sessão é enviada exatamente uma vez, mesmo entre reinicializações. +Na primeira execução, suas sessões do Codex existentes são preenchidas retroativamente uma vez e a nova atividade passa a ser transmitida em segundos. Os arquivos do próprio Codex são apenas lidos — nunca modificados, movidos ou excluídos — e cada sessão é enviada exatamente uma vez, mesmo após reinicializações. --- ## Onde aparece -As sessões capturadas aparecem em **Sessions**, e seus eventos no fluxo de **Events**, da mesma forma que qualquer outro agente que você observa — portanto, [reprodução de sessão](/pt-br/agenteye/sessions), [pesquisa](/pt-br/agenteye/queries), [avaliações](/pt-br/agenteye/evaluations) e [alertas](/pt-br/agenteye/alerts) funcionam normalmente nelas. Filtre pelo agente Codex para visualizá-las separadamente. +As sessões capturadas aparecem em **Sessões**, e seus eventos no fluxo de **Eventos**, da mesma forma que qualquer outro agente que você observa — assim, [reprodução de sessão](/pt-br/agenteye/sessions), [pesquisa](/pt-br/agenteye/queries), [avaliações](/pt-br/agenteye/evaluations) e [alertas](/pt-br/agenteye/alerts) funcionam nelas. Filtre pelo agente Codex para visualizá-las separadamente. --- ## Privacidade -Os transcritos do Codex contêm a sessão completa — incluindo saída de comandos, conteúdo de arquivos e tudo que o Codex leu ou escreveu — e podem conter segredos. As sessões capturadas são enviadas como estão, portanto, habilite a captura apenas em máquinas e para equipes em que centralizar esse conteúdo no AgentEye seja apropriado, e forneça ao coletor uma chave com escopo apenas para `events:add`. Consulte [Segurança](/pt-br/agenteye/security) para saber como seus dados são mantidos isolados. \ No newline at end of file +Os transcritos do Codex contêm a sessão completa — incluindo saída de comandos, conteúdo de arquivos e tudo que o Codex leu ou escreveu — e podem conter segredos. As sessões capturadas são enviadas como estão; portanto, ative a captura somente em máquinas e para equipes em que centralizar esse conteúdo no AgentEye seja apropriado, e forneça ao coletor uma chave com escopo apenas para `events:add`. Consulte [Segurança](/pt-br/agenteye/security) para saber como seus dados são mantidos isolados. \ No newline at end of file diff --git a/docs/pt-br/agenteye/hermes-capture.mdx b/docs/pt-br/agenteye/hermes-capture.mdx new file mode 100644 index 00000000..9bb668cd --- /dev/null +++ b/docs/pt-br/agenteye/hermes-capture.mdx @@ -0,0 +1,53 @@ +--- +title: "Captura de sessões do Hermes" +description: "Traga as sessões do gateway Hermes da sua equipe — Slack, Telegram, CLI e execuções agendadas — para o AgentEye como sessões e eventos comuns." +--- + +O [Hermes](https://hermes-agent.nousresearch.com) responde à sua equipe de onde quer que ela já trabalhe — Slack, Telegram, CLI, execuções agendadas. A captura de sessões do Hermes traz tudo isso para o AgentEye como sessões e eventos comuns, tornando o assistente com o qual sua equipe conversa todos os dias tão observável quanto os agentes que você mesmo escreve. + +Um pequeno coletor em segundo plano lê o armazenamento local de sessões do Hermes conforme ele é gravado e envia as sessões para o AgentEye. Funciona da mesma forma que a captura do [Codex](/pt-br/agenteye/codex-capture) e do [OpenClaw](/pt-br/agenteye/openclaw-capture), e um único coletor pode capturar vários ao mesmo tempo. + +--- + +## O que é capturado + +Todas as sessões do Hermes na máquina são capturadas, independentemente do canal de origem. Cada uma se torna uma [sessão](/pt-br/agenteye/sessions) no AgentEye; suas mensagens de usuário e assistente, chamadas de ferramenta e resultados de ferramentas se tornam os [eventos](/pt-br/agenteye/event-stream) correspondentes. + +O canal de origem de uma sessão — Slack, Telegram, CLI ou uma execução agendada — é registrado na sessão, permitindo diferenciá-las e filtrar por uma de cada vez. Junto com isso, são registrados o modelo em que a sessão foi executada, o chat e a pessoa que a iniciou e, quando uma sessão originou outra, o vínculo com sua sessão pai. + +As sessões aparecem assim que o Hermes as inicia, independentemente de qualquer interação, e a resposta de um turno e suas chamadas de ferramenta são mantidas na ordem em que realmente ocorreram. Quando uma sessão termina, você também obtém o motivo do encerramento, o custo e o número de tokens utilizados. + +--- + +## Como ativar + +A captura fica desativada até que você a habilite. Instale o coletor com uma chave de API que tenha a permissão `events:add` (consulte [Chaves de API](/pt-br/agenteye/api-keys)) e ative a captura do Hermes: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --hermes-enabled +``` + +Isso instala o coletor, registra-o como um serviço em segundo plano e inicia a captura. Confirme que está em execução: + +```bash +agenteye-collector health +``` + +Capturando mais de um agente na mesma máquina? Adicione a flag de cada um ao mesmo comando — por exemplo, `--hermes-enabled --codex-enabled`. + +Na primeira execução, as sessões do Hermes já existentes são importadas uma vez e a atividade nova passa a ser transmitida em segundos. Os dados do próprio Hermes são apenas lidos — nunca modificados ou excluídos — e cada mensagem é enviada uma única vez, mesmo após reinicializações. + +O `health` também informa se tudo que o coletor capturou realmente chegou ao AgentEye. Se um lote não puder ser entregue, ele é retido e reenviado em vez de descartado, e a verificação reporta status não saudável enquanto houver pendências — portanto, "saudável" significa que seus dados chegaram, não apenas que o processo está ativo. + +--- + +## Onde aparece + +As sessões capturadas aparecem em **Sessions**, e seus eventos no stream de **Events**, da mesma forma que qualquer outro agente observado — portanto, [replay de sessão](/pt-br/agenteye/sessions), [busca](/pt-br/agenteye/queries), [avaliações](/pt-br/agenteye/evaluations) e [alertas](/pt-br/agenteye/alerts) funcionam normalmente com elas. Filtre pelo agente Hermes para visualizá-las separadamente. + +--- + +## Privacidade + +As sessões do Hermes contêm a transcrição completa — incluindo saída de comandos, conteúdo de arquivos e tudo que o agente leu ou escreveu — e podem conter segredos. As sessões capturadas são enviadas como estão, portanto, ative a captura somente onde centralizar esse conteúdo no AgentEye for apropriado, e forneça ao coletor uma chave com escopo limitado a `events:add`. Consulte [Segurança](/pt-br/agenteye/security) para saber como seus dados são mantidos isolados. \ No newline at end of file diff --git a/docs/pt-br/agenteye/openclaw-capture.mdx b/docs/pt-br/agenteye/openclaw-capture.mdx new file mode 100644 index 00000000..a38f5e98 --- /dev/null +++ b/docs/pt-br/agenteye/openclaw-capture.mdx @@ -0,0 +1,49 @@ +--- +title: "Captura de sessões do OpenClaw" +description: "Transmita as sessões locais do OpenClaw da sua equipe para o AgentEye como sessões e eventos comuns — sem nenhuma mudança na forma como o OpenClaw é executado." +--- + +Se sua equipe usa o [OpenClaw](https://docs.openclaw.ai), a captura de sessões do OpenClaw traz essas sessões para o AgentEye como sessões e eventos comuns, permitindo pesquisar, reproduzir e avaliar junto com tudo o mais que você observa. Ela complementa o [Python SDK](/pt-br/agenteye/python-sdk): o SDK instrumenta agentes que você escreve, enquanto esta captura o trabalho do OpenClaw que sua equipe já realiza — sem nenhuma mudança na forma como eles o executam. + +Um pequeno coletor em segundo plano lê os transcritos de sessão locais do OpenClaw à medida que são gravados e os envia para o AgentEye. Funciona da mesma forma que a [captura do Codex](/pt-br/agenteye/codex-capture), e um único coletor pode capturar ambos ao mesmo tempo. + +--- + +## O que é capturado + +Todo agente configurado na instalação do OpenClaw de uma máquina é capturado pelo coletor daquela máquina — não há configuração por agente. + +Cada sessão do OpenClaw se torna uma [sessão](/pt-br/agenteye/sessions) no AgentEye; suas mensagens de usuário e assistente, chamadas de ferramentas e resultados de ferramentas se tornam os [eventos](/pt-br/agenteye/event-stream) correspondentes. + +--- + +## Como ativar + +A captura fica desativada até você habilitá-la. Instale o coletor com uma chave de API que tenha a permissão `events:add` (consulte [Chaves de API](/pt-br/agenteye/api-keys)) e ative a captura do OpenClaw: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --openclaw-enabled +``` + +Isso instala o coletor, registra-o como um serviço em segundo plano e inicia a captura. Para confirmar que está em execução: + +```bash +agenteye-collector health +``` + +Capturando mais de um agente na mesma máquina? Adicione o sinalizador de cada um ao mesmo comando — por exemplo, `--openclaw-enabled --codex-enabled`. + +Na primeira execução, suas sessões existentes do OpenClaw são retroativamente preenchidas uma única vez, e a nova atividade passa a ser transmitida em segundos. Os arquivos do próprio OpenClaw são apenas lidos — nunca modificados, movidos ou excluídos — e cada sessão é enviada exatamente uma vez, mesmo após reinicializações. + +--- + +## Onde as sessões aparecem + +As sessões capturadas aparecem em **Sessions**, e seus eventos no fluxo de **Events**, assim como qualquer outro agente que você observa — portanto, [reprodução de sessão](/pt-br/agenteye/sessions), [pesquisa](/pt-br/agenteye/queries), [avaliações](/pt-br/agenteye/evaluations) e [alertas](/pt-br/agenteye/alerts) funcionam normalmente nelas. Filtre pelo agente do OpenClaw para visualizá-las de forma isolada. + +--- + +## Privacidade + +Os transcritos do OpenClaw contêm a sessão completa — incluindo saída de comandos, conteúdo de arquivos e tudo o que o agente leu ou escreveu — e podem conter segredos. As sessões capturadas são enviadas como estão; portanto, ative a captura apenas em máquinas e para equipes onde centralizar esse conteúdo no AgentEye seja adequado, e forneça ao coletor uma chave com escopo restrito a `events:add`. Consulte [Segurança](/pt-br/agenteye/security) para saber como seus dados são mantidos isolados. \ No newline at end of file diff --git a/docs/ru/agenteye/codex-capture.mdx b/docs/ru/agenteye/codex-capture.mdx index e6babcd7..380999ab 100644 --- a/docs/ru/agenteye/codex-capture.mdx +++ b/docs/ru/agenteye/codex-capture.mdx @@ -1,53 +1,55 @@ --- -title: "Capture сеансов Codex" -description: "Собирайте локальные сеансы OpenAI Codex вашей команды в AgentEye как обычные сеансы и события — без каких-либо изменений в том, как они используют Codex." +title: "Захват сессий Codex" +description: "Отслеживайте локальные сессии OpenAI Codex вашей команды в AgentEye как обычные сессии и события — без каких-либо изменений в том, как они используют Codex." --- -Ваши инженеры уже используют OpenAI Codex каждый день. Capture сеансов Codex переносит эти сеансы кодирования в AgentEye как обычные сеансы и события, поэтому вы можете искать, воспроизводить и оценивать их вместе со всем остальным, что вы наблюдаете. Это дополняет [Python SDK](/ru/agenteye/python-sdk): SDK инструментирует агентов, которых вы пишете, а это функция захватывает работу Codex, которую уже делает ваша команда — без каких-либо изменений в том, как они его используют. +Ваши инженеры уже ежедневно используют OpenAI Codex. Захват сессий Codex переносит эти сессии кодирования в AgentEye как обычные сессии и события, так что вы можете искать, воспроизводить и оценивать их наравне со всем остальным, что вы наблюдаете. Это дополняет [Python SDK](/ru/agenteye/python-sdk): SDK instrumentирует агентов, которых вы пишете, а это функция захватывает работу Codex, которую уже выполняет ваша команда — без каких-либо изменений в том, как они его используют. -Небольшой фоновый сборщик читает локальные транскрипты сеансов Codex по мере их записи и отправляет их в AgentEye. Один сборщик на машину захватывает все локальные поверхности Codex одновременно — не требуется настройка для каждой поверхности. +Небольшой фоновый сборщик читает локальные транскрипты сессий Codex по мере их записи и отправляет их в AgentEye. Один сборщик на машину захватывает все локальные поверхности Codex одновременно — не требуется настройка для каждой поверхности. + +Этот же сборщик захватывает и других агентов — см. [OpenClaw](/ru/agenteye/openclaw-capture) и [Hermes](/ru/agenteye/hermes-capture). Включите каждого, кого вы используете; один сборщик может захватывать несколько одновременно. --- -## Что захватывается +## Что он захватывает -Каждая поверхность Codex, которая работает **локально**, создает одинаковые транскрипты сеансов на диске, и сборщик подхватывает все из них: +Каждая поверхность Codex, работающая **локально**, создаёт одинаковые транскрипты сессий на диске, и сборщик захватывает все из них: -- Codex **CLI** и `codex exec` -- расширение **VS Code / IDE** -- **настольное приложение**, когда оно запускает сеанс локально +- **CLI** Codex и `codex exec` +- **расширение VS Code / IDE** +- **настольное приложение**, когда оно запускает сессию локально -Каждый сеанс Codex становится AgentEye [сеансом](/ru/agenteye/sessions); его сообщения пользователя и помощника, рассуждения, вызовы инструментов, результаты инструментов и использование токенов становятся соответствующими [событиями](/ru/agenteye/event-stream). Записывается поверхность, из которой пришел каждый сеанс (CLI, IDE или настольное приложение), поэтому вы можете их различить. +Каждая сессия Codex становится [сессией](/ru/agenteye/sessions) AgentEye; её сообщения пользователя и помощника, рассуждение, вызовы инструментов, результаты инструментов и использование токенов становятся соответствующими [событиями](/ru/agenteye/event-stream). Поверхность, из которой пришла каждая сессия (CLI, IDE или настольное приложение), записывается, поэтому вы можете их различить. -> **Облачные сеансы не захватываются.** Настольное приложение все чаще запускает сеансы в облаке Codex и сохраняет только их метаданные на машине — локального транскрипта для чтения нет. Захватываются только локально выполняемые сеансы. +> **Облачные сессии не захватываются.** Настольное приложение всё чаще запускает сессии в облаке Codex и хранит только их метаданные на машине — нет локального транскрипта для чтения. Захватываются только локально выполняемые сессии. --- ## Включение -Capture отключен по умолчанию. Установите сборщик с ключом API, который имеет разрешение `events:add` (см. [API keys](/ru/agenteye/api-keys)), и включите capture Codex: +Захват отключен по умолчанию. Установите сборщик с API-ключом, имеющим разрешение `events:add` (см. [API-ключи](/ru/agenteye/api-keys)), и включите захват Codex: ```bash curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ | sh -s -- --key --codex-enabled ``` -Это устанавливает сборщик, регистрирует его как фоновый сервис и начинает захват. Убедитесь, что он работает: +Это устанавливает сборщик, регистрирует его как фоновый сервис и запускает захват. Убедитесь, что он работает: ```bash agenteye-collector health ``` -При первом запуске ваши существующие сеансы Codex восполняются один раз, а новая активность затем поступает в течение нескольких секунд. Файлы Codex только читаются — никогда не изменяются, не перемещаются и не удаляются — и каждый сеанс отправляется ровно один раз, даже при перезагрузке. +При первом запуске ваши существующие сессии Codex будут заполнены один раз, а затем новая активность будет поступать в течение нескольких секунд. Файлы самого Codex только читаются — никогда не модифицируются, не перемещаются и не удаляются — и каждая сессия отправляется ровно один раз, даже при перезагрузке. --- ## Где это отображается -Захваченные сеансы появляются в **Sessions**, а их события в потоке **Events**, как и любой другой наблюдаемый вами агент — поэтому [воспроизведение сеансов](/ru/agenteye/sessions), [поиск](/ru/agenteye/queries), [оценки](/ru/agenteye/evaluations) и [оповещения](/ru/agenteye/alerts) работают и на них. Фильтруйте по агенту Codex, чтобы увидеть их отдельно. +Захваченные сессии появляются в **Sessions**, а их события в потоке **Events**, как и у любого другого наблюдаемого агента — поэтому [воспроизведение сессий](/ru/agenteye/sessions), [поиск](/ru/agenteye/queries), [оценки](/ru/agenteye/evaluations) и [алерты](/ru/agenteye/alerts) работают с ними. Фильтруйте по агенту Codex, чтобы увидеть только их. --- ## Конфиденциальность -Транскрипты Codex содержат полный сеанс — включая вывод команд, содержимое файлов и все, что Codex читал или писал — и могут содержать секреты. Захваченные сеансы отправляются как есть, поэтому включайте capture только на машинах и для команд, где централизация этого контента в AgentEye уместна, и предоставьте сборщику ключ, ограниченный только `events:add`. См. [Security](/ru/agenteye/security) для информации о том, как ваши данные остаются изолированными. \ No newline at end of file +Транскрипты Codex содержат полную сессию — включая выводы команд, содержимое файлов и всё, что Codex прочитал или написал — и могут содержать секреты. Захваченные сессии отправляются как есть, поэтому включайте захват только на машинах и для команд, где централизация этого содержимого в AgentEye уместна, и предоставьте сборщику ключ с правами только на `events:add`. См. [Безопасность](/ru/agenteye/security), чтобы узнать, как ваши данные остаются изолированными. \ No newline at end of file diff --git a/docs/ru/agenteye/hermes-capture.mdx b/docs/ru/agenteye/hermes-capture.mdx new file mode 100644 index 00000000..dd011382 --- /dev/null +++ b/docs/ru/agenteye/hermes-capture.mdx @@ -0,0 +1,53 @@ +--- +title: "Захват сессий Hermes" +description: "Приносите сессии шлюза Hermes вашей команды — Slack, Telegram, CLI и запланированные запуски — в AgentEye в виде обычных сессий и событий." +--- + +[Hermes](https://hermes-agent.nousresearch.com) отвечает вашей команде там, где они уже работают — в Slack, Telegram, CLI, запланированные запуски. Захват сессий Hermes приносит всё это в AgentEye в виде обычных сессий и событий, так что помощник, с которым ваша команда общается каждый день, наблюдается так же, как и агенты, которых вы пишете сами. + +Небольшой фоновый сборщик читает локальное хранилище сессий Hermes по мере их записи и отправляет сессии в AgentEye. Это работает так же, как захват [Codex](/ru/agenteye/codex-capture) и [OpenClaw](/ru/agenteye/openclaw-capture), и один сборщик может одновременно захватывать несколько. + +--- + +## Что он захватывает + +Каждая сессия Hermes на машине захватывается, независимо от того, из какого канала она пришла. Каждая становится [сессией](/ru/agenteye/sessions) AgentEye; её сообщения пользователя и помощника, вызовы инструментов и результаты инструментов становятся соответствующими [событиями](/ru/agenteye/event-stream). + +Канал, с которого была запущена сессия — Slack, Telegram, CLI или запланированный запуск — записывается в сессию, поэтому вы можете различить их и фильтровать по одному за раз. Наряду с этим записываются модель, на которой выполнялась сессия, чат и человек, который её запустил, и, когда сессия порождала другую, ссылка обратно на родительскую сессию. + +Сессии появляются сразу же, как только Hermes их запускает, независимо от того, было ли что-либо сказано, и ответ на ход и его вызовы инструментов остаются в том порядке, в котором они произошли на самом деле. Когда сессия завершается, вы также получаете информацию о том, почему она завершилась, сколько это стоило и сколько токенов было использовано. + +--- + +## Включите это + +Захват отключен до тех пор, пока вы его не включите. Установите сборщик с API-ключом, у которого есть разрешение `events:add` (см. [API-ключи](/ru/agenteye/api-keys)), и включите захват Hermes: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --hermes-enabled +``` + +Это устанавливает сборщик, регистрирует его как фоновую службу и начинает захват. Подтвердите, что он работает: + +```bash +agenteye-collector health +``` + +Захватываете больше одного агента на одной машине? Добавьте флаг каждого в одну и ту же команду — например `--hermes-enabled --codex-enabled`. + +При первом запуске ваши существующие сессии Hermes заполняются один раз, и новая активность затем поступает в течение нескольких секунд. Данные Hermes только читаются — никогда не изменяются и не удаляются — и каждое сообщение отправляется один раз, даже при перезапусках. + +`health` также показывает, достигли ли на самом деле AgentEye все данные, которые сборщик захватил. Если пакет не удалось доставить, он сохраняется и повторяется, а не отбрасывается, и проверка сообщает о нездоровье, пока что-то всё ещё остаётся невыполненным — поэтому здоровье означает, что ваши данные прибыли, а не просто что процесс живой. + +--- + +## Где это отображается + +Захватанные сессии появляются в **Sessions**, а их события в потоке **Events**, так же как и любой другой наблюдаемый агент — поэтому [воспроизведение сессии](/ru/agenteye/sessions), [поиск](/ru/agenteye/queries), [оценки](/ru/agenteye/evaluations) и [оповещения](/ru/agenteye/alerts) работают с ними. Фильтруйте по агенту Hermes, чтобы увидеть их отдельно. + +--- + +## Конфиденциальность + +Сессии Hermes содержат полную транскрипцию — включая вывод команд, содержимое файлов и всё, что агент прочитал или написал — и могут содержать секреты. Захватанные сессии отправляются как есть, поэтому включайте захват только там, где централизация этого содержимого в AgentEye уместна, и предоставьте сборщику ключ с областью действия `events:add` только. См. [Security](/ru/agenteye/security) для получения информации о том, как ваши данные хранятся в изоляции. \ No newline at end of file diff --git a/docs/ru/agenteye/openclaw-capture.mdx b/docs/ru/agenteye/openclaw-capture.mdx new file mode 100644 index 00000000..340e2193 --- /dev/null +++ b/docs/ru/agenteye/openclaw-capture.mdx @@ -0,0 +1,49 @@ +--- +title: "Захват сессий OpenClaw" +description: "Отправляйте локальные сессии OpenClaw вашей команды в AgentEye как обычные сессии и события — без изменений в работе OpenClaw." +--- + +Если ваша команда использует [OpenClaw](https://docs.openclaw.ai), захват сессий OpenClaw доставляет эти сессии в AgentEye как обычные сессии и события, позволяя вам искать, воспроизводить и оценивать их вместе со всем остальным, что вы наблюдаете. Это дополняет [Python SDK](/ru/agenteye/python-sdk): SDK инструментирует агентов, которых вы пишете, а это захватывает работу OpenClaw, которую ваша команда уже выполняет — без каких-либо изменений в её работе. + +Небольшой фоновый сборщик читает локальные трансляции сессий OpenClaw по мере их записи и отправляет их в AgentEye. Он работает так же, как [Codex capture](/ru/agenteye/codex-capture), и один сборщик может одновременно захватывать оба типа. + +--- + +## Что захватывается + +Каждый агент, настроенный в OpenClaw на машине, захватывается сборщиком этой машины — не требуется настройка для каждого агента отдельно. + +Каждая сессия OpenClaw становится [сессией](/ru/agenteye/sessions) AgentEye; её сообщения пользователя и ассистента, вызовы инструментов и результаты инструментов становятся соответствующими [событиями](/ru/agenteye/event-stream). + +--- + +## Включение + +Захват отключён по умолчанию. Установите сборщик с API ключом, имеющим разрешение `events:add` (см. [API keys](/ru/agenteye/api-keys)), и включите захват OpenClaw: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --openclaw-enabled +``` + +Это установит сборщик, зарегистрирует его как фоновый сервис и запустит захват. Убедитесь, что он работает: + +```bash +agenteye-collector health +``` + +Захватываете больше одного агента на одной машине? Добавьте флаг каждого в одну команду — например `--openclaw-enabled --codex-enabled`. + +При первом запуске ваши существующие сессии OpenClaw будут загружены один раз, а новая активность будет потоком поступать в течение нескольких секунд. Файлы OpenClaw только читаются — никогда не изменяются, не перемещаются и не удаляются — и каждая сессия отправляется ровно один раз, даже при перезагрузках. + +--- + +## Где это отображается + +Захваченные сессии отображаются в **Sessions**, а их события в потоке **Events**, так же как любой другой наблюдаемый вами агент — поэтому [воспроизведение сессий](/ru/agenteye/sessions), [поиск](/ru/agenteye/queries), [оценки](/ru/agenteye/evaluations) и [оповещения](/ru/agenteye/alerts) работают с ними. Отфильтруйте по агенту OpenClaw, чтобы увидеть их отдельно. + +--- + +## Конфиденциальность + +Трансляции OpenClaw содержат полную сессию — включая вывод команд, содержимое файлов и всё, что прочитал или написал агент — и могут содержать секреты. Захваченные сессии отправляются как есть, поэтому включайте захват только на машинах и для команд, где централизация такого содержимого в AgentEye уместна, и предоставьте сборщику ключ, ограниченный только `events:add`. См. [Security](/ru/agenteye/security), чтобы узнать, как ваши данные остаются изолированными. \ No newline at end of file diff --git a/docs/tr/agenteye/codex-capture.mdx b/docs/tr/agenteye/codex-capture.mdx index 38a6506f..0b7656a5 100644 --- a/docs/tr/agenteye/codex-capture.mdx +++ b/docs/tr/agenteye/codex-capture.mdx @@ -1,53 +1,55 @@ --- -title: "Codex oturumu yakalama" -description: "Ekibinizin yerel OpenAI Codex oturumlarını AgentEye'a sıradan oturumlar ve etkinlikler olarak yönlendirin — Codex'i çalıştırma şeklinizde hiçbir değişiklik olmadan." +title: "Codex oturum yakalama" +description: "Ekibinizin yerel OpenAI Codex oturumlarını AgentEye'a sıradan oturumlar ve etkinlikler olarak aktarın — Codex'i nasıl çalıştırdıklarında hiçbir değişiklik olmadan." --- -Mühendisleriniz zaten her gün OpenAI Codex'i çalıştırıyorlar. Codex oturumu yakalama, bu kodlama oturumlarını AgentEye'a sıradan oturumlar ve etkinlikler olarak getirerek, bunları aradığınız her şeyin yanında arayabilir, tekrar oynatabilir ve değerlendirebilirsiniz. [Python SDK](/tr/agenteye/python-sdk) ile tamamlayıcıdır: SDK, yazdığınız aracıları işaretlerken, bu, ekibinizin zaten yaptığı Codex işini yakalar — çalıştırma şeklinizde hiçbir değişiklik olmadan. +Mühendisleriniz zaten her gün OpenAI Codex'i çalıştırıyor. Codex oturum yakalama, bu kodlama oturumlarını AgentEye'a sıradan oturumlar ve etkinlikler olarak getiriyor, böylece bunları arayabilir, yeniden oynatabilir ve gözlemlediğiniz her şeyin yanında değerlendirebilirsiniz. [Python SDK](/tr/agenteye/python-sdk) ile tamamlayıcıdır: SDK yazdığınız ajanları enstrümante eder, bu ise ekibinizin zaten yaptığı Codex çalışmasını yakalar — çalıştırma şeklinde hiçbir değişiklik olmadan. -Küçük bir arka plan toplayıcı, Codex'in yerel oturum yazıklarını yazıldıkları sırada okur ve bunları AgentEye'a gönderir. Makine başına bir toplayıcı tüm yerel Codex yüzeylerini aynı anda yakalar — yüzey başına kurulum gerekli değildir. +Küçük bir arka plan toplayıcı, Codex'in yerel oturum transkriptlerini yazıldıkça okur ve bunları AgentEye'a gönderir. Makine başına bir toplayıcı tüm yerel Codex yüzeylerini aynı anda yakalar — yüzey başına kurulum gerekmez. + +Aynı toplayıcı diğer ajanları da yakalar — bkz. [OpenClaw](/tr/agenteye/openclaw-capture) ve [Hermes](/tr/agenteye/hermes-capture). Çalıştırdığınız her birini etkinleştirin; tek bir toplayıcı aynı anda birkaç tanesini yakala­bilir. --- -## Neler yakalar +## Neler yakalanır -**Yerel olarak** çalışan her Codex yüzeyi aynı disk üstü oturum yazıklarını üretir ve toplayıcı hepsini alır: +**Yerel olarak** çalışan her Codex yüzeyi aynı disk üstü oturum transkriptlerini üretir ve toplayıcı hepsini alır: - Codex **CLI** ve `codex exec` - **VS Code / IDE uzantısı** -- bir oturumu yerel olarak çalıştırdığında **masaüstü uygulaması** +- **masaüstü uygulaması**, bir oturumu yerel olarak çalıştırdığında -Her Codex oturumu bir AgentEye [oturumu](/tr/agenteye/sessions) olur; kullanıcı ve asistan mesajları, akıl yürütme, araç çağrıları, araç sonuçları ve belirteç kullanımı eşleşen [etkinlikler](/tr/agenteye/event-stream) olur. Her oturumun geldiği yüzey (CLI, IDE veya masaüstü) kaydedilir, böylece bunları ayırt edebilirsiniz. +Her Codex oturumu bir AgentEye [oturumuna](/tr/agenteye/sessions) dönüşür; kullanıcı ve asistan mesajları, akıl yürütme, araç çağrıları, araç sonuçları ve belirteç kullanımı karşılık gelen [etkinliklere](/tr/agenteye/event-stream) dönüşür. Her oturumun geldiği yüzey (CLI, IDE veya masaüstü) kaydedilir, böylece bunları ayırt edebilirsiniz. -> **Bulut oturumları yaklanmaz.** Masaüstü uygulaması giderek artan şekilde oturumları Codex bulutunda çalıştırır ve yalnızca bunların meta verilerini makinede tutar — okunacak yerel yazık yoktur. Yalnızca yerel olarak yürütülen oturumlar yaklanır. +> **Bulut oturumları yakalanmaz.** Masaüstü uygulaması giderek daha fazla oturumu Codex bulutunda çalıştırıyor ve yalnızca meta verilerini makinede tutuyor — okuması gereken yerel transkript yok. Yalnızca yerel olarak yürütülen oturumlar yakalanır. --- -## Açın +## Aç -Yakalama siz etkinleştirene kadar kapalıdır. `events:add` izni olan bir API anahtarı ile toplayıcıyı yükleyin (bkz. [API anahtarları](/tr/agenteye/api-keys)) ve Codex yakalamayı açın: +Yakalama, etkinleştirene kadar kapalıdır. `events:add` izni olan bir API anahtarı ile toplayıcıyı kurun (bkz. [API anahtarları](/tr/agenteye/api-keys)) ve Codex yakalamayı aç: ```bash curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ | sh -s -- --key --codex-enabled ``` -Bu, toplayıcıyı yükler, onu arka plan hizmeti olarak kaydeder ve yakalamaya başlar. Çalıştığını onaylayın: +Bu, toplayıcıyı kurar, onu arka plan hizmeti olarak kaydeder ve yakalamaya başlar. Çalıştığını doğrulayın: ```bash agenteye-collector health ``` -İlk çalıştırmada, mevcut Codex oturumlarınız bir kez geri doldurulur ve yeni etkinlik daha sonra saniyeler içinde akar. Codex'in kendi dosyaları yalnızca okunur — asla değiştirilmez, taşınmaz veya silinmez — ve her oturum yeniden başlatmalar arasında bile tam olarak bir kez gönderilir. +İlk çalıştırmada, mevcut Codex oturumlarınız bir kez geri doldurulur ve yeni etkinlik ardından saniyeler içinde akışa başlar. Codex'in kendi dosyaları yalnızca okunur — asla değiştirilmez, taşınmaz veya silinmez — ve her oturum, yeniden başlatmalar arasında bile tam olarak bir kez gönderilir. --- ## Nerede görünür -Yakalanan oturumlar **Oturumlar**'da ve bunların etkinlikleri **Etkinlikler** akışında görünür — başka herhangi bir gözlemlediğiniz aracı gibi aynı şekilde — bu nedenle [oturum yeniden oynatma](/tr/agenteye/sessions), [arama](/tr/agenteye/queries), [değerlendirmeler](/tr/agenteye/evaluations) ve [uyarılar](/tr/agenteye/alerts) hepsi bunlar üzerinde çalışır. Codex aracısına göre filtreleyin ve bunları kendi başlarına görün. +Yakalanan oturumlar **Oturumlar**'da görünür ve etkinlikleri **Etkinlikler** akışında, gözlemlediğiniz diğer herhangi bir ajanla aynı şekilde — böylece [oturum yeniden oynatma](/tr/agenteye/sessions), [arama](/tr/agenteye/queries), [değerlendirmeler](/tr/agenteye/evaluations) ve [uyarılar](/tr/agenteye/alerts) hepsi bunlar üzerinde çalışır. Codex ajanına göre filtreleyin, bunları kendi başlarına görmek için. --- ## Gizlilik -Codex yazıkları tam oturumu içerir — komut çıktısı, dosya içeriği ve Codex'in okuduğu veya yazdığı her şey dahil — ve sırlar içerebilir. Yakalanan oturumlar olduğu gibi gönderilir, bu nedenle yakalamayı yalnızca bu içeriği AgentEye'a merkezileştirmenin uygun olduğu makinelerde ve ekipler için açın ve toplayıcıya yalnızca `events:add` kapsamına alınmış bir anahtar verin. Verilerinizin nasıl izole tutulduğu hakkında [Güvenlik](/tr/agenteye/security) sayfasına bakın. \ No newline at end of file +Codex transkriptleri tam oturumu içerir — komut çıktısı, dosya içeriği ve Codex'in okuduğu veya yazdığı her şey dahil — ve sırlar içerebilir. Yakalanan oturumlar olduğu gibi gönderilir, bu nedenle yakalamayı yalnızca bu içeriği AgentEye'a merkezileştirmenin uygun olduğu makineler ve takımlar için etkinleştirin ve toplayıcıya yalnızca `events:add` kapsamlı bir anahtar verin. Verilerinizin nasıl izole tutulduğu hakkında bkz. [Güvenlik](/tr/agenteye/security). \ No newline at end of file diff --git a/docs/tr/agenteye/hermes-capture.mdx b/docs/tr/agenteye/hermes-capture.mdx new file mode 100644 index 00000000..f275c647 --- /dev/null +++ b/docs/tr/agenteye/hermes-capture.mdx @@ -0,0 +1,53 @@ +--- +title: "Hermes oturum yakalama" +description: "Ekibinizin Hermes ağ geçidi oturumlarını — Slack, Telegram, CLI ve planlanmış çalıştırmalar — AgentEye'da sıradan oturumlar ve etkinlikler olarak getirin." +--- + +[Hermes](https://hermes-agent.nousresearch.com), ekibinizin zaten çalıştığı her yerden yanıt verir — Slack, Telegram, CLI, planlanmış çalıştırmalar. Hermes oturum yakalama, bunların tümünü AgentEye'da sıradan oturumlar ve etkinlikler olarak getirerek, ekibinizin her gün konuştuğu asistan, yazmanız gereken ajanlar kadar gözlemlenebilir hale gelir. + +Küçük bir arka plan toplayıcısı, Hermes'in yerel oturum deposunu yazıldıkça okur ve oturumları AgentEye'a gönderir. [Codex](/tr/agenteye/codex-capture) ve [OpenClaw](/tr/agenteye/openclaw-capture) yakalaması ile aynı şekilde çalışır ve bir toplayıcı aynı anda birkaçını yakalayabilir. + +--- + +## Ne yakalar + +Makinedeki her Hermes oturumu, hangi kanaldan gelirse gelsin yakalanır. Her biri AgentEye [oturumuna](/tr/agenteye/sessions) dönüşür; kullanıcı ve asistan mesajları, araç çağrıları ve araç sonuçları eşleşen [etkinliklere](/tr/agenteye/event-stream) dönüşür. + +Oturumun başladığı kanal — Slack, Telegram, CLI veya planlanmış çalıştırma — oturumda kaydedilir, böylece onları ayırt edebilir ve tek seferde birine filtreyebilirsiniz. Bununla birlikte oturumun çalıştığı model, başlatıldığı sohbet ve kişi, ve bir oturum başka birini oluşturduğunda üst öğesine geri bağlantı da gelir. + +Oturumlar Hermes'in başladığı anda görünür, henüz birşey söylenmiş olsa da olmasa da, ve bir döngünün yanıtı ile araç çağrıları gerçekten meydana gelen sırada kalır. Bir oturum sona erdiğinde, neden sona erdiğini, ne kadar maliyeti olduğunu ve kaç token kullandığını da alırsınız. + +--- + +## Etkinleştirin + +Yakalama, etkinleştirene kadar kapalıdır. Toplayıcıyı `events:add` izni olan bir API anahtarı ile yükleyin ([API anahtarlarına](/tr/agenteye/api-keys) bakın) ve Hermes yakalamasını açın: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --hermes-enabled +``` + +Bu, toplayıcıyı kurar, arka plan hizmeti olarak kaydeder ve yakalamaya başlar. Çalıştığını doğrulayın: + +```bash +agenteye-collector health +``` + +Aynı makinede birden fazla ajan mı yakalaması yapacaksınız? Her birinin bayrağını aynı komuta ekleyin — örneğin `--hermes-enabled --codex-enabled`. + +İlk çalıştırmada, mevcut Hermes oturumlarınız bir kez geri doldurulur ve yeni etkinlik birkaç saniye içinde akışa alınır. Hermes'in kendi verileri yalnızca okunur — asla değiştirilmez veya silinmez — ve her mesaj bir kez gönderilir, yeniden başlatmalar arasında bile. + +`health` ayrıca toplayıcının yakaladığı her şeyin gerçekten AgentEye'a ulaşıp ulaşmadığını söyler. Bir batch teslimat edilemezse, atılmak yerine tutulur ve tekrar denenir ve kontrol, henüz ödenmemiş herhangi bir şey varsa sağlıksız olarak rapor eder — bu nedenle "sağlıklı" verilerinizin ulaştığı anlamına gelir, yalnızca işlemin canlı olduğu değil. + +--- + +## Nerede görünür + +Yakalanan oturumlar **Oturumlar**'da ve etkinlikleri **Etkinlikler** akışında görünür, gözlemlenmiş diğer herhangi bir ajan gibi — bu nedenle [oturum yeniden oynatma](/tr/agenteye/sessions), [arama](/tr/agenteye/queries), [değerlendirmeler](/tr/agenteye/evaluations) ve [uyarılar](/tr/agenteye/alerts) bunlar üzerinde çalışır. Onları kendi başına görmek için Hermes ajanına göre filtreleyin. + +--- + +## Gizlilik + +Hermes oturumları tam transkripti içerir — komut çıktısı, dosya içerikleri ve ajanın okuduğu veya yazdığı herhangi bir şey dahil — ve sırlar içerebilir. Yakalanan oturumlar olduğu gibi gönderilir, bu nedenle yaklamasını yalnızca bu içeriği AgentEye'da merkezileştirmenin uygun olduğu yerlerde etkinleştirin ve toplayıcıya yalnızca `events:add` kapsamına sahip bir anahtar verin. Verilerinizin nasıl yalıtılı tutulduğu hakkında [Güvenlik](/tr/agenteye/security) bölümüne bakın. \ No newline at end of file diff --git a/docs/tr/agenteye/openclaw-capture.mdx b/docs/tr/agenteye/openclaw-capture.mdx new file mode 100644 index 00000000..8325ff07 --- /dev/null +++ b/docs/tr/agenteye/openclaw-capture.mdx @@ -0,0 +1,50 @@ +--- +--- +title: "OpenClaw oturum yakalama" +description: "Ekibinizin yerel OpenClaw oturumlarını AgentEye'a sıradan oturumlar ve etkinlikler olarak akışı yapın — OpenClaw'un çalışma şekli değişmeden." +--- + +Ekibiniz [OpenClaw](https://docs.openclaw.ai) çalıştırıyorsa, OpenClaw oturum yakalama bu oturumları AgentEye'a sıradan oturumlar ve etkinlikler olarak getirir, böylece gözlemlediğiniz diğer her şeyin yanında bunları arayabilir, oynatabilir ve değerlendirebilirsiniz. [Python SDK](/tr/agenteye/python-sdk) tamamlayıcısıdır: SDK yazdığınız aracıları işaretlerken, bu yakalama ekibinizin zaten yaptığı OpenClaw işini — çalışma şekli değişmeden — yakalar. + +Küçük bir arka plan toplayıcısı, OpenClaw'un yerel oturum transkriptlerini yazıldığı sırada okur ve AgentEye'a gönderir. [Codex yakalama](/tr/agenteye/codex-capture) ile aynı şekilde çalışır ve bir toplayıcı her ikisini aynı anda yakala­yabilir. + +--- + +## Ne yakalar + +Bir makinenin OpenClaw kurulumunda yapılandırılan her aracı, o makinenin toplayıcısı tarafından yakalanır — aracı başına bir kurulum yoktur. + +Her OpenClaw oturumu bir AgentEye [oturumu](/tr/agenteye/sessions) olur; kullanıcı ve asistan mesajları, araç çağrıları ve araç sonuçları eşleşen [etkinlikler](/tr/agenteye/event-stream) haline gelir. + +--- + +## Etkinleştirin + +Yakalama, etkinleştirene kadar kapatılıdır. Toplayıcıyı `events:add` izni olan bir API anahtarı ile kurun ([API anahtarları](/tr/agenteye/api-keys) bölümüne bakın) ve OpenClaw yakalamayı etkinleştirin: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --openclaw-enabled +``` + +Bu toplayıcıyı kurar, arka plan hizmeti olarak kaydeder ve yakalamaya başlar. Çalıştığını doğrulayın: + +```bash +agenteye-collector health +``` + +Aynı makinede birden fazla aracı mı yakalaşıyorsunuz? Her birinin bayrağını aynı komuta ekleyin — örneğin `--openclaw-enabled --codex-enabled`. + +İlk çalışmada, mevcut OpenClaw oturumlarınız bir kez geri doldurulur ve yeni etkinlikler birkaç saniye içinde akışa geçer. OpenClaw'un kendi dosyaları sadece okunur — asla değiştirilmez, taşınmaz veya silinmez — ve her oturum, yeniden başlatmalar arasında bile tam olarak bir kez gönderilir. + +--- + +## Nerede görünür + +Yakalanan oturumlar **Sessions** içinde görünür ve etkinlikleri **Events** akışında gözlemlediğiniz herhangi bir aracı ile aynıdır — bu nedenle [oturum oynatma](/tr/agenteye/sessions), [arama](/tr/agenteye/queries), [değerlendirmeler](/tr/agenteye/evaluations) ve [uyarılar](/tr/agenteye/alerts) hepsi bunlar üzerinde çalışır. OpenClaw aracısına göre filtreleyin ve onları kendi başlarına görmek için. + +--- + +## Gizlilik + +OpenClaw transkriptleri tam oturumu içerir — komut çıktısı, dosya içeriği ve aracının okuduğu veya yazdığı her şey dahil — ve gizli diziler içerebilir. Yakalanan oturumlar olduğu gibi gönderilir, bu nedenle yakalamayı sadece bu içeriği AgentEye'a merkezileştirmenin uygun olduğu makinelerde ve ekiplerde etkinleştirin ve toplayıcıya yalnızca `events:add` kapsamında bir anahtar verin. Verilerinizin nasıl izole tutulduğu hakkında [Güvenlik](/tr/agenteye/security) bölümüne bakın. \ No newline at end of file diff --git a/docs/vi/agenteye/codex-capture.mdx b/docs/vi/agenteye/codex-capture.mdx index 0b6dbd35..8a1ac9e3 100644 --- a/docs/vi/agenteye/codex-capture.mdx +++ b/docs/vi/agenteye/codex-capture.mdx @@ -1,54 +1,55 @@ --- ---- title: "Codex session capture" description: "Tail your team's local OpenAI Codex sessions into AgentEye as ordinary sessions and events — with no change to how they run Codex." --- -Các kỹ sư của bạn đã chạy OpenAI Codex hàng ngày. Codex session capture đưa những phiên làm việc mã hóa đó vào AgentEye như những phiên và sự kiện thông thường, cho phép bạn tìm kiếm, phát lại và đánh giá chúng cùng với mọi thứ khác bạn quan sát. Nó bổ sung cho [Python SDK](/vi/agenteye/python-sdk): SDK công cụ các agent bạn viết, trong khi này thu thập công việc Codex mà nhóm của bạn đã làm — mà không cần thay đổi cách họ chạy nó. +Những kỹ sư của bạn đã chạy OpenAI Codex hàng ngày. Codex session capture đưa những phiên lập trình đó vào AgentEye như các phiên và sự kiện thường xuyên, để bạn có thể tìm kiếm, phát lại và đánh giá chúng cùng với mọi thứ khác mà bạn quan sát. Nó bổ sung cho [Python SDK](/vi/agenteye/python-sdk): SDK này cung cấp công cụ cho các agent bạn viết, trong khi cách này lấy công việc Codex mà đội ngũ của bạn đã thực hiện — mà không có bất kỳ thay đổi nào về cách họ chạy nó. + +Một bộ thu thập nền nhỏ đọc các bảng ghi phiên Codex cục bộ khi chúng được viết và gửi chúng đến AgentEye. Một bộ thu thập trên mỗi máy sẽ lấy tất cả các bề mặt Codex cục bộ cùng một lúc — không có cách thiết lập cho từng bề mặt. -Một bộ sưu tập nền nhỏ đọc các bản ghi lại phiên làm việc Codex trên máy cục bộ khi chúng được ghi lại và gửi chúng tới AgentEye. Một bộ sưu tập trên mỗi máy sẽ thu thập mọi bề mặt Codex cục bộ cùng một lúc — không cần thiết lập cho từng bề mặt. +Bộ thu thập tương tự cũng lấy các agent khác — xem [OpenClaw](/vi/agenteye/openclaw-capture) và [Hermes](/vi/agenteye/hermes-capture). Bật từng cái bạn chạy; một bộ thu thập có thể lấy nhiều cái cùng một lúc. --- -## Nó thu thập cái gì +## Nó lấy những gì -Mọi bề mặt Codex chạy **cục bộ** đều tạo ra các bản ghi phiên làm việc trên đĩa giống nhau, và bộ sưu tập sẽ nhặt tất cả chúng: +Mỗi bề mặt Codex chạy **cục bộ** sản xuất các bảng ghi phiên trên đĩa giống nhau, và bộ thu thập sẽ lấy tất cả chúng: - Codex **CLI** và `codex exec` -- **VS Code / IDE extension** -- **desktop app**, khi nó chạy một phiên cục bộ +- phần mở rộng **VS Code / IDE** +- **ứng dụng desktop**, khi nó chạy một phiên cục bộ -Mỗi phiên Codex trở thành một AgentEye [session](/vi/agenteye/sessions); các tin nhắn người dùng và trợ lý, lập luận, lệnh gọi công cụ, kết quả công cụ và sử dụng token của nó trở thành các [events](/vi/agenteye/event-stream) tương ứng. Bề mặt mà từng phiên đến (CLI, IDE, hoặc desktop) được ghi lại, vì vậy bạn có thể phân biệt chúng. +Mỗi phiên Codex trở thành một [phiên](/vi/agenteye/sessions) AgentEye; những tin nhắn người dùng và trợ lý, lý luận, lệnh gọi công cụ, kết quả công cụ và mức sử dụng token của nó trở thành các [sự kiện](/vi/agenteye/event-stream) phù hợp. Bề mặt mà mỗi phiên đến từ đó (CLI, IDE hoặc desktop) được ghi lại, vì vậy bạn có thể phân biệt chúng. -> **Các phiên cloud không được thu thập.** Desktop app ngày càng chạy các phiên trong cloud Codex và chỉ giữ siêu dữ liệu của chúng trên máy — không có bản ghi lại cục bộ để đọc. Chỉ các phiên được thực thi cục bộ mới được thu thập. +> **Các phiên cloud không được lấy.** Ứng dụng desktop ngày càng chạy các phiên trong cloud Codex và chỉ giữ lại siêu dữ liệu của chúng trên máy — không có bảng ghi phiên cục bộ để đọc. Chỉ các phiên được thực thi cục bộ mới được lấy. --- -## Bật nó lên +## Bật nó -Chức năng thu thập bị tắt cho đến khi bạn bật nó. Cài đặt bộ sưu tập với khóa API có quyền `events:add` (xem [API keys](/vi/agenteye/api-keys)), và bật chức năng capture Codex: +Capture bị tắt cho đến khi bạn bật nó. Cài đặt bộ thu thập với khóa API có quyền `events:add` (xem [API keys](/vi/agenteye/api-keys)) và bật capture Codex: ```bash curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ | sh -s -- --key --codex-enabled ``` -Cái này cài đặt bộ sưu tập, đăng ký nó như một dịch vụ nền, và bắt đầu thu thập. Xác nhận rằng nó đang chạy: +Điều đó cài đặt bộ thu thập, đăng ký nó như một dịch vụ nền và bắt đầu lấy. Xác nhận rằng nó đang chạy: ```bash agenteye-collector health ``` -Khi chạy lần đầu tiên, các phiên Codex hiện có của bạn sẽ được điền lại một lần và hoạt động mới sau đó được truyền trong vòng vài giây. Các tệp của chính Codex chỉ được đọc — không bao giờ được sửa đổi, di chuyển hoặc xóa — và mỗi phiên được gửi đi đúng một lần, ngay cả khi khởi động lại. +Lần chạy đầu tiên, các phiên Codex hiện có của bạn được điền lại một lần và hoạt động mới sau đó sẽ được phát trong vòng vài giây. Các tệp của chính Codex chỉ được đọc — không bao giờ được sửa đổi, di chuyển hoặc xóa — và mỗi phiên được gửi chính xác một lần, ngay cả trên các lần khởi động lại. --- ## Nó xuất hiện ở đâu -Các phiên được thu thập xuất hiện trong **Sessions**, và các sự kiện của chúng trong luồng **Events**, giống như bất kỳ agent nào khác mà bạn quan sát — vì vậy [session replay](/vi/agenteye/sessions), [search](/vi/agenteye/queries), [evaluations](/vi/agenteye/evaluations), và [alerts](/vi/agenteye/alerts) đều hoạt động trên chúng. Lọc theo agent Codex để xem chúng riêng biệt. +Các phiên được lấy xuất hiện trong **Sessions**, và các sự kiện của chúng trong luồng **Events**, cũng giống như bất kỳ agent nào khác mà bạn quan sát — vì vậy [session replay](/vi/agenteye/sessions), [search](/vi/agenteye/queries), [evaluations](/vi/agenteye/evaluations) và [alerts](/vi/agenteye/alerts) đều hoạt động trên chúng. Lọc theo agent Codex để xem chúng riêng. --- ## Quyền riêng tư -Các bản ghi lại Codex chứa phiên làm việc đầy đủ — bao gồm đầu ra lệnh, nội dung tệp, và bất cứ thứ gì Codex đã đọc hoặc viết — và có thể chứa các bí mật. Các phiên được thu thập được gửi nguyên trạng, vì vậy chỉ bật chức năng capture trên các máy và cho các nhóm nơi tập trung hóa nội dung đó trong AgentEye là thích hợp, và cấp cho bộ sưu tập một khóa được phạm vi chỉ `events:add`. Xem [Security](/vi/agenteye/security) để biết cách dữ liệu của bạn được giữ riêng biệt. \ No newline at end of file +Các bảng ghi Codex chứa toàn bộ phiên — bao gồm đầu ra lệnh, nội dung tệp và bất kỳ thứ gì Codex đã đọc hoặc viết — và có thể chứa bí mật. Các phiên được lấy được gửi nguyên trạng, vì vậy chỉ bật capture trên các máy và cho các đội mà tập trung hóa nội dung đó trong AgentEye là thích hợp, và cấp cho bộ thu thập một khóa với phạm vi `events:add` chỉ. Xem [Security](/vi/agenteye/security) để biết cách dữ liệu của bạn được giữ cách ly. \ No newline at end of file diff --git a/docs/vi/agenteye/hermes-capture.mdx b/docs/vi/agenteye/hermes-capture.mdx new file mode 100644 index 00000000..cf1ccba3 --- /dev/null +++ b/docs/vi/agenteye/hermes-capture.mdx @@ -0,0 +1,53 @@ +--- +title: "Hermes session capture" +description: "Đưa các phiên Hermes gateway của team bạn — Slack, Telegram, CLI, và các lần chạy định kỳ — vào AgentEye dưới dạng các phiên và sự kiện thông thường." +--- + +[Hermes](https://hermes-agent.nousresearch.com) trả lời team bạn từ bất kỳ nơi nào họ đã làm việc — Slack, Telegram, CLI, các lần chạy định kỳ. Hermes session capture đưa tất cả chúng vào AgentEye dưới dạng các phiên và sự kiện thông thường, vì vậy trợ lý mà team bạn nói chuyện mỗi ngày có thể quan sát được cũng như các agent bạn viết. + +Một bộ thu thập nền nhỏ đọc kho lưu trữ phiên cục bộ của Hermes khi nó được viết và gửi các phiên tới AgentEye. Nó hoạt động giống như cách [Codex](/vi/agenteye/codex-capture) và [OpenClaw](/vi/agenteye/openclaw-capture) capture hoạt động, và một bộ thu thập có thể thu thập nhiều cái cùng một lúc. + +--- + +## Nó thu thập những gì + +Mỗi phiên Hermes trên máy được thu thập, bất kể nó đến từ kênh nào. Mỗi cái trở thành một [phiên](/vi/agenteye/sessions) AgentEye; các thông báo người dùng và trợ lý, lệnh gọi công cụ, và kết quả công cụ của nó trở thành các [sự kiện](/vi/agenteye/event-stream) phù hợp. + +Kênh mà phiên bắt đầu từ đó — Slack, Telegram, CLI, hoặc một lần chạy định kỳ — được ghi lại trên phiên, vì vậy bạn có thể phân biệt chúng và lọc xuống một cái một lúc. Cùng với đó là mô hình mà phiên chạy trên, cuộc trò chuyện và người mà nó được bắt đầu từ, và khi một phiên sinh ra một phiên khác, liên kết trở lại cha của nó. + +Các phiên xuất hiện ngay khi Hermes bắt đầu chúng, cho dù bất cứ điều gì đã được nói hay không, và câu trả lời của một lượt và các lệnh gọi công cụ của nó vẫn giữ nguyên theo thứ tự chúng thực sự xảy ra. Khi một phiên kết thúc, bạn cũng nhận được lý do nó kết thúc, chi phí của nó, và bao nhiêu token nó sử dụng. + +--- + +## Bật nó + +Capture bị tắt cho đến khi bạn bật nó. Cài đặt bộ thu thập với một API key có quyền `events:add` (xem [API keys](/vi/agenteye/api-keys)), và bật Hermes capture: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --hermes-enabled +``` + +Điều đó cài đặt bộ thu thập, đăng ký nó như một dịch vụ nền, và bắt đầu thu thập. Xác nhận nó đang chạy: + +```bash +agenteye-collector health +``` + +Đang thu thập nhiều hơn một agent trên cùng một máy? Thêm từng cờ của mỗi cái vào cùng một lệnh — ví dụ `--hermes-enabled --codex-enabled`. + +Khi chạy lần đầu tiên, các phiên Hermes hiện có của bạn được lấp đầy một lần và hoạt động mới sau đó phát trực tuyến trong vòng vài giây. Dữ liệu của Hermes chính nó chỉ bao giờ được đọc — không bao giờ được sửa đổi hoặc xóa — và mỗi thông báo được gửi một lần, ngay cả trên toàn bộ khởi động lại. + +`health` cũng cho bạn biết liệu mọi thứ mà bộ thu thập đã thu thập có thực sự đến AgentEye hay không. Nếu một batch không thể được gửi, nó sẽ được giữ lại và thử lại thay vì bị loại bỏ, và kiểm tra báo cáo không khỏe mạnh trong khi bất cứ điều gì vẫn còn chưa hoàn thành — vì vậy "healthy" có nghĩa là dữ liệu của bạn đã đến, không chỉ là quá trình vẫn hoạt động. + +--- + +## Nó xuất hiện ở đâu + +Các phiên được thu thập xuất hiện trong **Sessions**, và các sự kiện của chúng trong luồng **Events**, giống như bất kỳ agent nào khác bạn quan sát — vì vậy [session replay](/vi/agenteye/sessions), [search](/vi/agenteye/queries), [evaluations](/vi/agenteye/evaluations), và [alerts](/vi/agenteye/alerts) đều hoạt động trên chúng. Lọc theo agent Hermes để xem chúng riêng biệt. + +--- + +## Quyền riêng tư + +Các phiên Hermes chứa toàn bộ bản ghi — bao gồm đầu ra lệnh, nội dung tệp, và bất kỳ điều gì agent đã đọc hoặc viết — và có thể chứa các bí mật. Các phiên được thu thập được gửi nguyên bản, vì vậy chỉ bật capture nơi tập trung nội dung đó trong AgentEye là thích hợp, và cấp cho bộ thu thập một key có phạm vi chỉ là `events:add`. Xem [Security](/vi/agenteye/security) để biết cách dữ liệu của bạn được giữ cô lập. \ No newline at end of file diff --git a/docs/vi/agenteye/openclaw-capture.mdx b/docs/vi/agenteye/openclaw-capture.mdx new file mode 100644 index 00000000..ee282798 --- /dev/null +++ b/docs/vi/agenteye/openclaw-capture.mdx @@ -0,0 +1,50 @@ +--- +--- +title: "Ghi lại phiên làm việc OpenClaw" +description: "Theo dõi các phiên làm việc OpenClaw cục bộ của đội của bạn vào AgentEye dưới dạng các phiên làm việc và sự kiện thông thường — mà không cần thay đổi cách OpenClaw hoạt động." +--- + +Nếu đội của bạn chạy [OpenClaw](https://docs.openclaw.ai), ghi lại phiên làm việc OpenClaw sẽ đưa những phiên làm việc đó vào AgentEye dưới dạng các phiên làm việc và sự kiện thông thường, vì vậy bạn có thể tìm kiếm, phát lại và đánh giá chúng cùng với mọi thứ khác mà bạn quan sát. Nó bổ sung cho [Python SDK](/vi/agenteye/python-sdk): SDK cung cấp công cụ cho các agent mà bạn viết, trong khi tính năng này ghi lại công việc OpenClaw mà đội của bạn đã làm — mà không cần thay đổi cách họ chạy nó. + +Một trình thu thập dữ liệu nền nhỏ đọc các bản ghi phiên làm việc cục bộ của OpenClaw khi chúng được ghi và gửi chúng đến AgentEye. Nó hoạt động theo cách tương tự như [ghi lại Codex](/vi/agenteye/codex-capture), và một trình thu thập có thể ghi lại cả hai cùng một lúc. + +--- + +## Những gì nó ghi lại + +Mọi agent được cấu hình trong cài đặt OpenClaw của một máy đều được ghi lại bởi trình thu thập dữ liệu của máy đó — không cần cài đặt cho từng agent. + +Mỗi phiên làm việc OpenClaw trở thành một [phiên làm việc](/vi/agenteye/sessions) của AgentEye; các tin nhắn của người dùng và trợ lý, lệnh gọi công cụ và kết quả công cụ của nó trở thành các [sự kiện](/vi/agenteye/event-stream) tương ứng. + +--- + +## Bật nó + +Tính năng ghi lại bị tắt cho đến khi bạn bật nó. Cài đặt trình thu thập dữ liệu bằng một khóa API có quyền `events:add` (xem [Khóa API](/vi/agenteye/api-keys)) và bật ghi lại OpenClaw: + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --openclaw-enabled +``` + +Điều này cài đặt trình thu thập dữ liệu, đăng ký nó như một dịch vụ nền và bắt đầu ghi lại. Xác nhận rằng nó đang chạy: + +```bash +agenteye-collector health +``` + +Ghi lại nhiều hơn một agent trên cùng một máy? Thêm cờ của mỗi cái vào cùng một lệnh — ví dụ `--openclaw-enabled --codex-enabled`. + +Khi chạy lần đầu, các phiên làm việc OpenClaw hiện có của bạn sẽ được điền lại một lần và hoạt động mới sẽ được truyền phát trong vòng vài giây. Các tệp của OpenClaw chỉ bao giờ được đọc — không bao giờ được sửa đổi, di chuyển hoặc xóa — và mỗi phiên làm việc được gửi đúng một lần, ngay cả khi khởi động lại. + +--- + +## Nó xuất hiện ở đâu + +Các phiên làm việc được ghi lại xuất hiện trong **Sessions** (Phiên làm việc) và các sự kiện của chúng trong luồng **Events** (Sự kiện), giống như bất kỳ agent nào khác mà bạn quan sát — vì vậy [phát lại phiên làm việc](/vi/agenteye/sessions), [tìm kiếm](/vi/agenteye/queries), [đánh giá](/vi/agenteye/evaluations) và [cảnh báo](/vi/agenteye/alerts) đều hoạt động trên chúng. Lọc theo agent OpenClaw để xem chúng riêng biệt. + +--- + +## Quyền riêng tư + +Các bản ghi phiên làm việc OpenClaw chứa toàn bộ phiên làm việc — bao gồm đầu ra lệnh, nội dung tệp và bất cứ thứ gì agent đã đọc hoặc ghi — và có thể chứa các bí mật. Các phiên làm việc được ghi lại được gửi nguyên vẹn, vì vậy chỉ bật ghi lại trên các máy và cho các đội mà việc tập trung nội dung đó trong AgentEye là phù hợp, và cấp cho trình thu thập dữ liệu một khóa chỉ được giới hạn trong `events:add`. Xem [Security](/vi/agenteye/security) để tìm hiểu cách dữ liệu của bạn được giữ cách ly. \ No newline at end of file diff --git a/docs/zh/agenteye/codex-capture.mdx b/docs/zh/agenteye/codex-capture.mdx index 22950bb9..37bec765 100644 --- a/docs/zh/agenteye/codex-capture.mdx +++ b/docs/zh/agenteye/codex-capture.mdx @@ -1,53 +1,55 @@ --- title: "Codex 会话捕获" -description: "将团队本地的 OpenAI Codex 会话以普通会话和事件的形式同步到 AgentEye，无需改变现有的 Codex 使用方式。" +description: "将团队本地的 OpenAI Codex 会话以普通会话和事件的形式接入 AgentEye，无需改变他们运行 Codex 的方式。" --- -你的工程师每天都在使用 OpenAI Codex。Codex 会话捕获功能可以将这些编码会话作为普通会话和事件引入 AgentEye，让你能够与其他所有被观测内容一起进行搜索、回放和评估。它与 [Python SDK](/zh/agenteye/python-sdk) 相辅相成：SDK 用于对你自己编写的 Agent 进行埋点，而此功能则捕获团队日常使用 Codex 产生的内容——无需改变任何使用方式。 +你的工程师每天都在使用 OpenAI Codex。Codex 会话捕获功能将这些编码会话以普通会话和事件的形式引入 AgentEye，让你可以与其他观测内容一起搜索、回放和评估。它与 [Python SDK](/zh/agenteye/python-sdk) 形成互补：SDK 用于对你自己编写的 Agent 进行埋点，而这项功能则捕获团队日常使用 Codex 的工作——无需改变他们的任何使用习惯。 -一个轻量的后台采集器会在 Codex 写入本地会话记录时实时读取并上传至 AgentEye。每台机器只需部署一个采集器，即可覆盖所有本地 Codex 入口，无需逐个配置。 +一个轻量后台采集器会实时读取 Codex 写入本地的会话记录，并将其推送至 AgentEye。每台机器部署一个采集器即可覆盖所有本地 Codex 界面，无需逐界面配置。 + +同一个采集器也能捕获其他 Agent——参见 [OpenClaw](/zh/agenteye/openclaw-capture) 和 [Hermes](/zh/agenteye/hermes-capture)。根据需要逐一启用，单个采集器可同时捕获多个来源。 --- ## 捕获内容 -所有**本地**运行的 Codex 入口均会产生相同的磁盘会话记录，采集器会统一采集： +所有**本地**运行的 Codex 界面都会产生相同的本地会话记录，采集器会统一读取： - Codex **CLI** 及 `codex exec` - **VS Code / IDE 扩展** -- **桌面应用**（仅限本地运行会话时） +- **桌面应用**（在本地运行会话时） -每个 Codex 会话将成为 AgentEye 中的一个[会话](/zh/agenteye/sessions)；其中的用户消息、助手消息、推理过程、工具调用、工具结果及 Token 用量将对应转化为[事件](/zh/agenteye/event-stream)。每个会话的来源（CLI、IDE 或桌面应用）均会被记录，便于区分。 +每个 Codex 会话会成为 AgentEye 的一个[会话](/zh/agenteye/sessions)；其用户消息、助手消息、推理过程、工具调用、工具结果和 Token 用量会转化为对应的[事件](/zh/agenteye/event-stream)。每个会话的来源（CLI、IDE 或桌面端）均会被记录，便于区分。 -> **云端会话不在捕获范围内。** 桌面应用越来越多地在 Codex 云端运行会话，本地仅保留元数据，不存在本地记录可供读取。仅本地执行的会话才会被捕获。 +> **云端会话不在捕获范围内。** 桌面应用越来越多地在 Codex 云端运行会话，本地仅保留元数据，没有可供读取的本地记录。仅本地执行的会话会被捕获。 --- -## 开启方式 +## 开启捕获 -捕获功能默认关闭，需手动启用。请使用具有 `events:add` 权限的 API 密钥（参见 [API 密钥](/zh/agenteye/api-keys)）安装采集器并开启 Codex 捕获： +捕获功能默认关闭，需主动启用。使用拥有 `events:add` 权限的 API 密钥（参见 [API keys](/zh/agenteye/api-keys)）安装采集器，并开启 Codex 捕获： ```bash curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ | sh -s -- --key --codex-enabled ``` -该命令将安装采集器、将其注册为后台服务并立即开始捕获。确认运行状态： +该命令会安装采集器、将其注册为后台服务并立即开始捕获。确认服务正在运行： ```bash agenteye-collector health ``` -首次运行时，已有的 Codex 会话会被补录一次，此后的新活动将在数秒内实时上报。采集器仅读取 Codex 的本地文件，不会修改、移动或删除任何内容，且每个会话只会上传一次，即便服务重启也不会重复。 +首次运行时，已有的 Codex 会话会被回填一次，此后新产生的活动将在数秒内实时同步。采集器对 Codex 的本地文件只读不写——不会修改、移动或删除任何文件，且每个会话只推送一次，重启后也不会重复。 --- -## 数据展示位置 +## 查看位置 -捕获的会话将出现在 **Sessions** 中，对应事件出现在 **Events** 流中，与其他任何被观测的 Agent 完全一致——因此[会话回放](/zh/agenteye/sessions)、[搜索](/zh/agenteye/queries)、[评估](/zh/agenteye/evaluations)和[告警](/zh/agenteye/alerts)均可对其使用。通过筛选 Codex Agent 即可单独查看这些内容。 +捕获的会话会出现在 **Sessions** 中，其事件会出现在 **Events** 流中，与其他被观测的 Agent 完全一致——[会话回放](/zh/agenteye/sessions)、[搜索](/zh/agenteye/queries)、[评估](/zh/agenteye/evaluations)和[告警](/zh/agenteye/alerts)均可正常使用。通过筛选 Codex Agent 即可单独查看其会话。 --- ## 隐私说明 -Codex 会话记录包含完整的会话内容，包括命令输出、文件内容以及 Codex 读写的所有数据，可能含有敏感信息。捕获的会话将原样上传，因此请仅在适合将相关内容集中存储于 AgentEye 的机器和团队中启用此功能，并将采集器的密钥权限限定为 `events:add`。数据隔离方式详见[安全说明](/zh/agenteye/security)。 \ No newline at end of file +Codex 会话记录包含完整的会话内容——包括命令输出、文件内容以及 Codex 读写的所有数据——可能含有敏感信息。捕获的会话会原样上传，因此请仅在适合将此类内容集中存储至 AgentEye 的机器和团队中启用捕获功能，并为采集器使用仅具有 `events:add` 权限的密钥。有关数据隔离机制，请参见 [Security](/zh/agenteye/security)。 \ No newline at end of file diff --git a/docs/zh/agenteye/hermes-capture.mdx b/docs/zh/agenteye/hermes-capture.mdx new file mode 100644 index 00000000..020ac405 --- /dev/null +++ b/docs/zh/agenteye/hermes-capture.mdx @@ -0,0 +1,53 @@ +--- +title: "Hermes 会话捕获" +description: "将你团队的 Hermes 网关会话——包括 Slack、Telegram、CLI 和定时任务——作为普通会话和事件引入 AgentEye。" +--- + +[Hermes](https://hermes-agent.nousresearch.com) 在你的团队已经习惯使用的任何地方为他们提供支持——Slack、Telegram、CLI、定时任务。Hermes 会话捕获将所有这些内容以普通会话和事件的形式引入 AgentEye，让你的团队每天交互的助手与你自己编写的 Agent 一样可观测。 + +一个小型后台采集器会实时读取 Hermes 在本地写入的会话存储，并将会话传送至 AgentEye。其工作方式与 [Codex](/zh/agenteye/codex-capture) 和 [OpenClaw](/zh/agenteye/openclaw-capture) 捕获相同，一个采集器可以同时捕获多个来源。 + +--- + +## 捕获内容 + +机器上的每个 Hermes 会话都会被捕获，无论来自哪个渠道。每个会话都会成为 AgentEye 中的一个[会话](/zh/agenteye/sessions)；其用户消息、助手消息、工具调用及工具结果将成为对应的[事件](/zh/agenteye/event-stream)。 + +会话的来源渠道——Slack、Telegram、CLI 或定时任务——会被记录在会话上，方便你区分和按渠道筛选。同时记录的还有该会话使用的模型、发起会话的聊天窗口和用户，以及当一个会话派生出子会话时，指向其父会话的链接。 + +会话一旦被 Hermes 启动就会立即出现，无论是否已有任何消息。一轮对话的回复和工具调用会按实际发生的顺序保留。当会话结束时，你还能看到会话结束的原因、消耗的费用以及使用的 token 数量。 + +--- + +## 如何启用 + +捕获功能默认关闭，需手动启用。使用具有 `events:add` 权限的 API 密钥安装采集器（参见 [API 密钥](/zh/agenteye/api-keys)），并开启 Hermes 捕获： + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --hermes-enabled +``` + +该命令会安装采集器、将其注册为后台服务，并开始捕获。确认服务正在运行： + +```bash +agenteye-collector health +``` + +需要在同一台机器上捕获多个 Agent？在同一命令中添加各自的标志，例如 `--hermes-enabled --codex-enabled`。 + +首次运行时，现有的 Hermes 会话会被一次性回填，此后新的活动将在数秒内实时推送。Hermes 自身的数据只会被读取，不会被修改或删除；即使采集器重启，每条消息也只会被发送一次。 + +`health` 命令还会告诉你采集器捕获的内容是否确实到达了 AgentEye。如果某批数据无法送达，它会被保留并重试，而不是丢弃；只要还有未发送的数据，健康检查就会报告为不健康——因此"健康"意味着你的数据已成功到达，而不仅仅是进程在运行。 + +--- + +## 数据展示位置 + +捕获的会话会出现在 **Sessions** 中，其事件出现在 **Events** 流中，与任何其他被观测的 Agent 完全一致——因此[会话回放](/zh/agenteye/sessions)、[搜索](/zh/agenteye/queries)、[评估](/zh/agenteye/evaluations)和[告警](/zh/agenteye/alerts)均可对其使用。按 Hermes Agent 筛选即可单独查看。 + +--- + +## 隐私说明 + +Hermes 会话包含完整的对话记录——包括命令输出、文件内容以及 Agent 读取或写入的任何内容——可能含有敏感信息。捕获的会话会原样发送，因此请仅在将此类内容集中存入 AgentEye 合适的场景下启用捕获，并为采集器提供仅限 `events:add` 权限的密钥。有关数据隔离方式，请参阅[安全性](/zh/agenteye/security)。 \ No newline at end of file diff --git a/docs/zh/agenteye/openclaw-capture.mdx b/docs/zh/agenteye/openclaw-capture.mdx new file mode 100644 index 00000000..e2a059f6 --- /dev/null +++ b/docs/zh/agenteye/openclaw-capture.mdx @@ -0,0 +1,49 @@ +--- +title: "OpenClaw 会话捕获" +description: "将团队本地 OpenClaw 会话以普通会话和事件的形式同步到 AgentEye — 无需改变 OpenClaw 的运行方式。" +--- + +如果你的团队使用 [OpenClaw](https://docs.openclaw.ai)，OpenClaw 会话捕获功能可将这些会话作为普通会话和事件引入 AgentEye，让你可以像查看其他观测数据一样对它们进行搜索、回放和评估。它与 [Python SDK](/zh/agenteye/python-sdk) 相辅相成：SDK 用于对你自己编写的 Agent 进行埋点，而此功能则捕获团队日常使用 OpenClaw 的工作内容——无需改变任何使用习惯。 + +一个轻量级后台采集器会实时读取 OpenClaw 在本地写入的会话记录，并将其发送至 AgentEye。其工作方式与 [Codex 捕获](/zh/agenteye/codex-capture) 相同，且单个采集器可同时捕获两者。 + +--- + +## 捕获内容 + +机器上 OpenClaw 配置中的每个 Agent 都会被该机器的采集器捕获，无需逐个 Agent 进行配置。 + +每个 OpenClaw 会话将成为 AgentEye 中的一个[会话](/zh/agenteye/sessions)；其中的用户消息、助手消息、工具调用及工具结果将转换为对应的[事件](/zh/agenteye/event-stream)。 + +--- + +## 开启方式 + +捕获功能默认关闭，需手动启用。使用具有 `events:add` 权限的 API 密钥安装采集器（参见 [API 密钥](/zh/agenteye/api-keys)），并开启 OpenClaw 捕获： + +```bash +curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \ + | sh -s -- --key --openclaw-enabled +``` + +此命令将安装采集器、将其注册为后台服务并开始捕获。确认其正常运行： + +```bash +agenteye-collector health +``` + +需要在同一台机器上捕获多个 Agent？在同一命令中添加各自的标志即可，例如 `--openclaw-enabled --codex-enabled`。 + +首次运行时，现有的 OpenClaw 会话将被回填一次，此后新产生的活动将在数秒内实时同步。OpenClaw 的本地文件仅供读取，绝不会被修改、移动或删除，且每个会话即使在重启后也只会被发送一次。 + +--- + +## 查看位置 + +捕获的会话显示在 **Sessions** 中，其事件显示在 **Events** 流中，与其他受监测的 Agent 完全一致——因此[会话回放](/zh/agenteye/sessions)、[搜索](/zh/agenteye/queries)、[评估](/zh/agenteye/evaluations)和[告警](/zh/agenteye/alerts)均可对其生效。通过筛选 OpenClaw Agent 可单独查看这些数据。 + +--- + +## 隐私说明 + +OpenClaw 的会话记录包含完整的会话内容——包括命令输出、文件内容以及 Agent 读取或写入的任何信息——可能涉及敏感数据。捕获的会话将原样发送，因此请仅在适合将相关内容集中存储至 AgentEye 的机器和团队中启用捕获功能，并为采集器提供仅限 `events:add` 权限的密钥。数据隔离方式详见[安全说明](/zh/agenteye/security)。 \ No newline at end of file