Tool

Was es beantwortet

Beispielfrage

get-profile

Gibt den einzelnen Profildatensatz von Marcos Alvarez zurück — Name, Headline, Standort, Verfügbarkeit und eine kurze Biografie — als ein Objekt, mit Belegen. Verwende dies, um auf einen Blick zu beantworten, „wer diese Person ist“ oder „wie ihre aktuelle Verfügbarkeit bzw. ihr Standort ist“. Verwende es nicht für eine rollenweise Berufshistorie (verwende get-experience), für spezifische Projektdetails (verwende search-projects) oder um zu prüfen, ob eine bestimmte Fähigkeit oder Technologie beansprucht wird (verwende get-skill-evidence). Nimmt keine Eingaben entgegen. Im normalen Betrieb gibt es kein „kein Ergebnis“-Ergebnis — der Datensatz dieses Servers enthält immer genau ein Profil.

„Wer ist Marcos Alvarez, und ist er derzeit offen für neue Rollen?“

get-experience

Gibt jeden Eintrag aus der Berufshistorie von Marcos Alvarez zurück, der einem optionalen strukturierten Filter entspricht — Unternehmen, Technologie-Tags, ein YYYY-MM-Datumsbereich und aktueller/vergangener Status — als Liste, sortiert nach neuestem zuerst, jeder Eintrag mit einem Beleg. Verwende dies, um zu beantworten, „was hat er bei Unternehmen X gemacht“, „woran hat er im Jahr Y gearbeitet“ oder „was macht er gerade“. Ohne Filterfelder aufgerufen, gibt es die vollständige Historie zurück. Verwende es nicht für die einzelne Profilzusammenfassung (verwende get-profile), um Projektbeschreibungen nach Stichwort zu durchsuchen (verwende search-projects) oder um zu prüfen, ob eine benannte Fähigkeit beansprucht wird (verwende get-skill-evidence). Ein Filter, der keine Rollen findet, gibt ein erfolgreiches Ergebnis mit einer leeren Liste zurück, keinen Fehler.

„Woran hat Marcos seit 2022 gearbeitet? Geh mit mir seine letzten Rollen durch.“

search-projects

Durchsucht das Projektportfolio von Marcos Alvarez nach Stichwort und/oder Technologie-Tag und gibt rankierte Treffer zurück, jeweils mit einem Relevanzwert, einer Erklärung des übereinstimmenden Felds und einem Beleg. Die Übereinstimmung ist eine deterministische Stichwort-/Tag-Suche gegen Projektnamen, Zusammenfassungen, Texte und Technologie-Tags — es gibt heute kein semantisches oder einbettungsbasiertes Verständnis der Abfrage. Verwende dies, wenn du gebeten wirst, bestimmte Projekte zu finden oder zu beschreiben, z. B. „zeig mir Projekte, die React verwendet haben“ oder „was haben sie mit Kubernetes gebaut“. Verwende es nicht für eine chronologische Berufshistorie (verwende get-experience) oder um zu prüfen, ob eine Fähigkeit überhaupt beansprucht wird, mit Beleg oder Lücke (verwende get-skill-evidence). Eine Abfrage, die keine Projekte findet, gibt ein erfolgreiches Ergebnis mit einer leeren Liste zurück, keinen Fehler; eine leere oder nur aus Leerzeichen bestehende Abfrage verhält sich genauso.

„Zeig mir Projekte, in denen Marcos TypeScript oder Kubernetes verwendet hat.“

get-skill-evidence

Schlägt eine einzelne benannte Fähigkeit oder Technologie nach und meldet eines von drei ehrlichen Ergebnissen: „beansprucht“ (die Fähigkeit mit ihren unterstützenden Belegen), „nicht beansprucht“ (eine explizite, anerkannte Lücke mit eigener Aussage und verwandten Fähigkeiten) oder „unbekannt“ (der Begriff passt zu keinem von beiden). Verwende dies, wenn du zu einer bestimmten Technologie gefragt wirst: „kennst du X“ oder „hast du mit Y gearbeitet“. Verwende es nicht, um die vollständige Fähigkeitsliste zu durchsuchen (es gibt kein solches Tool auf diesem Server) oder um Projektbeschreibungen nach einem Stichwort zu durchsuchen (verwende stattdessen search-projects), und es ist kein Ersatz für get-experience, wenn die Frage eine Rolle oder ein Unternehmen betrifft und nicht eine einzelne Fähigkeit. Ein „nicht beansprucht“- oder „unbekannt“-Ergebnis ist eine normale, erfolgreiche Antwort, kein Fehler — gib es ehrlich weiter, statt es erneut zu versuchen oder darum herum zu halluzinieren.

„Hat Marcos mit ereignisgesteuerten Architekturen gearbeitet? Zeig mir die Belege.“

search-career

Führt eine unscharfe, semantische Suche über den vollständigen Text der Karriereinhalte von Marcos Alvarez durch (Erfahrung, Projekte, Fähigkeiten, Schriften) und gibt rankierte Auszüge zurück, jeweils mit einem Relevanzwert und einem Beleg, oder ein explizites „kein relevanter Inhalt gefunden“-Ergebnis, wenn nichts die Ähnlichkeitsschwelle überschreitet. Verwende dies für offene, übergreifende oder konzeptionelle Fragen, die eine strukturierte Suche nicht direkt beantworten kann — z. B. „hat er mit ereignisgesteuerten Architekturen gearbeitet“, „wie sind seine Erfahrungen mit der Führung von Teams“, „irgendetwas zu Kostenoptimierung“. Verwende es nicht, wenn die Frage einer spezifischen, strukturierten Suche entspricht, die die deterministischen Tools bereits exakt beantworten: get-profile für die Frage, wer er ist, get-experience für eine Rollen-/Unternehmens-/Datumsbereichs-Berufshistorie, search-projects für die Stichwort-/Tag-Projektsuche und get-skill-evidence, um eine bestimmte benannte Fähigkeit oder Technologie zu prüfen — bevorzuge diese zuerst und greife nur dann auf dieses Tool zurück, wenn sie nicht passen. Dieses Tool ist pro Aufruf teurer (es bettet die Abfrage ein) und unterliegt derselben pro Aufruf teurer (es bettet die Abfrage ein) und unterliegt derselben serverweiten Ratenbegrenzung wie jedes andere Tool hier — ruf es nicht wiederholt für dieselbe Frage auf.

„Wie sind Marcos‘ Erfahrungen mit der Führung von Engineering-Teams und Mentoring?“

Variable

Zweck

SITE_URL

Optionale Überschreibung für den absoluten Ursprung der Website. Nicht erforderlich – Vercel leitet ihn automatisch ab.

UPSTASH_REDIS_REST_URL, UPSTASH_REDIS_REST_TOKEN

Upstash-Redis-Anmeldedaten für das Rate-Limiting von /api/mcp. Wenn nicht gesetzt, schlägt das System offen fehl (keine Begrenzung), anstatt einen Fehler zu erzeugen.

RATELIMIT_MAX_REQUESTS, RATELIMIT_WINDOW_SECONDS

Überschreiben das Rate-Limit-Fenster des MCP-Endpunkts.

CHAT_PROVIDER, CHAT_MODEL_ID

Auswählen und Festlegen des Modellanbieters/der Modell-ID des Chat-Agenten.

GOOGLE_GENERATIVE_AI_API_KEY

Erforderlich, wenn CHAT_PROVIDER=google (Standard).

ANTHROPIC_API_KEY

Nur erforderlich, wenn CHAT_PROVIDER=anthropic.

CHAT_SESSION_RATELIMIT_MAX_REQUESTS, CHAT_SESSION_RATELIMIT_WINDOW_SECONDS, CHAT_IP_RATELIMIT_MAX_REQUESTS, CHAT_IP_RATELIMIT_WINDOW_SECONDS, CHAT_AGENT_MAX_STEPS

Chat-Schutzmechanismen-Abstimmung – siehe apps/web/README.md „Chat guardrails“.

DATABASE_URL

Neon-Postgres-Verbindungszeichenfolge für das Modul @hire-me-mcp/core/db (Migrationen, Ingestion, searchCareer). Siehe packages/core/README.md.

NEON_API_KEY, NEON_PROJECT_ID

Erstellen/Löschen eines Wegwerf-Neon-Zweigs nur für die DB-Integrationstestsuite – wird nie gegen die Hauptdatenbank verwendet.