Laddro DocsLaddro Docs

AI Agents Bouwen met Laddro

AI Agents Bouwen met Laddro

Gebruik de Laddro Career API om autonome agents te bouwen die carrieretaken beheren, van cv-optimalisatie tot massale sollicitaties.

Wat Agents Kunnen Doen

Type AgentBeschrijving
CV Optimalisatie AgentNeemt een cv en een lijst met vacature-URL's, optimaliseert het cv voor elk, exporteert PDF's
Sollicitatie BotAnalyseert een cv, matcht met vacaturebanken, optimaliseert en genereert motivatiebrieven voor elk
Career Coach AgentAnalyseert een cv, stelt verbeteringen voor, herschrijft zwakke secties
Batch Export AgentRendert een cv met alle 22 templates, vergelijkt layouts
Sollicitatie Voorbereiding AgentLeest een geoptimaliseerd cv en vacatureomschrijving, genereert mogelijke interviewvragen

Architectuur

Gebruiker
Agent (Claude Code / LangChain / Aangepast)
Laddro Career API
CV parsen
Aanpassen voor baan
Motivatiebrief genereren
PDF exporteren

Je agent roept de API-endpoints direct aan (REST) of gebruikt de MCP-server (voor Claude-gebaseerde agents). De API verzorgt de AI-verwerking, PDF-rendering en dataopslag.

Optie 1: MCP-gebaseerde Agent (Claude Code)

De snelste manier. Configureer de MCP-server en Claude roept de tools automatisch aan.

{
  "mcpServers": {
    "laddro": {
      "command": "npx",
      "args": ["-y", "@laddro/career-mcp"],
      "env": {
        "LADDRO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Vraag vervolgens aan 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 koppelt de API-aanroepen: analyseren, optimaliseren, motivatiebrief genereren, exporteren.

Optie 2: REST API Agent (Elk Framework)

Bouw een aangepaste agent met elk framework: LangChain, CrewAI, AutoGen of gewone code.

CV Optimalisatie Agent (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

Streaming Agent (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)
    }
  }
}

API Endpoints voor Agents

Dit zijn de meest nuttige endpoints voor agent-workflows:

EndpointTegoedToepassing
POST /v1/resumes/parse2CV importeren vanuit PDF/DOCX
POST /v1/tailor3CV optimaliseren voor een specifieke vacature
POST /v1/cover-letters/generate2Gerichte motivatiebrief genereren
POST /v1/export1CV exporteren als PDF
PUT /v1/resumes/{id}/render1Renderen met een specifieke template
GET /v1/templates0Beschikbare templates bekijken
GET /v1/resumes0CV's van de gebruiker bekijken

Tegoedplanning voor Agents

Een typische "solliciteer voor een vacature" workflow:

StapTegoed
CV analyseren (eenmalig)2
Optimaliseren voor vacature3
Motivatiebrief genereren2
CV exporteren als PDF1
Motivatiebrief exporteren als PDF1
Totaal per vacature9 (7 na de eerste analyse)

Met de gratis versie (50 tegoed/maand) kun je op ongeveer 7 vacatures solliciteren. Abonnees (200/maand) kunnen er ongeveer 28 doen. Koop tegoed-pakketten voor hogere volumes.

Aanbevolen werkwijzen

  1. Analyseer een keer, optimaliseer vaak: analyseer het cv een keer en hergebruik het resumeId voor alle optimalisaties en het genereren van motivatiebrieven.
  2. Gebruik streaming: voor gebruikersgerichte agents, gebruik SSE-streaming (Accept: text/event-stream) zodat gebruikers resultaten in realtime zien.
  3. Verwerk 402-fouten: controleer het tegoedbalans voor batchbewerkingen. De API retourneert 402 Payment Required wanneer het tegoed op is.
  4. Gebruik BYOK voor volume: als je een agent met hoog volume bouwt, gebruik BYOK met je eigen AI-providersleutel om per-verzoek AI-kosten te vermijden.
  5. Let op frequentielimieten: publieke endpoints: 30 req/min. Beveiligd: 100 req/min. Bouw backoff in voor 429-antwoorden.

On this page