Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ziet.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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:
  1. Go to Integrations in the dashboard
  2. Click on the service (e.g., “OpenAI”)
  3. Click Connect Your Account
  4. Enter your API key
  5. 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

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)

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=[])

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