# Agentics Hire - Agent Guide

> A guide for AI agents interacting with the Agentics Hire talent marketplace.

## Overview

Agentics Hire (https://hire.agentics.org) is an AI talent marketplace connecting companies with 100,000+ AI experts across 13 specialized categories. This guide explains how agents can interact with the platform for talent discovery, job searching, and hiring workflows.

## Quick Start

1. **Browse talent**: Visit `/talent` to search AI professionals
2. **Browse jobs**: Visit `/jobs` to find job postings
3. **Category pages**: Visit `/hire/{category}` for specialized listings
4. **API access**: Use the public REST API for programmatic access

## Talent Discovery

### Browse All Talent
```
GET https://hire.agentics.org/talent
```
The talent page supports search and filtering via URL parameters:
- `?search=machine+learning` — keyword search
- `?category=ml-engineers` — filter by category
- `?location=remote` — filter by location
- `?availability=available` — filter by availability

### Featured Talent API
```
GET https://hire.agentics.org/api/talent/featured?limit=6
```
Returns top-rated, verified talent profiles. No authentication required.

Response format:
```json
{
  "profiles": [
    {
      "id": "uuid",
      "display_name": "Jane D.",
      "job_title": "Senior ML Engineer",
      "skills": ["Python", "TensorFlow", "PyTorch"],
      "hourly_rate": 150,
      "location": "San Francisco, CA",
      "availability_status": "available",
      "verified": true,
      "job_success_rate": 98,
      "experience_years": 8
    }
  ]
}
```

### Talent Categories

| Category | URL | Description |
|----------|-----|-------------|
| Agentic Engineers | `/hire/agentic-engineers` | Build autonomous AI agent systems |
| ML Engineers | `/hire/ml-engineers` | Machine learning model development |
| Prompt Engineers | `/hire/prompt-engineers` | LLM prompt design and optimization |
| LLM Specialists | `/hire/llm-specialists` | Large language model fine-tuning |
| AI Consultants | `/hire/ai-consultants` | AI strategy and implementation |
| Computer Vision | `/hire/computer-vision-engineers` | Image/video AI systems |
| NLP Engineers | `/hire/nlp-engineers` | Natural language processing |
| Data Scientists | `/hire/data-scientists` | Data analysis and modeling |
| AI Researchers | `/hire/ai-researchers` | Cutting-edge AI research |
| RAG Specialists | `/hire/rag-specialists` | Retrieval-augmented generation |
| AI Safety Engineers | `/hire/ai-safety-engineers` | AI alignment and safety |
| MCP Engineers | `/hire/mcp-engineers` | Model Context Protocol development |
| Quality Assurance | `/hire/quality-assurance` | AI system testing and QA |

## Job Board

### Browse Jobs
```
GET https://hire.agentics.org/jobs
```
The jobs page displays all active job postings with search and filtering.

### Job Listings API
```
GET https://hire.agentics.org/api/jobs
```
Returns active job postings. No authentication required.

### Post a Job
Visit `/post-job` to create a new job listing. Authentication required.

Required fields:
- Job title
- Description
- Required skills
- Job type (full-time, part-time, contract, freelance)
- Budget/salary range
- Location (remote/on-site/hybrid)

## Hiring Workflow

1. **Discover talent** — Browse `/talent` or use category pages
2. **Review profiles** — Click on profiles to see skills, portfolio, work history
3. **Post a job** — Create a listing at `/post-job`
4. **AI matching** — Platform matches candidates to your job requirements
5. **Invite candidates** — Send invitations to matched talent
6. **Engage** — Set up interviews and begin engagement

## Authentication

### Register
```
POST https://hire.agentics.org/api/auth/register
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "secure-password",
  "name": "Agent Name",
  "role": "employer"
}
```

### Login
```
POST https://hire.agentics.org/api/auth/login
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "secure-password"
}
```

Returns JWT access token (15min TTL) and refresh token (7d TTL).

### Using Auth Token
```
Authorization: Bearer <access_token>
```

## Rate Limits

- Public endpoints: 100 requests/minute
- Authenticated endpoints: 300 requests/minute
- Search endpoints: 60 requests/minute

## Related Resources

- **Main manifest**: `/.well-known/agentics-manifest.json`
- **API documentation**: `/.well-known/openapi.json`
- **Interaction specs**: `/.well-known/agentic-guidance.json`
- **Health status**: `/.well-known/health.json`
- **Parent organization**: https://agentics.org

## Contact

- Support: support@agentics.org
- Website: https://agentics.org