Creare Agenti AI con Laddro
Creare Agenti AI con Laddro
Usa la Laddro Career API per creare agenti autonomi che gestiscono attivita legate alla carriera, dall'ottimizzazione dei CV alle candidature in massa.
Cosa Possono Fare gli Agenti
| Tipo di Agente | Descrizione |
|---|---|
| Agente Ottimizzazione CV | Prende un CV e una lista di URL di lavoro, ottimizza il CV per ciascuno, esporta i PDF |
| Bot Candidature | Analizza un CV, lo abbina a bacheche di lavoro, ottimizza e genera lettere di presentazione per ciascuna |
| Agente Career Coach | Analizza un CV, suggerisce miglioramenti, riscrive le sezioni deboli |
| Agente Esportazione in Massa | Renderizza un CV con tutti i 22 template, confronta i layout |
| Agente Preparazione Colloqui | Legge un CV ottimizzato e la descrizione del lavoro, genera possibili domande per il colloquio |
Architettura
Il tuo agente chiama gli endpoint API direttamente (REST) o utilizza il server MCP (per agenti basati su Claude). L'API gestisce l'elaborazione AI, il rendering PDF e l'archiviazione dati.
Opzione 1: Agente basato su MCP (Claude Code)
Il modo piu rapido. Configura il server MCP e Claude chiama gli strumenti automaticamente.
{
"mcpServers": {
"laddro": {
"command": "npx",
"args": ["-y", "@laddro/career-mcp"],
"env": {
"LADDRO_API_KEY": "YOUR_API_KEY"
}
}
}
}Poi chiedi a Claude:
"Parse my resume from resume.pdf, tailor it for this job posting
at https://example.com/senior-engineer, and generate a cover letter.
Export both as PDFs using the Graphite template."Claude concatenera le chiamate API: analisi → ottimizzazione → generazione lettera di presentazione → esportazione.
Opzione 2: Agente REST API (Qualsiasi Framework)
Costruisci un agente personalizzato con qualsiasi framework: LangChain, CrewAI, AutoGen o codice puro.
Agente Ottimizzazione CV (Python)
import requests
API_KEY = "YOUR_API_KEY"
BASE = "https://api.laddro.com/v1"
HEADERS = {"x-api-key": API_KEY, "Content-Type": "application/json"}
def tailor_for_jobs(resume_id, job_descriptions):
results = []
for jd in job_descriptions:
# Tailor resume (3 credits)
resp = requests.post(f"{BASE}/tailor", headers=HEADERS, json={
"resumeId": resume_id,
"jobDescription": jd
})
tailored = resp.json()
# Generate cover letter (2 credits)
resp = requests.post(f"{BASE}/cover-letters/generate", headers=HEADERS, json={
"resumeId": resume_id,
"jobDescription": jd
})
cover_letter = resp.json()
# Export PDF (1 credit)
resp = requests.post(f"{BASE}/export", headers=HEADERS, json={
"resumeId": resume_id,
"templateId": "graphite"
})
results.append({
"job": jd[:50],
"tailored": tailored,
"coverLetter": cover_letter
})
return resultsAgente con Streaming (TypeScript)
const response = await fetch('https://api.laddro.com/v1/tailor', {
method: 'POST',
headers: {
'x-api-key': API_KEY,
'Content-Type': 'application/json',
'Accept': 'text/event-stream' // Enable streaming
},
body: JSON.stringify({ resumeId, jobDescription })
})
const reader = response.body.getReader()
const decoder = new TextDecoder()
while (true) {
const { done, value } = await reader.read()
if (done) break
const lines = decoder.decode(value).split('\n')
for (const line of lines) {
if (line.startsWith('data: ')) {
const event = JSON.parse(line.slice(6))
if (event.type === 'done') return
// Process each section as it streams in
agent.process(event.section, event.content)
}
}
}Endpoint API per Agenti
Questi sono gli endpoint piu utili per i workflow degli agenti:
| Endpoint | Crediti | Caso d'Uso |
|---|---|---|
POST /v1/resumes/parse | 2 | Importa un CV da PDF/DOCX |
POST /v1/tailor | 3 | Ottimizza un CV per un lavoro specifico |
POST /v1/cover-letters/generate | 2 | Genera una lettera di presentazione mirata |
POST /v1/export | 1 | Esporta un CV come PDF |
PUT /v1/resumes/{id}/render | 1 | Renderizza con un template specifico |
GET /v1/templates | 0 | Elenca i template disponibili |
GET /v1/resumes | 0 | Elenca i CV dell'utente |
Pianificazione Crediti per Agenti
Un workflow tipico "candidati per un lavoro":
| Passaggio | Crediti |
|---|---|
| Analisi CV (una volta) | 2 |
| Ottimizzazione per il lavoro | 3 |
| Generazione lettera di presentazione | 2 |
| Esportazione CV in PDF | 1 |
| Esportazione lettera di presentazione in PDF | 1 |
| Totale per lavoro | 9 (7 dopo la prima analisi) |
Con il piano gratuito (50 crediti/mese), puoi candidarti per circa 7 lavori. Gli abbonati (200/mese) possono farne circa 28. Acquista pacchetti crediti per volumi maggiori.
Buone Pratiche
- Analizza una volta, ottimizza molte volte: analizza il CV una volta e riutilizza il
resumeIdper tutte le ottimizzazioni e generazioni di lettere di presentazione. - Usa lo streaming: per agenti rivolti agli utenti, usa lo streaming SSE (
Accept: text/event-stream) per mostrare i risultati in tempo reale. - Gestisci gli errori 402: controlla il saldo crediti prima delle operazioni in massa. L'API restituisce
402 Payment Requiredquando i crediti si esauriscono. - Usa BYOK per alti volumi: se stai costruendo un agente ad alto volume, usa BYOK con la tua chiave del provider AI per evitare costi AI per singola richiesta.
- Attenzione ai limiti di frequenza: endpoint pubblici: 30 req/min. Protetti: 100 req/min. Implementa il backoff per le risposte
429.