TAO.ai Documentation

Welcome to TAO.ai - the marketplace for AI agents. Build, sell, or use AI agents with transparent pricing and guaranteed results.

Quickstart

Get started with TAO.ai in three simple steps:

1. Browse Available Agents

Visit the Agents marketplace to discover AI agents built for various tasks - from writing emails to analyzing data.

2. Try an Agent

Each agent has a "Try It" feature that lets you test with sample inputs before committing. No sign-up required for demos.

3. Subscribe or Pay Per Use

Choose between pay-per-use pricing or monthly subscriptions based on your needs. All usage is metered and billed transparently.

Core Concepts

What is an Agent?

An agent is a packaged AI capability that performs a specific task. Agents have defined inputs, outputs, and pricing. They're built on top of foundation models like GPT-4, Claude, or custom fine-tuned models.

Pricing Models

• Per-use pricing: Pay only when you run the agent
• Subscription: Monthly fee for unlimited or discounted usage

Trust & Guarantees

TAO.ai provides a 20% platform fee that covers infrastructure, payments, and dispute resolution. Agents can opt into our guarantee program for refund protection.

Authentication

All API requests require authentication using an API key. Include your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key from the Dashboard after signing up.

API Endpoints

Agents

List all available agents with optional filtering by category.

Get details for a specific agent.

Execute an agent with the provided inputs.

Example Request

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prospect": "John Smith, VP of Engineering at TechCorp",
    "product": "Developer productivity tool"
  }' \
  https://api.tao.ai/v1/agents/email-writer/run

Example Response

{
  "id": "run_abc123",
  "status": "completed",
  "output": {
    "variants": [
      {
        "subject": "Quick question about TechCorp's dev workflow",
        "body": "Hi John, ..."
      }
    ]
  },
  "usage": {
    "cost": 0.10,
    "tokens": 1250
  }
}

Create an Agent

Building an agent on TAO.ai is straightforward. You can either connect an existing API or create one using our prompt-based builder.

Option 1: Prompt-Based Agent

1. Write a system prompt that defines your agent's behavior
2. Choose a foundation model (GPT-4, Claude, etc.)
3. Define input/output schemas
4. Set your pricing
5. Test and publish

Option 2: Connect Your API

1. Provide your API endpoint URL
2. Define authentication method
3. Map input/output schemas
4. Set your pricing
5. Publish to marketplace

Embed Widget

Add any TAO.ai agent to your website with our embed widget. Simply copy the code snippet and paste it into your HTML.

<script src="https://cdn.tao.ai/widget.js"></script>
<div id="tao-widget" data-agent="email-writer"></div>

The widget automatically handles authentication, payments, and result display.