OpenAI

Catalogue des nœuds Intelligence artificielle

Sur cette page

Chat, vision et documents via l'API OpenAI

Utilisation et spécificités

Sélectionnez un identifiant du fournisseur, un modèle accessible et les prompts. Images, documents et JSON structuré dépendent des capacités du modèle. La sortie expose text, model, usage, json et attachmentsProcessed. Le modèle proposé par défaut n’est pas une garantie de disponibilité.

Type technique : ai_openai. Runtime : nodulz.

Identifiants et prérequis

Créer et configurer l’identifiant : openai

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le guide des identifiants pour les accès et la rotation.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre	Type	Par défaut	Valeurs / limites
`credentialId`	`string`	-	-
`model`	`string`	`"gpt-5.6-sol"`	-
`systemPrompt`	`string`	`""`	-
`userPrompt`	`string`	`""`	-
`temperature`	`number`	-	-; ≥ 0, ≤ 2
`maxTokens`	`number`	-	-; ≥ 1
`timeoutSeconds`	`number`	-	-; ≥ 1, ≤ 3600
`attachments`	`array`	`[]`	-
`attachments[].kind`	`enum`	`"text"`	`text`, `image_url`, `image_base64`, `document_url`, `document_base64`
`attachments[].sourceMode`	`enum`	`"manual"`	`manual`, `node`, `file`
`attachments[].source`	`string`	`""`	-
`attachments[].mimeType`	`string`	-	-
`attachments[].name`	`string`	-	-
`messages`	`array`	`[]`	-
`messages[].role`	`enum`	`"user"`	`user`, `assistant`, `system`
`messages[].content`	`string`	`""`	-
`responseFormat`	`enum`	`"text"`	`text`, `json`
`jsonSchema`	`string`	`""`	-

Aide de configuration

credentialId Identifiant IA: Clé API enregistrée sur la page Identifiants pour ce fournisseur.
model Modèle: Identifiant du modèle chez le fournisseur (ex. gpt-4o, claude-3-5-sonnet).
systemPrompt Prompt système: Instructions système envoyées au modèle avant le prompt utilisateur.
userPrompt Prompt utilisateur: Message principal - expressions {{…}} autorisées.
temperature Température: Créativité demandée au modèle (0 à 2). Laissez vide pour sa valeur par défaut. Ce paramètre est omis pour les modèles de raisonnement OpenAI et Azure qui ne le prennent pas en charge.
maxTokens Tokens max.: Nombre maximal de tokens de sortie, raisonnement compris pour les modèles concernés. Une réponse tronquée provoque une erreur : augmentez cette limite ou réduisez la demande.
timeoutSeconds Délai maximal (secondes): Durée maximale d’un appel au modèle, pièces jointes comprises. De 1 à 3 600 secondes ; 120 par défaut. L’annulation du workflow interrompt aussi l’appel.
responseFormat Format de réponse: Texte libre ou JSON structuré (avec schéma optionnel).
jsonSchema Schéma JSON (optionnel): Schéma JSON optionnel pour contraindre et vérifier la sortie json. Utilisez un modèle compatible avec les sorties structurées. Pour OpenAI en mode strict : objet racine, champs requis et additionalProperties à false. Une réponse non conforme provoque une erreur.

Exemples

Prompt utilisateur

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json

{
  "model": "gpt-5.6-sol",
  "systemPrompt": "",
  "userPrompt": "",
  "attachments": [],
  "messages": [],
  "responseFormat": "text",
  "jsonSchema": ""
}

Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.