حماية قوية لوكلاء الذكاء الاصطناعي - أمان وتتبع تكلفة مفتوح المصدر لتطبيقات الذكاء الاصطناعي
SDK أمان وكلاء الذكاء الاصطناعي والحوكمة
حوكمة حتمية، حواجز أمان، تتبع التكاليف، وإدارة السياسات لتطبيقات النماذج اللغوية الكبيرة. مفتوح المصدر. تايب سكريبت وبايثون. يعمل مع أي مزود.
الموقع الإلكتروني · التوثيق · أمثلة · ديسكورد · المساهمة
التثبيت: npm install tealtiger أو pip install tealtiger، ثم غلف استدعاء OpenAI موجود واحد:```typescript
import { TealOpenAI } from 'tealtiger';
const client = new TealOpenAI({ apiKey: process.env.OPENAI_API_KEY, guardrails: { promptInjection: true } });
const res = await client.chat.completions.create({ model: 'gpt-4o-mini', messages: [{ role: 'user', content: 'Hello!' }] });
console.log(res.security?.decision ?? 'ALLOW');
يرجى تزويدي بمحتوى الماركدون المراد ترجمته.```python
import os
from tealtiger import TealOpenAI
client = TealOpenAI(api_key=os.environ["OPENAI_API_KEY"], guardrails={"prompt_injection": True})
print(client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "Hello!"}]).security.decision)
[No input content provided to translate.]```text ALLOW Governance receipt emitted; cost and guardrails tracked.
التالي: [دليل البدء السريع الكامل](#-quick-start) و[أمثلة](https://github.com/agentguard-ai/tealtiger/blob/main/examples).
---
## 🔭 observe() — أداة الرصد بدون إعدادات (v1.4)
سطر واحد يضيف تتبع التكاليف، وتسجيل التدقيق، وكشف المعلومات الشخصية (PII)، وخطوط الأساس السلوكية لأي عميل LLM. لا ملفات تهيئة، ولا تعريفات سياسات.```typescript
import { observe, freeze } from 'tealtiger';
const client = observe(new OpenAI()); // done — all calls are now instrumented
console.log(client.getCost()); // { totalCost: 0.0023, requestCount: 1, ... }
[!WARNING] هذه الأداة لأغراض التطوير فقط! اختبرها في بيئات آمنة قبل النشر إلى الإنتاج.
📢 انضم إلى خادم ديسكورد للدعم والتحديثات.
💡 طلبات الميزات؟ افتح مشكلة في GitHub مع وسم enhancement.
🐛 وجدت خطأ؟ افتح مشكلة مع وسم bug.
📖 دليل المساهمة: اطلع هنا.
🔒 سياسة الأمان: اقرأ سياسة الأمان.
هذا المشروع مرخص بموجب رخصة جنو العمومية v3.0 – أنت حر في استخدام وتعديل وتوزيع هذه الأداة طالما تبقيها مفتوحة المصدر وتحت نفس الترخيص.
⚠️ تنبيه: هذا المشروع غير مرتبط أو معتمد أو مدعوم من OnlyFans. إنها أداة مستقلة أُنشئت لأغراض تعليمية وبحثية فقط.```python from tealtiger.observe import observe, freeze client = observe(OpenAI()) # done — all calls are now instrumented print(client.get_cost()) # ObserveCostSummary(total_cost=0.0023, ...)
**ما تحصل عليه تلقائيًا:** تتبع التكلفة لكل طلب عبر 12 مزودًا، سجل تدقيق منظم مع معرفات الارتباط، خط أساس سلوكي (P50/P95/P99)، اكتشاف المعلومات الشخصية في وضع REPORT_ONLY، ومفتاح إيقاف فوري عبر `freeze()`. زمن استجابة أقل من 5 مللي ثانية لكل استدعاء.
انظر [examples/observe-quickstart.ts](https://github.com/agentguard-ai/tealtiger/blob/main/examples/observe-quickstart.ts) و[examples/observe_quickstart.py](https://github.com/agentguard-ai/tealtiger/blob/main/examples/observe_quickstart.py).
---
---
## 📊 لوحة التحكم للحوكمة (v1.4)
رؤية فورية لأسطول وكلاء الذكاء الاصطناعي الخاص بك — الوضع الأمني، حوكمة التكلفة، وتنبيهات السلوك في نافذة واحدة.
<div align="center">
<img src="https://assets.kitploit.com/production/public/readmes/12842/41f95973c706522c5b907a5d7d96565247adff159a2de9a15c45087ae8dd1351.png" alt="TealTiger لوحة التحكم للحوكمة" width="900">
</div>
**ما تراه في لمحة:**
- **صف KPI** — إجمالي الطلبات، التكلفة، حالات رفض الحوكمة، استهلاك الميزانية مع مؤشرات مرمّزة بالألوان
- **سرعة التكلفة وتوقعات الميزانية** — اتجاهات معدل الاستهلاك وإسقاط النفاد
- **خط أنابيب الدفاع** — تدفق تقييم أمني من 3 مراحل مع معدلات الدائرة القصيرة وزمن الاستجابة لكل مرحلة
- **تنبيهات الكناري** — اكتشاف الانحراف السلوكي مع حالة تجميد الوكيل ونسب الانحراف
- **مصفوفة الوكلاء** — جدول حالة الأسطول (نشط/خامل/متجمد) مع مقاييس الطلبات لكل وكيل
- **توفير التكاليف** — توصيات التحسين مرتبة حسب الأثر
- **توجيه النموذج** — توجيه المصدر إلى الهدف مع توفير لكل طلب
- **حوكمة البروتوكول** — بطاقات سياسة ENFORCE/MONITOR/REPORT_ONLY مع أعداد الرفض
كل لوحة تجلب بياناتها بشكل مستقل مع عزل الأعطال — فشل عنصر واجهة واحد لا ينتقل أبدًا إلى العناصر الأخرى.
للتشغيل المحلي: `cd dashboard/api && npm run dev` ثم `cd dashboard/web && npm run dev` (API على :3100، واجهة المستخدم على :3000)
### مسار الكشف التدريجي
| المستوى | نقطة الدخول | ما تحصل عليه |
|---------|-------------|--------------|
| 0 | `observe(client)` | تتبع التكلفة، سجل التدقيق، اكتشاف المعلومات الشخصية، خط الأساس السلوكي، مفتاح الإيقاف |
| 1 | + guardrails config | حقن الأوامر، الاعتدال في المحتوى، اكتشاف الأسرار |
| 2 | + سياسات TealEngine | ENFORCE/MONITOR/REPORT_ONLY لكل قاعدة، قرارات حتمية |
| 3 | + سير عمل TealFlow | توريث حوكمة على مستوى المؤسسة، YAML تصريحي |
## ما هو TealTiger؟
TealTiger هو SDK مفتوح المصدر يوفر **حوكمة حتمية** لوكلاء الذكاء الاصطناعي. يفرض السياسات الأمنية، يتتبع التكاليف، وينتج أدلة منظمة — كل ذلك في وقت التشغيل، دون الحاجة إلى أي بنية تحتية.
> **هل تبحث عن الكود المصدري؟** هذا هو المستودع المحوري. كود SDK موجود في المستودعات الخاصة بكل لغة:
> - **TypeScript SDK**: [tealtiger-typescript-prod](https://github.com/agentguard-ai/tealtiger-typescript-prod)
> - **Python SDK**: [tealtiger-python-prod](https://github.com/agentguard-ai/tealtiger-python-prod)
>
> أو استنساخ هذا المستودع مع الوحدات الفرعية: `git clone --recurse-submodules https://github.com/agentguard-ai/tealtiger.git`