JGJenks Guo

Docs / reference

API REST

Points de terminaison publics en lecture sous /api/v1 et autres points de terminaison HTTP, générés à partir de la même spécification que les outils MCP.

Base URL: https://jenksguo.xyz. JSON sauf mention contraire; GET /api/v1/brief renvoie du Markdown (envoyez Accept: application/json pour { markdown }). Lisible par machine : OpenAPI.

Points de terminaison

Méthode Chemin Outil Description
GET /api/v1/brief get_brief Un mémo d'une page en Markdown sur Jenks Guo : positionnement, rôle actuel, parcours de carrière, points forts, langues, contact et comment explorer davantage.
GET /api/v1/entries list_experience Liste des expériences, projets, rôles communautaires et formations de Jenks (du plus récent au plus ancien), avec possibilité de filtrer par étiquette d'industrie, prisme de rôle ou type.
GET /api/v1/entries/{slug} get_entry Rédaction détaillée et longue d'une expérience, d'un projet, d'un rôle communautaire ou d'une formation par slug : aperçu, ce que Jenks a fait, réalisations, pourquoi cela compte pour les employeurs, résultats clés, compétences, liens de preuve..
GET /api/v1/lenses list_lenses Les prismes de rôle à travers lesquels les employeurs peuvent voir Jenks (Head of AI, solution architect, developer advocate, digital marketer, hospitality…) avec un argumentaire, des lacunes honnêtes et des comptes de preuves..
GET /api/v1/search search_jenks Recherche par mots-clés dans chaque entrée et document.
GET /api/v1/documents/{name} get_document L'un des documents de référence de Jenks : profile (profil central), credentials (éducation, certifications), capabilities (carte capacité → preuves), talks (conférences, podcasts, écrits), thinking (vision du monde)..
POST /api/v1/ask ask_jenks Poser une question en langage naturel à l’assistant Ask Jenks (adéquation au rôle, cadrage de consulting, conseils de transformation IA, histoires STAR, gouvernance…).
POST /api/chat — Chat en streaming utilisé par le widget du site (flux texte brut; events: true intercale des lignes d’état \u001e).
POST /api/transcribe — Solution de repli voix : transcrire de l’audio base64.
GET /api/health — Vivacité et configuration.
GET POST /mcp —

Erreurs et limites

  • 400 bad_request, 404 not_found, 429 rate_limited (ask : 20/min/IP), 503 lorsqu’une clé de modèle n’est pas configurée.
  • Les points de terminaison GET envoient Access-Control-Allow-Origin: * ; les points de terminaison POST sont destinés aux agents côté serveur.

get_brief — Obtenir le mémo de Jenks

Un mémo d'une page en Markdown sur Jenks Guo : positionnement, rôle actuel, parcours de carrière, points forts, langues, contact et comment explorer davantage. Commencez ici.

  • MCP: get_brief sur https://jenksguo.xyz/mcp
  • REST: GET /api/v1/brief
  • CLI: jenks brief

Aucun argument.

curl -s "https://jenksguo.xyz/api/v1/brief"

list_experience — Lister l'expérience

Liste des expériences, projets, rôles communautaires et formations de Jenks (du plus récent au plus ancien), avec possibilité de filtrer par étiquette d'industrie, prisme de rôle ou type. Renvoie des formes courtes : titre, organisation, période, résumé, résultat clé, URL de page.

  • MCP: list_experience sur https://jenksguo.xyz/mcp
  • REST: GET /api/v1/entries?tag=&lens=&kind=&locale=
  • CLI: jenks list [--tag it] [--lens solution-architect] [--kind project]
Argument Type Obligatoire Remarques
tag it · engineering · ai · devrel · web3 · business · marketing · consulting · hospitality · community · creative non
lens head-of-ai · ai-transformation-consultant · engineering-manager · solution-architect · system-integrator · support-engineer · ict-specialist · developer-advocate · developer-evangelist · digital-marketer · hospitality non
kind experience · education · community · project non
locale en · zh · zh-hant · ja · fr · es · eo non Langue pour les champs traduits (par défaut en). 
curl -s "https://jenksguo.xyz/api/v1/entries"

get_entry — Obtenir une entrée

Rédaction détaillée et longue d'une expérience, d'un projet, d'un rôle communautaire ou d'une formation par slug : aperçu, ce que Jenks a fait, réalisations, pourquoi cela compte pour les employeurs, résultats clés, compétences, liens de preuve.

  • MCP: get_entry sur https://jenksguo.xyz/mcp
  • REST: GET /api/v1/entries/{slug}?locale=
  • CLI: jenks get <slug>
Argument Type Obligatoire Remarques
slug string oui Slug de l’entrée, par ex. xero-developer-evangelist
locale en · zh · zh-hant · ja · fr · es · eo non Langue pour les champs traduits (par défaut en). 
curl -s "https://jenksguo.xyz/api/v1/entries/xero-developer-evangelist"

list_lenses — Lister les prismes de rôle

Les prismes de rôle à travers lesquels les employeurs peuvent voir Jenks (Head of AI, solution architect, developer advocate, digital marketer, hospitality…) avec un argumentaire, des lacunes honnêtes et des comptes de preuves.

  • MCP: list_lenses sur https://jenksguo.xyz/mcp
  • REST: GET /api/v1/lenses?locale=
  • CLI: jenks lenses
Argument Type Obligatoire Remarques
locale en · zh · zh-hant · ja · fr · es · eo non Langue pour les champs traduits (par défaut en). 
curl -s "https://jenksguo.xyz/api/v1/lenses"

search_jenks — Rechercher dans le corpus

Recherche par mots-clés dans chaque entrée et document. Renvoie les passages les plus pertinents avec leurs slugs.

  • MCP: search_jenks sur https://jenksguo.xyz/mcp
  • REST: GET /api/v1/search?q=
  • CLI: jenks search "<query>"
Argument Type Obligatoire Remarques
query string oui 
curl -s "https://jenksguo.xyz/api/v1/search"

get_document — Obtenir un document

L'un des documents de référence de Jenks : profile (profil central), credentials (éducation, certifications), capabilities (carte capacité → preuves), talks (conférences, podcasts, écrits), thinking (vision du monde).

  • MCP: get_document sur https://jenksguo.xyz/mcp
  • REST: GET /api/v1/documents/{name}?locale=
  • CLI: jenks doc <name>
Argument Type Obligatoire Remarques
name profile · credentials · capabilities · talks · thinking oui
locale en · zh · zh-hant · ja · fr · es · eo non Langue pour les champs traduits (par défaut en). 
curl -s "https://jenksguo.xyz/api/v1/documents/credentials"

ask_jenks — Poser une question à l’assistant de Jenks

Posez une question en langage naturel à l’assistant Ask Jenks (adéquation au rôle, cadrage de consulting, conseils de transformation IA, histoires STAR, gouvernance…). Il exécute ses propres outils sur le corpus et répond dans la langue demandée. Limité en débit.

  • MCP: ask_jenks sur https://jenksguo.xyz/mcp
  • REST: POST /api/v1/ask
  • CLI: jenks ask "<question>"
Argument Type Obligatoire Remarques
question string oui
locale en · zh · zh-hant · ja · fr · es · eo non Langue pour les champs traduits (par défaut en).
history array non Tours précédents facultatifs. 
curl -s -X POST https://jenksguo.xyz/api/v1/ask \
  -H 'content-type: application/json' \
  -d '{"question":"Is Jenks a fit for a Head of AI role?"}'

.mdCette page est traduite avec l’aide de l’IA ; les titres officiels restent en anglais.