# Agenti NZ - AI Agent Discovery & API Documentation

This file helps AI agents, crawlers, and tools discover and understand how to interact with Agenti NZ's digital services.

**Last Updated:** March 2026  
**Version:** 1.3  
**Website:** https://agenti.nz  
**Design System:** https://design.agenti.nz  
**Organization:** Agenti NZ - We build AI operating systems for business.

---

## 🤖 For AI Agents & Tools

### Primary Content API

**Endpoint:** `/api/trpc/content.markdown`  
**Method:** GET  
**Format:** JSON response with markdown content  
**Authentication:** None required (public)

**Response Structure:**
```json
{
  "content": "# Agenti NZ - AI Automation...",
  "format": "markdown",
  "version": "1.1",
  "lastUpdated": "2026-03-10T00:00:00.000Z"
}
```

**Use Cases:**
- AI agents fetching website content for analysis
- Content aggregators indexing business information
- LLM context enrichment for customer support bots
- Marketing automation tools gathering company details
- Research tools collecting information about services

**Example Usage:**
```bash
curl https://agenti.nz/api/trpc/content.markdown
```

---

## 📋 Available Content Sections

The markdown endpoint includes:

- **Overview:** Company mission and tagline ("We build AI operating system for business.")
- **Problem Statement:** Pain points for NZ SMEs (Drowning in admin)
- **Solution:** What agentic AI does and capabilities (Acts, Not Just Talks)
- **Services:** AI Discovery Audit, Custom Agent Build, Managed AI Retainer
- **Use Cases:** Tradie's Assistant, Smart Retailer, Admin Guardian, Hospo Helper, Property Pro, Wellness Co-Pilot, Consultant's Edge
- **Case Studies:** EVX (rental business), Smart Retailer (ecommerce)
- **Statistics:** Key metrics and impact numbers (40% time saved, 24/7 operations)
- **FAQ:** 7 questions about costs, privacy, implementation, ownership, support, and how we build AI agents
- **How It Works:** 3-step process (Discovery, Build, Launch)
- **Contact Information:** Email and website

---

## 🎨 Design System (design.agenti.nz)

The Agenti NZ Design System is a public, open reference for building consistent UI with the Agenti visual language.

**URL:** https://design.agenti.nz  
**Source File:** `/design_system.html`  
**Purpose:** Design tokens, components, typography, and colour palette for Agenti NZ products.

### What's Inside

- **Typography:** Syne (headings) + DM Sans (body) + DM Mono (code)
- **Colour Palette:** Navy-950 to Navy-400, Blue-600 to Blue-300, accent colours, semantic tokens
- **Components:** Buttons, cards, badges, form inputs, navigation, hero sections
- **Spacing & Layout:** Grid system, spacing scale, responsive breakpoints
- **Dark Mode:** Full dark-first design system (background: #0a1628)
- **Brand Assets:** Logo usage, iconography guidelines, OG image specs

### Design Tokens (key values)

```
--navy-950: #060e1c   (darkest background)
--navy-900: #0d1f3c   (primary background)
--blue-500: #2e8ef5   (primary action colour)
--font-heading: 'Syne', sans-serif
--font-body: 'DM Sans', sans-serif
--font-mono: 'DM Mono', monospace
```

---

## 🔗 Other API Endpoints

### Contact Form Submission
**Endpoint:** `/api/trpc/contact.submit`  
**Method:** POST  
**Authentication:** None required (public)

**Request Body:**
```json
{
  "name": "string",
  "email": "string",
  "company": "string (optional)",
  "message": "string"
}
```

---

## 📄 Website Pages & Routes

| Route | Purpose | Content Type |
|-------|---------|--------------|
| `/` | Homepage | Landing page with hero, services, FAQ |
| `/blog` | Blog Index | List of articles and guides |
| `/blog/sequoia-services-new-software` | Blog Post | New software for service businesses |
| `/blog/robots-md-ai-discovery` | Blog Post | AI discovery documentation |
| `/blog/robots-md-blog-post` | Blog Post | Robots.md usage guide |
| `/blog/openclaw-installation-service` | Blog Post | OpenClaw installation guide |
| `/blog/agentic-ai-vs-competitors` | Blog Post | AI agent comparison |
| `/blog/agentic-ai-vs-chatbots-aunz` | Blog Post | Agentic AI vs chatbots in AU/NZ |
| `/blog/privacy-act-2020-ai-compliance-nz` | Blog Post | NZ Privacy Act compliance for AI |
| `/blog/automate-invoicing-nz-tradies` | Blog Post | Automating invoicing for NZ tradies |
| `/case-studies` | Case Studies Index | List of client case studies |
| `/case-studies/evx` | EVX Case Study | EV rental business automation |
| `/case-studies/groov` | Groov Case Study | Design studio workflow automation |
| `/case-studies/retail` | Retail Case Study | Ecommerce retail automation |
| `/globalfinance` | Demo | DocChaser AI demo for mortgage brokers |
| `/contact` | Contact Form | Email contact form |
| `/#faq` | FAQ Section | 7 frequently asked questions |

**Design System:**

| URL | Purpose |
|-----|---------|
| `https://design.agenti.nz` | Full design system reference |
| `https://design.agenti.nz/robots.md` | This file (AI discovery) |
| `https://design.agenti.nz/llms.txt` | LLM-optimised site summary |

---

## 🔐 Data & Privacy

- **Data Handling:** Privacy Act 2020 compliant
- **Data Storage:** NZ-based servers
- **Data Sharing:** No data shared with third parties
- **API Rate Limiting:** None (public endpoints)
- **Caching:** Content updates reflected within 1 hour

---

## 📊 Content Metadata

**Organization Name:** Agenti NZ  
**Industry:** AI Automation & Business Process Automation  
**Location:** New Zealand  
**Primary Service:** Custom AI agent development for SMEs  
**Target Market:** NZ small and medium enterprises  
**Contact Email:** call@agenti.nz  
**Website:** https://agenti.nz  
**Design System:** https://design.agenti.nz

---

## 🎯 Key Business Information

### Services Offered
1. **AI Discovery Audit** - $499 (90-minute consultation)
2. **Custom Agent Build** - From $2,500 (bespoke automation)
3. **Managed AI Retainer** - $750/month (ongoing support)

### Key Statistics
- 50+ businesses automated
- 2,000+ hours saved annually
- $3,200 average monthly savings per client
- 40% average time saved on admin tasks
- 100% code ownership (no vendor lock-in)
- NZ-based support team

---

## 🚀 Integration Guidelines for AI Agents

### Best Practices
1. **Cache the markdown content** - Refresh every 24 hours to reduce load
2. **Parse markdown sections** - Use headers to organize content
3. **Extract structured data** - Convert pricing and stats to JSON
4. **Respect rate limits** - Although none currently enforced, implement backoff
5. **Identify yourself** - Include User-Agent header with your tool name

### Example Integration (Python)
```python
import requests

response = requests.get('https://agenti.nz/api/trpc/content.markdown')
data = response.json()
markdown_content = data['content']
print(markdown_content)
```

---

## 📞 Support & Questions

- **Email:** call@agenti.nz
- **Website:** https://agenti.nz
- **Design System:** https://design.agenti.nz

---

## 🔄 Version History

| Version | Date | Changes |
|---------|------|---------|
| 1.0 | Feb 2026 | Initial release |
| 1.1 | Mar 2026 | Updated branding and expanded use cases |
| 1.2 | Mar 2026 | Added design.agenti.nz design system documentation |
| 1.3 | Mar 2026 | Added /globalfinance demo, Groov case study, updated FAQ (7 questions), new blog posts |

---

**Note:** This robots.md file is designed to help AI agents discover and understand Agenti NZ's services and design system. It complements the standard robots.txt for search engines.