Integration: TealTiger

pip install tealtiger-haystack

from haystack.components.agents import Agent
from haystack.components.generators.chat import OpenAIChatGenerator
from haystack.dataclasses import ChatMessage
from haystack.tools import tool
from typing import Annotated
from haystack_integrations.components.connectors.tealtiger import TealTigerGovernanceHook

@tool
def search(query: Annotated[str, "The search query"]) -> str:
    """Search the web."""
    return "Results for: " + query

@tool
def delete_account(account_id: Annotated[str, "The account ID"]) -> str:
    """Delete a customer account."""
    return "Deleted"

# Create governance hook
governance = TealTigerGovernanceHook(
    mode="ENFORCE",
    allowed_tools=["search"],           # Only search is allowed
    pii_categories=["ssn", "credit_card", "email"],
    budget_limit=5.0,                   # $5 max per session
)

# Attach to agent
agent = Agent(
    chat_generator=OpenAIChatGenerator(model="gpt-4o-mini"),
    tools=[search, delete_account],
    hooks={"before_tool": [governance]},
)

result = agent.run(messages=[ChatMessage.from_user("Delete account 12345")])
# → delete_account is DENIED (not in allowlist)

# Inspect audit trail
for decision in governance.decisions:
    print(f"{decision.action}: {decision.tool_name} — {decision.reason}")

from haystack import Pipeline
from haystack.components.generators import OpenAIGenerator
from haystack_integrations.components.connectors.tealtiger import TealTigerGovernanceComponent

pipeline = Pipeline()
pipeline.add_component("governance", TealTigerGovernanceComponent())
pipeline.add_component("llm", OpenAIGenerator(model="gpt-4o-mini"))
pipeline.connect("governance.text", "llm.prompt")

result = pipeline.run({"governance": {"text": "What is the capital of France?"}})

# Access governance decision
decision = result["governance"]["decision"]
print(decision["action"])         # "ALLOW"
print(decision["cost_tracked"])   # 0.0023
print(decision["pii_detected"])   # []

from haystack import Pipeline
from haystack.components.generators import OpenAIGenerator
from tealtiger import TealEngine
from haystack_integrations.components.connectors.tealtiger import TealTigerGovernanceComponent

engine = TealEngine(policies=[
    {"type": "cost_limit", "max_per_session": 5.00},
    {"type": "pii_block", "categories": ["ssn", "credit_card"]},
])

pipeline = Pipeline()
pipeline.add_component(
    "governance",
    TealTigerGovernanceComponent(engine=engine, mode="ENFORCE"),
)
pipeline.add_component("llm", OpenAIGenerator(model="gpt-4o-mini"))
pipeline.connect("governance.text", "llm.prompt")

result = pipeline.run({"governance": {"text": "Process payment for card 4111-1111-1111-1111"}})
# PII detected → action: "DENY"