Overview

Available Integrations

Ziet provides built-in integrations with popular services. All integrations are ready to use - just import and start building.

Google

Search, Images, News, Maps

Apify

Web scraping and data extraction

OpenAI

GPT-4, embeddings, chat completions

Anthropic

Claude AI models

Stripe

Payments and subscriptions

SendGrid

Transactional email

Twilio

SMS and voice calls

Slack

Team messaging and notifications

How It Works

Option 1: Default (Ziet’s Keys)

By default, integrations use Ziet’s API keys. No setup required - just import and use.

from ziet.integrations import google, openai

# Just use them - works out of the box
results = google.search("best restaurants SF")
summary = openai.chat([{"role": "user", "content": "Summarize these"}])

Free tier limits:

Google Search: 100 searches/day
OpenAI: 10,000 tokens/day
Apify: 50 scrapes/day
Other services: Reasonable usage limits

Perfect for development and prototyping.

Option 2: Bring Your Own Keys

For production or higher limits, connect your own API keys in the dashboard:

Go to Integrations in the dashboard
Click on the service (e.g., “OpenAI”)
Click Connect Your Account
Enter your API key
Save

Your code doesn’t change - Ziet automatically uses your keys:

# Same code, now using YOUR API key from dashboard
from ziet.integrations import openai

response = openai.chat([...])

Basic Usage

Import and Use

from ziet import Action, memory
from ziet.integrations import google, openai

@Action(
    id="research_topic",
    name="Research Topic",
    description="Research a topic using Google and OpenAI"
)
def research_topic(topic: str) -> None:
    # Search Google
    results = google.search(topic, num_results=10)
    memory.add(key="search_results", value=results)
    
    # Summarize with OpenAI
    prompt = f"Summarize these search results: {results}"
    summary = openai.chat([{"role": "user", "content": prompt}])
    memory.add(key="summary", value=summary)

Use in Agents

from ziet import Agent
from ziet.integrations import google, openai, sendgrid

@Agent(
    id="research_agent",
    name="ResearchAgent",
    instructions="""
    Research the topic using Google search.
    Summarize findings with OpenAI.
    Email results to the user.
    """,
    actions=["search_google", "generate_summary", "send_email"]
)
class ResearchAgent:
    pass

Common Patterns

Search and Analyze

from ziet import Action, memory
from ziet.integrations import google, openai

@Action(
    id="search_and_analyze",
    name="Search and Analyze",
    description="Search and get AI analysis"
)
def search_and_analyze(query: str) -> None:
    # Search
    results = google.search(query, num_results=10)
    
    # Analyze with AI
    analysis = openai.chat([{
        "role": "user",
        "content": f"Analyze these search results: {results}"
    }])
    
    memory.add(key="analysis", value=analysis)

Payment with Confirmation

from ziet import Action, memory
from ziet.integrations import stripe, sendgrid

@Action(
    id="process_and_notify",
    name="Process and Notify",
    description="Charge payment and send confirmation"
)
def process_and_notify(amount: int, email: str) -> None:
    # Charge payment
    payment = stripe.create_payment_intent(
        amount=amount * 100,  # Convert to cents
        currency="usd"
    )
    
    # Send confirmation
    sendgrid.send(
        to=email,
        subject="Payment Confirmed",
        body=f"<h1>Payment Successful</h1><p>Amount: ${amount}</p>",
        html=True
    )
    
    memory.add(key="payment_complete", value={"payment_id": payment["id"], "amount": amount})

Best Practices

Start with defaults, upgrade later

Use Ziet’s keys for development. Add your own keys in production.

# Development: Use Ziet's keys (no setup)
from ziet.integrations import openai
response = openai.chat([...])

# Production: Add your key in dashboard (same code)

Handle errors gracefully

from ziet import Action, memory
from ziet.integrations import google

@Action(
    id="safe_search",
    name="Safe Search",
    description="Search with error handling",
    retries=2
)
def safe_search(query: str) -> None:
    try:
        results = google.search(query)
        memory.add(key="results", value=results)
    except Exception as e:
        memory.add(key="error", value=str(e))
        memory.add(key="results", value=[])

Cache results in memory

from ziet import memory
from ziet.integrations import google

# Check cache first
cached = memory.get(f"search_{query}")
if cached:
    return

# Call API and cache
results = google.search(query)
memory.add(key=f"search_{query}", value=results)

Next Steps

Google

Search, Images, News, Maps

Actions

Build actions with integrations

Agents

Orchestrate with agents

Memory

Store integration results

Getting Started

Agentic

Application

Integrations

Deployment

Available Integrations

Google

Apify

OpenAI

Anthropic

Stripe

SendGrid

Twilio

Slack

How It Works

Option 1: Default (Ziet’s Keys)

Option 2: Bring Your Own Keys

Basic Usage

Import and Use

Use in Agents

Common Patterns

Search and Analyze

Payment with Confirmation

Best Practices

Next Steps

Google

Actions

Agents

Memory

​Available Integrations

Google

Apify

OpenAI

Anthropic

Stripe

SendGrid

Twilio

Slack

​How It Works

​Option 1: Default (Ziet’s Keys)

​Option 2: Bring Your Own Keys

​Basic Usage

​Import and Use

​Use in Agents

​Common Patterns

​Search and Analyze

​Payment with Confirmation

​Best Practices

​Next Steps

Google

Actions

Agents

Memory

Available Integrations

How It Works

Option 1: Default (Ziet’s Keys)

Option 2: Bring Your Own Keys

Basic Usage

Import and Use

Use in Agents

Common Patterns

Search and Analyze

Payment with Confirmation

Best Practices

Next Steps