n8n / Make / Zapier / code

Astrolabe Chat étant OpenAI-compatible, toute intégration qui accepte une base URL custom fonctionne sans changement de code.

---

n8n

Configuration du credential

1. Credentials → New → OpenAI API
2. Renseignez :
   • API Key : votre clé sk-astrolabe-...
   • Base URL : https://api.astrolabe.chat/v1
3. Sauvegardez, puis utilisez le nœud OpenAI dans vos workflows.

Paramètres recommandés (nœud OpenAI → Chat Message)

Champ	Valeur recommandée
Model	mistral-small
Max Tokens	600 minimum (300 pour du court, 1500 pour du long)
Temperature	0.3 pour l’extraction, 0.7 pour la rédaction

Max Tokens dans n8n

Le nœud OpenAI de n8n a parfois un défaut très bas (256). mistral-small raisonne avant de répondre : avec moins de 300 tokens, la réponse peut être vide. Mettez toujours Max Tokens à 600 minimum.

Extraction structurée dans n8n (JSON garanti)

Pour obtenir un JSON dans n8n sans passer par du code :

1. Ajoutez un System Message décrivant le schéma JSON attendu :

   Extrais les informations et réponds UNIQUEMENT avec ce JSON :
   {"nom": string, "montant": number, "objet": string}

2. Activez Response Format → JSON Object (si disponible dans votre version de n8n).
3. Branchez un nœud JSON Parse ou Set pour exploiter les champs.

Raisonnement et sortie structurée

Avec Response Format actif (json_object ou json_schema), le raisonnement interne est automatiquement désactivé côté serveur — inutile de l’indiquer dans le prompt. Le modèle génère le JSON directement, reasoning_content est null.

---

Make (Integromat)

Installer l’application Astrolabe Chat

Le plus simple : installez l’application Astrolabe Chat dans votre compte Make via ce lien d’invitation, puis créez une connexion avec votre clé sk-astrolabe-....

Installer l’application Astrolabe Chat pour Make

Une fois l’application installée, vous disposez de modules dédiés (pas besoin de configurer le module HTTP manuellement) : chat, embeddings, et la base de connaissance (créer une base, ajouter/rechercher des documents…). Le module « Search Everything » retrouve un document dans toutes vos bases à la fois (paramètres query, knowledge_base, filters, top_k). Les modules « Anonymize a Document » et « Deanonymize a Text » pseudonymisent un texte ou un fichier au fil d’un scénario et restaurent les valeurs ensuite (cf. Anonymiser un document). Si vous préférez tout de même un appel HTTP brut, suivez la configuration ci-dessous.

Module HTTP → Make an API Key Auth Request

Champ	Valeur
URL	https://api.astrolabe.chat/v1/chat/completions
Method	POST
Headers	Authorization: Bearer sk-astrolabe-... · Content-Type: application/json

Body (JSON) :

{
  "model": "mistral-small",
  "messages": [
    {
      "role": "system",
      "content": "Réponds UNIQUEMENT avec ce JSON : {\"nom\": string, \"montant\": number, \"objet\": string}"
    },
    {
      "role": "user",
      "content": "{{texte_a_analyser}}"
    }
  ],
  "response_format": { "type": "json_object" },
  "max_tokens": 300
}

Récupérez la réponse via : choices[0].message.content (string JSON) → branchez un module Parse JSON pour accéder aux champs.

Module OpenAI (si disponible)

Si votre abonnement Make inclut le module OpenAI natif :

• Connection → renseignez l’API Key et activez “Custom Base URL” = https://api.astrolabe.chat/v1
• Model : mistral-small
• Max Tokens : 600

---

Code

Node.js / TypeScript — appel simple

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.astrolabe.chat/v1",
  apiKey: process.env.ASTROLABE_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "mistral-small",
  messages: [{ role: "user", content: "Résume cette note en 3 points." }],
  max_tokens: 600,
});

console.log(resp.choices[0].message.content);

Node.js — extraction JSON structurée

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.astrolabe.chat/v1",
  apiKey: process.env.ASTROLABE_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "mistral-small",
  messages: [
    {
      role: "system",
      content: "Tu analyses des dossiers de subvention ESS.",
    },
    {
      role: "user",
      content: `Extrais les informations clés de cette demande de subvention : "${texte}"`,
    },
  ],
  response_format: {
    type: "json_schema",
    json_schema: {
      name: "subvention",
      strict: true,
      schema: {
        type: "object",
        properties: {
          nom_structure:   { type: "string" },
          montant_demande: { type: "number" },
          objet:           { type: "string" },
          eligible:        { type: "boolean" },
        },
        required: ["nom_structure", "montant_demande", "objet", "eligible"],
        additionalProperties: false,
      },
    },
  },
  max_tokens: 500,
});

const data = JSON.parse(resp.choices[0].message.content!);
// { nom_structure: "…", montant_demande: 8500, objet: "…", eligible: true }

Python — appel simple

from openai import OpenAI

client = OpenAI(
    base_url="https://api.astrolabe.chat/v1",
    api_key="sk-...",
)

resp = client.chat.completions.create(
    model="mistral-small",
    messages=[{"role": "user", "content": "Bonjour !"}],
    max_tokens=500,
)
print(resp.choices[0].message.content)

---

Zapier

Installer l’application Astrolabe

L’application Astrolabe pour Zapier est privée (accessible sur invitation). Ajoutez-la à votre compte Zapier via ce lien, puis créez une connexion avec votre clé sk-astrolabe-... :

Ajouter l’application Astrolabe à Zapier

Vous disposez alors d’actions dédiées — Create a Chat Completion, Create an Embedding et la gestion complète des bases de connaissance (RAG : créer une base, ajouter des documents, rechercher…) — sans configurer d’appel HTTP manuel. Le modèle et la base de connaissance se choisissent dans des listes déroulantes alimentées par votre compte. L’action « Search Everything » retrouve un document dans toutes vos bases en une fois (query, knowledge_base, filters, top_k). Les actions « Anonymize a Document » et « Deanonymize a Text » pseudonymisent un texte ou un fichier au fil d’un Zap et restaurent les valeurs ensuite (cf. Anonymiser un document).

Sans l’application (appel HTTP brut)

Si vous préférez ne pas installer l’application, utilisez l’action Webhooks by Zapier → POST avec la même configuration que le module HTTP de Make (ci-dessus).

---

Pour des exemples avancés (tool calling, streaming, schémas complexes), voir Sortie structurée et Référence API.