> ## 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.
# Overview
> Pre-built integrations - start building immediately, no API setup required
## Available Integrations
Ziet provides built-in integrations with popular services. All integrations are **ready to use** - just import and start building.
Search, Images, News, Maps
Web scraping and data extraction
GPT-4, embeddings, chat completions
Claude AI models
Payments and subscriptions
Transactional email
SMS and voice calls
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.
```python theme={null}
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](https://dashboard.ziet.ai/integrations):
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:
```python theme={null}
# Same code, now using YOUR API key from dashboard
from ziet.integrations import openai
response = openai.chat([...])
```
## Basic Usage
### Import and Use
```python theme={null}
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
```python theme={null}
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
```python theme={null}
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
```python theme={null}
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"Payment Successful
Amount: ${amount}
",
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.
```python theme={null}
# Development: Use Ziet's keys (no setup)
from ziet.integrations import openai
response = openai.chat([...])
# Production: Add your key in dashboard (same code)
```
```python theme={null}
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=[])
```
```python theme={null}
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
Search, Images, News, Maps
Build actions with integrations
Orchestrate with agents
Store integration results