Polly3D Documentation English
Assistant IA

Outils de l'assistant

La liste complète des outils qu'un assistant IA peut utiliser dans Polly3D, groupés par usage.

Vous n'appelez pas ces outils vous-même : c'est votre assistant qui le fait. Cette liste sert à savoir quoi demander. Les noms d'outils restent en anglais dans les deux langues.

Scène et objets#

OutilRôle
get_sceneLit la scène : objets, identifiants, noms, matériaux, lumières, réglages
list_primitivesListe les formes et leurs paramètres
add_primitiveAjoute une primitive (cube, sphère, torus, backdrop…)
add_shapeAjoute une forme plate extrudée (rectangle, ellipse, triangle, polygone, étoile, ou un contour libre à partir de points)
add_path / set_path / get_pathCrée, modifie et lit un tracé de Bézier ou une forme plate (points, poignées, début/fin, profil, extrusion)
add_drawingCrée des tracés ou des formes à partir d'un SVG, de données de tracé SVG ou d'une expression createPath d'After Effects
add_lightAjoute une lumière directionnelle, ponctuelle, spot ou ambiante
add_groupCrée un groupe
add_textAjoute un texte 3D alimenté par l'un des dix canaux Custom Text
set_objectChange nom, position, rotation, échelle, visibilité, groupe parent, canal Aux, point d'ancrage…
delete_objects, duplicate_object, select_objectsÉdition et sélection de base
import_modelImporte un OBJ, glTF/GLB ou FBX
undo, redoRecule ou avance d'une étape
batchExécute plusieurs outils de scène en un appel et une seule étape d'annulation ; "$2" désigne l'objet créé par l'étape 2
(set_object, set_material, set_layer, add_layer) avec idsAgit sur une liste d'objets d'un coup
list_scenes, new_scene, open_scene, switch_scene, save_scene, close_sceneLes onglets de scène : les autres outils agissent sur la scène active

Matériaux#

OutilRôle
list_layer_typesListe les types de couches et chaque réglage, avec sa plage
get_materialLit la pile d'un matériau
add_layer, set_layer, remove_layer, move_layer, duplicate_layerModifient la pile
set_layer_imageMet une image dans une couche Texture ou Matcap
set_materialUn raccourci : couleur, roughness, metalness, émission, verre, dégradé, visibilité
create_material, assign_materialCréent un matériau partagé et l'assignent
list_material_presets, apply_material_presetParcourent et appliquent la bibliothèque

Cloner et animation#

OutilRôle
list_cloner_options, get_cloner, set_clonerLe Cloner et ses motifs
add_effector, set_effector, remove_effectorEffecteurs Random, Noise, Step et Spline
set_keyframes, clear_keyframes, get_animationKeyframes de position, rotation, échelle
set_time, get_timeLa tête de lecture de l'éditeur

Liens vers After Effects et drivers#

OutilRôle
get_linksListe les liens Connector et les drivers d'un objet ou de la scène
set_linkLie un nombre à un Connector (1–16) et/ou à un driver (sine, pingpong, loop, wiggle, keys). Portées : une couche de matériau, le Cloner ou un effecteur, un paramètre de primitive

Ambiance, rendu et viewport#

OutilRôle
list_settings, set_settingsFond, ambiance, ciel, occlusion, brouillard, bloom, profondeur de champ, vignette, aberration chromatique, couleur, qualité, timeline
set_backgroundUne couleur de fond, ou transparent
list_skies, set_skyLes ciels HDRI de la bibliothèque
generate_textureDessine une image de façon procédurale (sans IA, en local) : ondes d'eau avec leur normal map, dégradés, bruit sans raccord, matcaps chromés
generate_imageDessine une image à partir d'un texte avec un modèle d'IA (FLUX.2 [pro]) et la pose sur un matériau (texture, avec un relief en option) ou sur le ciel. Demande votre propre clé (Réglages MCP > Image generation, gardée dans le Trousseau macOS), facturée par le service d'images ; les bords sont réparés pour que la texture se répète sans raccord
save_material_to_libraryGarde le matériau d'un objet dans la bibliothèque (Mes matériaux)
render_previewRend la scène (une vue, une caméra libre, un moment de l'animation) pour que l'assistant la voie ; draft donne une petite image rapide
check_sceneCherche ce qui tourne mal d'habitude : pas de lumière, métal sans rien à refléter, texture sans image, flou de profondeur de champ sur toute l'image
set_focusVise la profondeur de champ sur un objet, pour la caméra (la valeur brute n'est pas une distance)
set_viewDéplace la caméra du viewport de l'utilisateur

Images de référence#

OutilRôle
extract_paletteMesure une image : palette, luminosité, contraste, saturation, chaleur, grille de lumière
compare_to_referenceRend et compare à une référence, avec chiffres et conseils ; aussi la netteté (flou) et, avec regions, les mêmes chiffres pour des parties de l'image

Guide#

OutilRôle
get_guideDocumentation intégrée pour l'assistant, par sujet : overview, materials, glass, recipes, lighting, cloner, animation, references, composition, after_effects

Non exposé#

  • L'enregistrement de la scène (volontaire : enregistrer actualise After Effects) ;
  • Les liens du texte After Effects, des Paths et des anciens matériaux ;
  • Tout ce qui est du côté d'After Effects.
Documentation de Polly3D Studio