Мощная защита для AI-агентов - Открытое обеспечение безопасности и отслеживание затрат для AI-приложений
SDK безопасности и управления AI-агентами
Детерминированное управление, защитные барьеры, отслеживание затрат и управление политиками для LLM-приложений. Открытый исходный код. TypeScript + Python. Работает с любым провайдером.
Веб-сайт · Документация · Примеры · Discord · Участие
Установка: 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');
I need the actual content to translate. Please provide the input text for chunk 3.```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)
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, ... }
```
Please provide the Markdown content to translate.```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 провайдерам, структурированный журнал аудита с ID корреляции, поведенческий базовый уровень (P50/P95/P99), обнаружение PII в режиме 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 Governance Dashboard" width="900">
</div>
**Что вы видите с первого взгляда:**
- **Строка KPI** — общее количество запросов, стоимость, отказы по управлению, потребление бюджета с цветовыми индикаторами
- **Скорость затрат и прогноз бюджета** — тенденции расхода и прогноз исчерпания
- **Конвейер защиты** — 3-этапный процесс оценки безопасности с показателями короткого замыкания и задержкой на каждом этапе
- **Канареечные оповещения** — обнаружение поведенческих отклонений с статусом заморозки агента и процентами отклонений
- **Матрица агентов** — таблица состояния парка (активен/в ожидании/заморожен) с метриками запросов на агента
- **Экономия затрат** — рекомендации по оптимизации, ранжированные по влиянию
- **Маршрутизация моделей** — маршрутизация от источника к цели с экономией на запрос
- **Управление протоколами** — карточки политик ENFORCE/MONITOR/REPORT_ONLY с количеством отказов
Каждая панель получает данные независимо с изоляцией ошибок — отказ одного виджета никогда не приводит к каскадным сбоям.
Запуск локально: `cd dashboard/api && npm run dev` затем `cd dashboard/web && npm run dev` (API на :3100, UI на :3000)
### Путь постепенного раскрытия
| Уровень | Точка входа | Что вы получаете |
|-------|-------------|--------------|
| 0 | `observe(client)` | Отслеживание стоимости, журнал аудита, обнаружение PII, поведенческий базовый уровень, аварийный выключатель |
| 1 | + guardrails config | Инъекция подсказок, модерация контента, обнаружение секретов |
| 2 | + TealEngine policies | ENFORCE/MONITOR/REPORT_ONLY для каждого правила, детерминированные решения |
| 3 | + TealFlow workflows | Наследование управления на уровне организации, декларативный 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`
В отличие от вероятностных фильтров безопасности, TealTiger использует **детерминированную оценку политик**: одинаковый ввод + одинаковая политика = одинаковое решение, каждый раз. Каждый вердикт управления может быть воссоздан, отслежен до человека, написавшего политику, и экспортирован в виде структурированных доказательств (SARIF, JUnit XML, JSON).
**Ключевой принцип:** Управление должно быть инженерным свойством, встроенным в среду выполнения, а не документом, просматриваемым после события.
---
## 🚀 Быстрый старт
### TypeScript```bash
npm install tealtiger
```
Please provide the Markdown content to translate.```typescript
import { TealOpenAI } from 'tealtiger';
```