Laddro DocsLaddro Docs

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 AgenteDescrizione
Agente Ottimizzazione CVPrende un CV e una lista di URL di lavoro, ottimizza il CV per ciascuno, esporta i PDF
Bot CandidatureAnalizza un CV, lo abbina a bacheche di lavoro, ottimizza e genera lettere di presentazione per ciascuna
Agente Career CoachAnalizza un CV, suggerisce miglioramenti, riscrive le sezioni deboli
Agente Esportazione in MassaRenderizza un CV con tutti i 22 template, confronta i layout
Agente Preparazione ColloquiLegge un CV ottimizzato e la descrizione del lavoro, genera possibili domande per il colloquio

Architettura

Utente
Agente (Claude Code / LangChain / Personalizzato)
Laddro Career API
Analizzare il CV
Personalizzare per il lavoro
Generare lettera di presentazione
Esportare PDF

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 results

Agente 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:

EndpointCreditiCaso d'Uso
POST /v1/resumes/parse2Importa un CV da PDF/DOCX
POST /v1/tailor3Ottimizza un CV per un lavoro specifico
POST /v1/cover-letters/generate2Genera una lettera di presentazione mirata
POST /v1/export1Esporta un CV come PDF
PUT /v1/resumes/{id}/render1Renderizza con un template specifico
GET /v1/templates0Elenca i template disponibili
GET /v1/resumes0Elenca i CV dell'utente

Pianificazione Crediti per Agenti

Un workflow tipico "candidati per un lavoro":

PassaggioCrediti
Analisi CV (una volta)2
Ottimizzazione per il lavoro3
Generazione lettera di presentazione2
Esportazione CV in PDF1
Esportazione lettera di presentazione in PDF1
Totale per lavoro9 (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

  1. Analizza una volta, ottimizza molte volte: analizza il CV una volta e riutilizza il resumeId per tutte le ottimizzazioni e generazioni di lettere di presentazione.
  2. Usa lo streaming: per agenti rivolti agli utenti, usa lo streaming SSE (Accept: text/event-stream) per mostrare i risultati in tempo reale.
  3. Gestisci gli errori 402: controlla il saldo crediti prima delle operazioni in massa. L'API restituisce 402 Payment Required quando i crediti si esauriscono.
  4. 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.
  5. Attenzione ai limiti di frequenza: endpoint pubblici: 30 req/min. Protetti: 100 req/min. Implementa il backoff per le risposte 429.

On this page