### 💰 社内ネットワークでフィッシングメールをばらまく必要がありますか？問題ありません！ 

**BEC およびフィッシング**テストも、無限のシナリオの1つです。電子メール（BEC）攻撃シナリオのコンテンツを生成する際には、部分的な **AI 自動化** 機能も利用できます。従業員名を **Reaper** に送信すると、スタイルとコンテンツが自動的に選択されます。また、カスタム **SMTP** サーバーを設定する柔軟性など、さらに多くの機能があります！```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)

Next: [完全なクイックスタート](#-quick-start) と [例](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples).

---

## 🔭 observe() — ゼロ設定インストルメンテーション (v1.4)

一行追加するだけで、任意のLLMクライアントにコスト追跡、監査ログ、PII検出、動作ベースラインを追加できます。設定ファイルもポリシー定義も不要です。```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, ... }

**自動で得られるもの:** 12プロバイダにわたるリクエスト単位のコスト追跡、相関ID付きの構造化監査ログ、行動ベースライン（P50/P95/P99）、REPORT_ONLYモードでのPII検出、`freeze()`による即時停止機能。1コールあたり5ms未満のオーバーヘッド。

[examples/observe-quickstart.ts](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples/observe-quickstart.ts) と [examples/observe_quickstart.py](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples/observe_quickstart.py) を参照。

---

---

## 📊 ガバナンスダッシュボード (v1.4)

AIエージェント群のリアルタイム可視化 — セキュリティ態勢、コストガバナンス、行動アラートを一画面で。

<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 ポリシーカードと拒否数

すべてのパネルは独立してデータを取得し、障害分離されています。1つのウィジェットの障害が他に波及することはありません。

ローカル実行: `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 ポリシー | ルールごとの ENFORCE/MONITOR/REPORT_ONLY、決定論的な判断 |
| 3 | + TealFlow ワークフロー | 組織レベルのガバナンス継承、宣言的YAML |



## TealTiger とは

TealTiger は、AIエージェントに**決定論的ガバナンス**を提供するオープンソース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

### Python```bash
pip install tealtiger

---

## ✨ 機能

### 🛡️ セキュリティガードレール
- **PII検出** — 機密情報を自動的に検出・編集
- **プロンプトインジェクション防止** — 悪意のあるプロンプトインジェクション試行をブロック
- **コンテンツモデレーション** — 有害または不適切なコンテンツをフィルタリング
- **機密情報検出** — 9カテゴリ500以上のパターンを信頼度スコア付きで検出
- **カスタムルール** — 独自のセキュリティポリシーを定義

### 💰 コストガバナンス
- **予算執行管理** — リクエスト、セッション、1日あたりのハードリミット
- **コスト追跡** — 全プロバイダにわたるリアルタイム監視
- **コストアラート** — 設定可能なしきい値での通知
- **サーキットブレーカー** — コストの暴走ループを自動的に防止

### 🔌 12のLLMプロバイダ
- **OpenAI** — GPT-4、GPT-4o、GPT-3.5
- **Anthropic** — Claude 3.5、Claude 3
- **Google Gemini** — マルチモーダル対応
- **AWS Bedrock** — Claude、Titan、Jurassic、Command、Llama
- **Azure OpenAI** — デプロイメントベースのルーティング
- **Cohere** — チャット、RAG、埋め込み
- **Mistral AI** — 欧州データレジデンシー
- **DeepSeek** — コスト効率の高い推論モデル
- **Groq** — 超低レイテンシ推論
- **Together AI** — オープンソースモデルホスティング
- **HuggingFace TGI** — セルフホスト推論
- **xAI（Grok）** — リアルタイムナレッジ

### 🔌 プラットフォームアダプタ
- **AWS Bedrock Agents** — ネイティブガードレールアダプタ
- **AWS AgentCore** — アクション前後ガバナンスプラグイン
- **Azure AI Agent Service** — ツール呼び出しパイプラインミドルウェア

### 🏗️ ガバナンスアーキテクチャ
- **決定論的ポリシー評価** — ガバナンス経路にLLMを使用しない
- **構造化エビデンス** — すべての判定が再構成可能な記録を生成
- **暗号証明** — マークルツリー + RFC 3161タイムスタンプ（TealProof）
- **非人間アイデンティティ（NHI）** — エージェントライフサイクル、スコープ適用、ゼロ常時権限
- **FREEZEルール** — 改ざん検出付きの不変緊急キルスイッチ
- **相関ID** — 判定チェーン全体のエンドツーエンドトレーサビリティ
- **ポリシートレーサビリティ** — すべての判定が人間のポリシー作成者に遡れる
- **OWASP Agentic Top 10** — 10のASIリスクすべてをカバーするゼロ設定ポリシーパック

---

## 🗺️ ガバナンスカバレッジ

| 次元 | 機能 | モジュール |
|-----------|-------------|--------|
| 🛡️ **セキュリティ** | 機密情報検出（500以上のパターン）、プロンプトインジェクション、PII、コンテンツモデレーション、Unicode正規化、エンコード出力検出 | `TealSecrets` `TealGuard` |
| 🔑 **アイデンティティ** | 非人間アイデンティティライフサイクル、スコープ適用、ゼロ常時権限、エージェントアテステーション | `TealEngine (NHI)` |
| ⚡ **信頼性** | サーキットブレーカー、リトライバジェット、フォールバックチェーン、決定論的劣化 | `TealCircuit` `TealReliability` |
| 🧠 **メモリ** | 書き込み証明、命令インジェクション検出、情報流出防止、スコープ適用 | `TealMemory` |
| 💰 **コスト** | ガバナンスが所有する上限額、異常検出、推論トークンバジェット、エージェント別帰属 | `TealMonitor` |
| 📋 **エビデンス** | 暗号レシート（マークル+RFC 3161）、SARIFエクスポート、OpenTelemetryスパン、SIEM統合 | `TealProof` `TealAudit` |
| ⚙️ **ポリシー** | FREEZEルール、PLAN_ONLYモード、ホットスワップバンドル、改ざん防止、自動化レベル | `TealEngine` |
| 🔄 **ワークフロー** | 宣言型YAMLガバナンスワークフロー、組織レベルの継承、フロア施行 | `TealFlow` |
| 📊 **ドリフト** | 行動ドリフト検出、統計ベースライン、モデル出力回帰 | `TealDrift` |
| ⏱️ **時間的制御** | セッションTTL、クールダウン期間、時間帯制限 | `TealTemporal` |
| 🔍 **レジストリ** | MCP定義ドリフト監視、ツール記述スキャン、アダプタ構成許可リスト | `TealRegistry` |
| 🧠 **分類** | ローカルONNX ML推論（≤20ms）、アンサンブルモード、正規表現+MLの組み合わせ | `TealClassifier` |

> **設計原則：** ガバナンス経路にLLMを使用しません。同じ入力＋同じポリシー＝同じ判定、毎回同じです。

---

## 📦 SDK

| 言語 | ソースコード | パッケージ | インストール |
|----------|------------|---------|---------|
| TypeScript | [tealtiger-typescript-prod](https://github.com/agentguard-ai/tealtiger-typescript-prod) | [npm](https://www.npmjs.com/package/tealtiger) | `npm install tealtiger` |
| Python | [tealtiger-python-prod](https://github.com/agentguard-ai/tealtiger-python-prod) | [PyPI](https://pypi.org/project/tealtiger/) | `pip install tealtiger` |

### 🔌 フレームワークアダプタ

| フレームワーク | パッケージ | インストール |
|-----------|---------|---------|
| LangChain | [langchain-tealtiger](https://github.com/agentguard-ai/tealtiger/tree/main/packages/langchain-tealtiger) | `pip install langchain-tealtiger` |
| Vercel AI SDK | [tealtiger-ai-sdk](https://github.com/agentguard-ai/tealtiger/tree/main/packages/tealtiger-ai-sdk) | `npm install tealtiger-ai-sdk` |
| PydanticAI | [pydanticai-tealtiger](https://github.com/agentguard-ai/tealtiger/tree/main/packages/pydanticai-tealtiger) | `pip install pydanticai-tealtiger` |
| Haystack | [haystack-tealtiger](https://github.com/agentguard-ai/tealtiger/tree/main/packages/haystack-tealtiger) | `pip install haystack-tealtiger` |
| CAMEL-AI | [camelai-tealtiger](https://github.com/agentguard-ai/tealtiger/tree/main/packages/camelai-tealtiger) | `pip install camelai-tealtiger` |

### 🔗 インフラストラクチャ統合

| プラットフォーム | 提供内容 | インストール |
|----------|-----------------|---------|
| [Dakera](https://github.com/Dakera-AI/dakera-py) | 永続的なガバナンス状態バックエンド（コスト保存、判定レシート、KGによる委任チェーン） | `pip install dakera[tealtiger]` | [ドキュメント](https://dakera.ai/integrations/tealtiger) |
| [AG2 Beta](https://github.com/ag2ai/ag2) | AG2 Betaエージェント向けガバナンスミドルウェア拡張 | `pip install ag2-tealtiger` |
| [Portkey Gateway](https://github.com/Portkey-AI/gateway) | Portkey AI Gateway向けWebhookガードレール | [例](https://github.com/agentguard-ai/tealtiger/tree/main/examples/portkey-webhook-guardrail) |
| [Daytona](https://github.com/daytonaio/daytona) | サンドボックス化されたコード実行の事前実行ガバナンス | [例](https://github.com/agentguard-ai/tealtiger/tree/main/examples/daytona-governed-sandbox) |

---

## 📚 ドキュメント

- [なぜあなたのAIエージェントに予算が必要か — LLMアプリのためのコストガバナンス](https://github.com/agentguard-ai/tealtiger/blob/HEAD/docs/blog/cost-governance-for-llm-apps.md)
- [OWASP Agentic Top 10 — TealTigerによる実践的防御](https://github.com/agentguard-ai/tealtiger/blob/HEAD/docs/blog/owasp-agentic-top-10-defenses.md)
- [クイックスタートガイド](#-quick-start)
- [セキュリティガードレール](#️-security-guardrails)
- [コストガバナンス](#-cost-governance)
- [プロバイダ設定](#-7-llm-providers)
- [FAQ](https://github.com/agentguard-ai/tealtiger/blob/HEAD/docs/faq.md)
- [なぜTealTigerなのか](https://github.com/agentguard-ai/tealtiger/blob/HEAD/docs/why-tealtiger.md)
- [クロスSDK機能パリティマトリックス](https://github.com/agentguard-ai/tealtiger/blob/HEAD/docs/cross-sdk-feature-parity-matrix.md)
- [ガバナンスイベントストアインデックス](https://github.com/agentguard-ai/tealtiger/blob/HEAD/docs/governance-event-store-indexes.md)
- [エラーコードリファレンス](https://github.com/agentguard-ai/tealtiger/blob/HEAD/docs/error-code-reference.md)
- [トラブルシューティング](https://github.com/agentguard-ai/tealtiger/blob/HEAD/docs/troubleshooting.md)
- [コントリビューションガイド](https://github.com/agentguard-ai/tealtiger/blob/HEAD/CONTRIBUTING.md)
- [セキュリティポリシー](https://github.com/agentguard-ai/tealtiger/blob/HEAD/SECURITY.md)
- [行動規範](https://github.com/agentguard-ai/tealtiger/blob/HEAD/CODE_OF_CONDUCT.md)
- [ロードマップ](https://github.com/agentguard-ai/tealtiger/blob/HEAD/ROADMAP.md)

### バッジ

TealTigerバッジを使用して、プロジェクトが決定論的なエージェントセキュリティおよびコストポリシーによって管理されていることを示します。

ライトバッジ：```md
[![Governed by TealTiger](https://raw.githubusercontent.com/agentguard-ai/tealtiger/main/assets/badges/governed-by-tealtiger.svg)](https://github.com/agentguard-ai/tealtiger)

### Python Hugging Face TGI クイックスタート

ガード付きのHugging Face Text Generation InferenceプロバイダーをPython SDKから試すには、`examples/python/huggingface_tgi_quickstart.py`を使用してください。```bash
export HF_API_TOKEN="your-hugging-face-token"
export HF_TGI_ENDPOINT="https://your-endpoint.endpoints.huggingface.cloud"
export HF_TGI_MODEL="meta-llama/Meta-Llama-3.1-8B-Instruct"

python examples/python/huggingface_tgi_quickstart.py

YAMLポリシーの場合は、エディタのYAMLスキーママッピングを設定し、`tealtiger-policy.yml`などのポリシーファイルを`./schemas/tealtiger-policy.schema.json`にポイントするようにしてください。

### Validate Policy Files

ポリシーバリデータスクリプトを使用して、TealTigerポリシーのJSONファイルをCI/CDやランタイムガバナンスで使用する前に検証してください：```bash
npm install
npx ts-node scripts/validate-policy.ts ./my-policy.json

バリデーターは [`schemas/tealtiger-policy.schema.json`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/schemas/tealtiger-policy.schema.json) を読み込み、スキーマ検証エラーを出力し、ポリシーが有効な場合は終了コード0で終了し、無効な場合は終了コード1で終了します。

---

## 🐯 私たちと一緒に構築する — アーリーコントリビュータープログラム

TealTigerはオープンソースであり、AIエージェントガバナンスの未来を形作る初期の貢献者を求めています。

### あなたが取り組めること

| 分野 | 例 | 難易度 |
|------|----------|------------|
| 🔍 秘密検出 | 新しい検出パターン、カスタムカテゴリ | 🟢 初心者 |
| 📝 ドキュメント | ガイド、例、APIドキュメント、タイポ修正 | 🟢 初心者 |
| 🧪 テスト | ユニットテスト、プロパティベーステスト、統合テスト | 🟡 中級 |
| 🔌 統合 | LangChain、CrewAI、AG2、LlamaIndex ミドルウェア | 🟡 中級 |
| 💾 メモリアダプター | Redis、Pinecone、Weaviate、ChromaDB アダプター | 🟡 中級 |
| 🔄 CI/CDテンプレート | Jenkins、Azure Pipelines、Bitbucket Pipelines | 🟡 中級 |
| 🏗️ コアモジュール | ガバナンスエンジン、証拠エクスポート、ポリシー評価 | 🔴 上級 |

### アーリーコントリビュータが得られるもの

- 🏆 **CONTRIBUTORS.mdおよびリリースノートに名前が掲載**
- 🎖️ **「ファウンディングコントリビューター」バッジ** — 最初の25件のマージされたPRが永続的な認識を得ます
- 📣 **TealTigerのソーシャルチャンネルで紹介** (LinkedIn、X、Dev.to)
- 🔑 **公開前の今後のガバナンス機能への早期アクセス**
- 💬 **GitHub Discussionsを介したコアチームへの直接アクセス**
- 📝 **技術ブログ記事の共著機会**

### はじめよう```bash
# 1. Star this repo (it helps!)

# 2. Fork and clone the SDK you want to contribute to:
# TypeScript SDK:
git clone https://github.com/agentguard-ai/tealtiger-typescript-prod.git
# Python SDK:
git clone https://github.com/agentguard-ai/tealtiger-python-prod.git

# 3. Pick a "good first issue"
# https://github.com/agentguard-ai/tealtiger/issues?q=label%3A%22good+first+issue%22

# 4. Submit a PR
# 5. Join the team 🐯