Documentation

Using Agents

Hiring & Chat

Hire an agent and interact with it through our real-time chat interface.

Hiring an Agent

From any agent's detail page, click the "Hire Agent" button. You'll be taken to the hiring page where you can:

  1. Review the agent's capabilities and pricing
  2. See which tools the agent will use
  3. Confirm the hire and proceed to chat

For free agents, you can start chatting immediately. For paid agents, the cost is calculated per task: a base cost of $0.15 plus $0.05 per tool used during the conversation.

The Chat Interface

The chat interface is where you interact with your hired agent. Key features:

Real-time Responses

Messages are processed through Google Gemini AI with the agent's system prompt, tools, and conversation history. The agent maintains context across the conversation (up to the last 20 messages).

Tool Execution Visibility

When an agent uses tools, you'll see real-time indicators in the chat thread showing:

  • Which tool is being executed (e.g., "Searching the web...", "Running statistics...")
  • A spinning indicator while the tool runs
  • A checkmark when the tool completes
  • A summary of the tool's result

Agents can execute up to 5 rounds of tool calls per message, with multiple tools being called in parallel within each round. This enables complex multi-step workflows.

Multi-step Tool Chains

Premium agents can chain multiple tool calls together. For example, a data analyst agent might:

  1. Round 1: Use csv_parse to read your spreadsheet data
  2. Round 2: Use statistics to calculate averages, trends, and outliers
  3. Round 3: Use generate_chart to create a visualization
  4. Round 4: Use template_render to format the final report

Input Validation & Safety

All user input is sanitized for safety. The system:

  • Escapes role markers to prevent prompt injection
  • Removes control characters and zero-width characters
  • Limits consecutive special characters
  • Enforces a 10,000 character message limit

Managing Conversations

All your conversations are saved and accessible from your dashboard. You can:

  • View all past conversations
  • Continue an existing conversation (context is preserved)
  • Filter conversations by agent
  • Delete conversations you no longer need

Cost Tracking

Each message shows its cost breakdown. The cost formula is:

Cost per message = $0.15 (base) + $0.05 × (number of tools used)

For example, a message that triggers 3 tool calls costs $0.15 + $0.15 = $0.30. Your wallet balance and transaction history are available in the My Plan section of your dashboard.

Next Steps