Améliorations¶

Artific peut lire à heures fixes les conversations récentes de votre organisation et suggérer des améliorations concrètes à vos assistants et compétences : un ajout aux instructions d'un assistant, une compétence qui aide rarement, un assistant à part pour ce que les gens demandent sans cesse au mauvais. Une telle proposition est une suggestion ; une analyse est un passage où Artific lit les conversations et écrit des suggestions. Une analyse ne change rien d'elle-même, sauf si votre organisation choisit qu'Artific applique certains types lui-même : le reste attend une personne qui examine la suggestion et l'accepte.

Cette page s'adresse à l'administrateur qui active et configure les analyses, et à quiconque peut modifier un assistant ou une compétence et traite les suggestions qui le concernent.

Ce que signifie l'activation¶

Les analyses sont désactivées jusqu'à ce qu'un administrateur les active. Activer est un consentement de l'organisation, et la boîte de dialogue Activer les analyses d'amélioration ? dit à quoi :

• Le modèle d'analyse lit les conversations de votre organisation, les données personnelles étant remplacées par des espaces réservés, comme <PERSON_1> au lieu d'un nom.
• Chaque analyse coûte des appels au modèle, jusqu'à un maximum par passage, et ils comptent dans le plafond mensuel de votre organisation. Une fois le plafond atteint, une analyse ignore le reste.
• Si Les retours sur les réponses comptent est activé, les pouces de vos membres, avec leurs raisons et leurs commentaires, sont transmis sans nom (Retours sur les réponses).

Artific n'affiche nulle part ce qu'une analyse coûte en euros. Vous voyez le nombre d'analyses et d'appels au modèle seulement si votre organisation vous montre les coûts (Coûts).

Ce que personne ne voit¶

Une suggestion dit sur combien de conversations elle se fonde, jamais lesquelles ni de qui. Aucun écran ne nomme ni ne lie une conversation, une personne ou un enregistrement de mémoire, et l'historique d'une suggestion ne dit pas qui l'a acceptée ou écartée. Un administrateur ne le voit pas non plus, pas même par l'API. Pour un fait partagé, une suggestion ne dit même pas sur combien de personnes ou d'enregistrements de mémoire elle se fonde.

Qui peut faire quoi¶

Seul quelqu'un qui peut modifier un assistant ou une compétence y apporte une modification : write sur le type ne suffit pas à lui seul. Quelqu'un qui détient write mais ne peut pas modifier l'assistant peut tout de même écarter la suggestion. Vous pouvez aussi donner le type improvement dans un rôle personnalisé (Types et actions).

Un administrateur de l'organisation au-dessus de la vôtre voit les paramètres et les analyses, mais ne les modifie pas et ne lance pas d'analyse : activer est le consentement de votre propre organisation, et une analyse lui coûte de l'argent. Il ne voit les suggestions que dans une session de support que votre organisation autorise, et il s'y contente de regarder.

Où le trouver¶

• La liste se trouve sous AI Assistants › Améliorations, après Contrôle qualité, avec les onglets Suggestions et Analyses. L'entrée de menu n'apparaît que pour qui détient see.
• Les paramètres se trouvent sous Gestion de l'organisation › Paramètres, dans la section Améliorations, avec le bouton Configurer.
• Le bloc Suggestions d'amélioration figure dans les paramètres d'un assistant, au-dessus du formulaire, et sur la page d'une compétence, au-dessus des instructions (Le bloc).

Si l'environnement de votre organisation ne propose pas d'améliorations, vous ne voyez ni l'entrée de menu ni la section dans les paramètres, et un lien direct indique Les améliorations ne sont pas disponibles ici. Si vous les attendez, demandez aux administrateurs de l'organisation au-dessus de la vôtre, ou à Artific s'il n'y en a pas.

Activer et configurer les analyses¶

1. Allez dans Gestion de l'organisation › Paramètres et choisissez Configurer dans la section Améliorations.
2. Activez Analyses activées et confirmez dans la boîte de dialogue avec Activer.
3. Choisissez quand et sur quoi, le modèle d'analyse, et si les retours sur les réponses comptent (voir ci-dessous).
4. Enregistrez la page. Tout ce qui est sur la page est enregistré en une fois.

La section Améliorations des paramètres de l'organisation résume ensuite l'état en une ligne, par exemple Activé · Chaque nuit à 03:00 · 5 contrôles activés · Artific n'applique encore rien lui-même.

Si l'organisation au-dessus de la vôtre gère ces paramètres, Lecture seule s'affiche en haut et vous ne pouvez rien enregistrer. Demandez alors à un administrateur de cette organisation.

Quand et sur quoi¶

• Horaire : Chaque nuit à 03:00, Chaque jour ouvré à 03:00, Chaque lundi à 03:00, ou Avancé pour votre propre Motif cron de cinq champs : minute, heure, jour, mois, jour de la semaine.
• Fuseau horaire : le fuseau horaire de l'horaire.
• Période : combien de jours en arrière une analyse lit, de 1 à 30. Une analyse ne lit jamais plus loin que la durée pendant laquelle votre organisation conserve les traces.

Sous les champs figure le moment de la prochaine analyse.

Modèle d'analyse¶

Le modèle d'analyse lit les conversations et écrit les suggestions. Choisissez Valeur par défaut de l'installation pour suivre la valeur par défaut, même quand elle change, ou Choix propre pour un modèle de chat du catalogue de votre organisation. En haut figure le modèle utilisé maintenant et pourquoi.

Artific ne se rabat jamais sur le modèle d'assistance. Sans modèle d'analyse, les contrôles ne donnent que des chiffres ou rien ; chaque contrôle indique ce qui manque alors.

Retours sur les réponses¶

Avec Les retours sur les réponses comptent dans les suggestions et la mémoire, les pouces levés et baissés de vos membres, avec la raison et le commentaire, vont sans nom au modèle d'analyse. Cela active aussi le contrôle Réponses souvent mal notées, que vous pouvez ensuite désactiver.

• Cela vaut aussi pour la mémoire, même analyses désactivées : les pouces aident à décider si une session s'est bien passée.
• Cela vaut pour toute l'organisation. Vous ne pouvez pas l'activer ou le désactiver par assistant.
• Si votre organisation ne recueille pas de retours sur les réponses, l'interrupteur est désactivé et ne peut pas être activé. Activez d'abord les retours sous Gestion de l'organisation › Paramètres › Retours.
• Activer les analyses active aussi ceci, sauf si vous l'avez désactivé vous-même auparavant : Artific s'en souvient, même si vous désactivez puis réactivez les analyses plus tard.
• Si votre organisation a fixé elle-même quand une réponse compte comme bonne ou mauvaise, Artific laisse ces règles en place et refuse d'enregistrer cet interrupteur, avec la raison dans le message.

Contrôles¶

Un contrôle est une chose que recherche une analyse. Chaque contrôle a un interrupteur, dit ce dont il a besoin et ce qu'il a fait la dernière fois. Ce dont il a besoin est lu tel qu'il est maintenant : une étiquette orange manque.

Traces signifie que votre organisation enregistre les appels au modèle comme traces (Paramètres de l'organisation) ; sans traces, une analyse ne lit aucune conversation et ne donne que des chiffres. Un assistant allégé n'essaie rien tant qu'aucune limite mensuelle des essais n'est fixée (plus bas).

Un fait que plusieurs personnes connaissent lit la mémoire que chaque assistant garde des personnes qui discutent avec lui. Si vous l'activez, une analyse y cherche quelque chose sur votre organisation, pas sur une personne : ce qu'au moins trois personnes ont dit au même assistant, ou ce qu'une personne a dit et qui concerne clairement l'organisation. Un fait contenant une adresse, un numéro de téléphone ou un lien n'est jamais suggéré. Ce que des personnes ont dit à des assistants différents ne s'additionne pas. Chaque lecture est un appel au modèle qui compte dans la consommation de votre organisation. La mémoire d'un projet et la mémoire partagée elle-même ne sont pas lues. Un fait trouvé entre dans la mémoire partagée quand quelqu'un l'accepte (plus bas), ou de lui-même si vous le choisissez sous Appliquer seul.

Essais d'un assistant allégé¶

Un assistant allégé essaie une seule modification à la fois sur un assistant : d'abord moins d'outils, puis un modèle moins cher, puis des instructions plus courtes. Il le fait par un essai : l'évaluation propre à l'assistant s'exécute deux fois, avec la version actuelle et avec la modification, sur les mêmes scénarios et avec le même modèle d'évaluation. Si la version allégée ne fait pas moins bien et coûte au moins 10 % de moins ou répond au moins 10 % plus vite, vous recevez une suggestion.

Sous les contrôles se trouve le bloc Essais d'un assistant allégé. Seul un administrateur de l'organisation le règle ; pour les autres, il est grisé, avec la raison à côté.

• Limite mensuelle des essais, en euros. Vide jusqu'à ce que vous la remplissiez, et nécessaire pour activer le contrôle. Tous les essais ensemble ne coûtent jamais plus que cela par mois, dans le plafond mensuel de votre organisation. Vous pouvez modifier la limite, pas la supprimer. Si vous désactivez le contrôle, la limite reste.
• Assistants pouvant être essayés. Au départ rien n'est coché : sans coche, aucun assistant n'est essayé. Un assistant sans évaluation d'au moins cinq scénarios avec un modèle d'évaluation est grisé, avec la raison à côté ; créez d'abord une telle évaluation (plus bas).
• Laisser de côté dans les essais. Sous chaque assistant coché figurent ses outils, d'abord sans coche. Un outil que vous cochez n'est proposé dans aucun essai : ce qu'il ferait n'a donc pas lieu. Un outil est laissé de côté par son nom : si un autre assistant coché utilise un outil du même nom, celui-ci est aussi laissé de côté dans ses essais. Un outil laissé de côté que plus aucun assistant coché n'utilise reste affiché jusqu'à ce que vous le décochiez. Un outil qu'une évaluation laisse déjà de côté reste aussi absent des essais.
• Lors de la dernière analyse dit en mots simples ce que la dernière analyse a fait des essais : combien ont démarré, et pourquoi d'autres non, par exemple parce que la limite mensuelle était épuisée.

Une version de test vaut généralement mieux que laisser un outil de côté : un outil doté d’une version de test est bien appelé pendant un essai, mais rien de réel ne se produit.

Appliquer seul¶

Pour chaque type de suggestion, vous choisissez jusqu'où Artific va seul. Cela vaut pour tous les assistants à la fois.

Ce choix existe pour Modifier l'assistant, Réécrire la compétence et Nouvelle compétence. Un nouvel assistant n'est toujours qu'une suggestion : Artific ne crée jamais d'assistant seul. Pour Partager un fait, vous choisissez Proposer seulement ou Appliquer et publier : Artific partage alors lui-même un fait qu'il trouve, sans que personne ne le lise d'abord. Un tel fait provient de ce que des personnes ont dit dans leurs propres conversations et va à toute l'organisation ; vous le modifiez ou le supprimez sous Mémoire partagée comme toute note. Seul un administrateur, qui peut modifier les paramètres de l'organisation, active ce choix ou le désactive. Les autres types, comme une connexion ou le rangement d'une compétence, attendent toujours une personne.

Avec Appliquer et publier pour un assistant, faites attention à deux choses. Si Artific ajoute un outil qu'Artific refuserait à l'enregistrement, cela ne peut pas être annulé ensuite, seulement signalé : retirez alors l'outil vous-même dans les paramètres de l'assistant. Et un outil nouvellement ajouté ne fonctionne parfois bien qu'au bout d'une heure, une fois qu'Artific a mis sa description dans les instructions.

Si Artific n'a pas pu appliquer une suggestion seul, par exemple parce qu'un espace réservé y figure encore ou qu'une règle de votre organisation ne le permet pas, elle reste ouverte et la page de la suggestion dit pourquoi. Un brouillon qui achemine les conversations autrement que l'assistant publié n'est publié que par un administrateur, sur la page de l'assistant dans la console d'Artific.

Qui l'apprend quand Artific change quelque chose seul¶

Choisissez qui reçoit une notification quand Artific publie quelque chose seul : Qui peut le modifier (les éditeurs de l'assistant ou de la compétence modifiés, activé par défaut), Administrateurs, et les Groupes que vous choisissez, dans toute combinaison. Ne cochez rien et personne n'est averti ; seule la marque dans la liste reste. Quand quelque chose n'a pas d'éditeurs propres, comme un fait partagé, les administrateurs l'apprennent à la place des éditeurs.

Chacun choisit comment il l'apprend, dans Mes notifications. Vous ne modifiez ce bloc que si vous pouvez modifier les paramètres de l'organisation ; les autres ne font que le voir.

Le mois dernier¶

Quiconque peut voir les coûts dans votre organisation voit combien d'analyses ont eu lieu le mois dernier et combien d'appels au modèle elles ont faits. Les autres ne voient pas cette section.

Les suggestions¶

L'onglet Suggestions affiche les suggestions de l'organisation, par défaut celles au statut Ouverte. Filtrez par Statut, Contrôle et Concerne (un type, comme Assistant ou Compétence, ou un assistant ou une compétence par son nom). Chaque ligne montre le type de suggestion, le titre écrit par le modèle d'analyse, ce qu'elle concerne, le contrôle, le statut et quand elle a été vue pour la dernière fois. Charger plus en bas charge les suggestions suivantes.

Une suggestion marquée Chiffres seulement, aucune modification proposée signale quelque chose que le modèle n'a pas pu développer, par exemple parce qu'il n'y avait pas de modèle d'analyse. Vous pouvez la lire et la traiter, mais il n'y a rien à appliquer.

Si les analyses sont désactivées, la liste indique Les analyses d'amélioration sont désactivées, avec Aller aux paramètres pour qui peut les activer. Pendant une analyse, le haut de la liste l'indique, et les nouvelles suggestions apparaissent d'elles-mêmes une fois qu'elle est terminée.

Consulter une suggestion¶

Une suggestion montre :

• Constat : le titre, le résumé et l'Explication, tels que le modèle d'analyse les a écrits. Ce texte n'est pas traduit ; il est dans la langue dans laquelle le modèle a écrit.
• Avant et après : ce que l'acceptation change, avec la version actuelle à côté de la nouvelle. Le texte ajouté est vert, le texte retiré rouge et barré, et les outils et compétences apparaissent comme étiquettes. La section qu'un outil place lui-même dans les instructions est en pointillés, comme Section de l'outil … · gérée par Artific.
• Concerne, Contrôle, Fondé sur (le nombre de conversations), Vu pour la dernière fois, les Chiffres trouvés par le contrôle, l'Historique (chaque étape avec une date seulement) et la Note, si quelqu'un en a écrit une.

Les appels et les tokens qu'une suggestion économiserait par mois ne s'affichent que si votre organisation vous montre les coûts.

Traiter une suggestion¶

Ce que fait Accepter dépend du type de suggestion ; la suggestion elle-même le dit.

• Écarter ouvre Écarter la suggestion, avec une Note facultative d'au plus 1 000 caractères. La suggestion ne revient pas pendant un temps, sauf si le problème double entre-temps.
• Rouvrir rouvre une suggestion écartée. Si une analyse ultérieure a retrouvé la même chose, ce n'est pas possible, et Il existe une suggestion plus récente vous dit de rouvrir celle-ci.
• Si vous pouvez lire la suggestion mais pas modifier l'assistant ou la compétence, le haut de la suggestion l'indique et vous ne pouvez pas accepter. Demandez à un rédacteur de l'assistant ou à un administrateur.

Modifier un assistant¶

Au-dessus de la modification figure Accepter enregistre la version … de …, à votre nom. Après acceptation, tous ceux qui discutent avec l'assistant discutent aussitôt avec la nouvelle version. La version précédente reste dans Versions ; vous pouvez toujours revenir en arrière.

Ajuster ouvre le texte que la suggestion ajoute, ou avec instructions (remplacées) tout le nouveau texte, pour que vous puissiez d'abord le modifier. Ce que vous changez entre dans la nouvelle version ; la suggestion elle-même garde le texte d'origine. Revenir à la suggestion annule votre modification.

L'acceptation n'est pas possible dans ces cas, et la suggestion dit pourquoi :

• Espaces réservés. Le modèle d'analyse a lu les conversations avec les données personnelles remplacées, donc le texte proposé peut contenir un espace réservé comme <PERSON_1>. Remplacez chaque espace réservé avec Ajuster ; Espace réservé suivant vous mène au suivant. Ensuite, vous pouvez accepter.
• L'assistant a entre-temps une version plus récente. La suggestion porte sur une version plus ancienne. La prochaine analyse actualise la suggestion ; vous pouvez aussi modifier l'assistant vous-même.
• Quelqu'un d'autre vient d'enregistrer l'assistant. Relisez l'avant et l'après, puis acceptez. Vos ajustements sont conservés.
• La nouvelle version est refusée, par exemple parce qu'un outil proposé ne peut pas être donné à l'assistant. La raison s'affiche au-dessus de la suggestion et vos ajustements sont conservés.

Si le texte proposé répète la section d'un outil, le paragraphe est en orange avec un avertissement : Artific remet lui-même cette section à l'enregistrement, donc le texte figurerait deux fois. Retirez-le avec Ajuster, ou laissez-le si c'est voulu.

Réécrire ou créer une compétence¶

Avec Réécrire la compétence, la suggestion indique combien d'assistants reçoivent aussitôt la nouvelle version, parce qu'ils suivent la dernière version, et combien ont figé une version et la gardent. Une Nouvelle compétence ne change rien tant qu'un assistant ne la charge pas.

Vous pouvez d'abord ajuster le texte. Gardez dans l'en-tête de la compétence exactement une ligne avec son nom, en lettres minuscules, chiffres et traits d'union ; sinon Artific refuse la version. Il vous faut le droit de modifier une compétence portant ce nom.

Si la publication échoue, la version est bien écrite, mais la suggestion est Appliquée avec Pas encore en ligne, et la version précédente tourne encore. Choisissez Réessayer ou Publier pour réessayer.

Une compétence issue d'une publication est Une copie partagée : seule la publication la modifie. Vous ne pouvez qu'écarter une telle suggestion.

Créer un nouvel assistant¶

Créer l'assistant ouvre le formulaire d'un nouvel assistant, avec le nom, la description et les instructions proposés déjà remplis. L'assistant d'où vient la suggestion reste tel quel. Le nouvel assistant commence sans outils et sans utilisateurs ; c'est vous qui choisissez qui peut l'utiliser. Dès que vous l'enregistrez, la suggestion est Appliquée.

Si cette dernière étape échoue, un message indique que l'assistant a été créé mais que la suggestion n'a pas pu être passée en appliquée. L'assistant reste.

Un contrôle qualité tiré des conversations¶

Une évaluation tirée de vraies conversations rédige des scénarios à partir de conversations qui se sont bien passées, avec des détails inventés. La suggestion montre chaque scénario tel qu'il sera enregistré : le titre, les étapes et leurs contrôles. Un scénario qui ne peut pas être enregistré ici, par exemple avec un contrôle que le formulaire ne connaît pas, est affiché avec la raison et n'est pas repris. Si aucun scénario ne peut être enregistré, Accepter est grisé.

• Nouvelle évaluation : Créer l'évaluation ouvre l'onglet Contrôle qualité de l'assistant avec le formulaire d'un nouveau contrôle qualité, le nom et le modèle évaluateur proposés déjà remplis. Si l'analyse n'a trouvé aucun modèle évaluateur adapté, un avertissement dit que vous devez en choisir un ; aucun n'est choisi pour vous. Dès que vous enregistrez le contrôle qualité, avec ses scénarios, la suggestion passe à Appliquée. Si cette dernière étape échoue, le contrôle qualité reste et un message le dit.
• Ajouter des scénarios : la suggestion nomme le contrôle qualité et le nombre de scénarios qu'il compte maintenant. Accepter ajoute les scénarios à la fin, en votre nom. Si le contrôle qualité a reçu une nouvelle version entre-temps, accepter n'est plus possible et vous écartez la suggestion.

Accepter demande le droit de modifier les contrôles qualité et un assistant que vous voyez ; le droit de modifier l'assistant lui-même n'est pas nécessaire. Aucune exécution ne démarre : vous la lancez vous-même.

Partager un fait¶

La suggestion montre le fait tel que la note le dira, et s'il s'agit d'un Fait ou d'une Règle. De qui il vient, ou combien de personnes l'ont dit, n'y figure pas. Accepter ouvre Partager le fait : ajustez le texte si nécessaire et choisissez sous Qui reçoit cette note Tout le monde dans l'organisation, déjà choisi, ou les membres d'un ou plusieurs groupes. Après Partager, le fait est une note dans Mémoire partagée, où vous le modifiez ou le supprimez comme toute autre note, et chaque assistant peut le consulter pour ceux qui le reçoivent.

Accepter demande le même droit qu'écrire une note dans la mémoire partagée : modifier les assistants pour toute l'organisation. Le droit sur les améliorations seul ne suffit pas. Sans une personne, un fait n'est partagé que si votre organisation le choisit sous Appliquer seul.

Publier un assistant allégé¶

Une suggestion Assistant allégé montre les deux mesures de l'essai côte à côte : Actuel et Allégé, chacune avec son score, son score moyen et son temps de réponse moyen, et le coût de chaque mesure si votre organisation affiche les coûts (Qui voit la consommation et les coûts). En dessous : sur combien de scénarios la mesure a porté, sur combien de tours de conversation par mois repose l'économie, l'économie mensuelle estimée si votre organisation affiche les coûts, et ce qui change : le modèle, les outils retirés ou les instructions plus courtes. Ce qu'un essai ne montre pas est indiqué en anglais, tel qu'écrit : un essai ne mesure que les scénarios de cette évaluation, une fois de chaque côté.

• Publier la version … publie aussitôt la version mesurée comme dernière version : chaque conversation l'utilise immédiatement. Artific termine ensuite l'assistant comme pour toute version enregistrée. Peut le faire quiconque peut modifier l'assistant.
• Écarter supprime la version mesurée ; l'assistant reste tel quel.
• Vous ne pouvez pas modifier le texte : ce qui a été mesuré est publié. Si l'assistant a reçu une nouvelle version entre-temps, ce n'est plus possible ; une analyse ultérieure réessaie.

Connecteurs et retrait de compétences¶

Faire créer un connecteur décrit ce qu'un connecteur doit faire. Artific ne peut pas créer ce connecteur : donnez la description à la personne qui construit vos connecteurs, comme connecteur ou dans l'AI Toolbox. Avec Retirer la compétence, Aller à la compétence vous mène à la compétence ; si vous la jugez superflue, supprimez-la là. Passez ensuite la suggestion avec Marquer comme fait.

Le bloc sur un assistant ou une compétence¶

Quiconque peut modifier un assistant ou une compétence voit dans le bloc Suggestions d'amélioration les suggestions ouvertes qui le concernent, chacune avec Voir. S'il n'y en a pas, il n'y a pas de bloc. Si les analyses sont désactivées, il y a une ligne, avec Configurer pour qui peut modifier les paramètres.

Si le formulaire contient des modifications non enregistrées, Voir dans un nouvel onglet ouvre la suggestion à part. Enregistrez d'abord avant d'accepter, sinon la suggestion écrit une version sans vos modifications. Si quelqu'un accepte malgré tout une suggestion entre-temps, le formulaire indique à l'enregistrement Non enregistré : il existe maintenant une version … et que cette version vient d'une suggestion d'amélioration. Votre texte reste dans le formulaire ; regardez la nouvelle version puis enregistrez de nouveau.

Analyses¶

L'onglet Analyses montre chaque analyse, la plus récente en premier : quand elle a été lancée, Comment (Selon le planning ou Manuellement, jamais par qui), le statut, la Période lue et combien de Suggestions elle a écrites. Les Appels au modèle ne s'affichent que pour qui peut voir les coûts dans votre organisation.

Une ligne ouvre l'analyse, avec ce que chaque contrôle a fait :

Analyser maintenant, en haut à droite sur les deux onglets, lance aussitôt une analyse. Seul qui peut modifier les paramètres peut l'utiliser, car chaque analyse coûte de l'argent, et pas tant que les analyses sont désactivées ou qu'une analyse est déjà en cours.

Ce qui est enregistré¶

Le journal d'audit contient, au nom de qui a agi :

Un texte ou une note n'y figure jamais. Modifier un assistant écrit en plus l'habituel assistant.changed ; partager un fait y figure une fois, avec qui le reçoit. Une analyse lancée par l'horaire ne figure pas dans le journal d'audit ; vous la trouvez dans l'onglet Analyses.

Par l'API¶

Les routes se trouvent sous /api/v1/organisations/{id}/improvements :

• GET et PATCH …/settings lisent et modifient les paramètres. Si l'environnement ne propose pas d'améliorations, la lecture indique available: false et toute autre route répond 409 improvements-not-available.
• POST …/runs lance une analyse (202), ou répond 409 analyses-off ou run-in-progress. GET …/runs liste les analyses.
• GET …/suggestions liste les suggestions, filtrables par status, check, target_kind et target_id. PATCH …/suggestions/{suggestion_id} accepte, écarte, rouvre ou marque comme fait, avec une note d'au plus 1 000 caractères.
• POST …/suggestions/{suggestion_id}/apply effectue la modification, éventuellement avec votre texte ajusté, et prend pour un fait partagé audience : everyone ou les identifiants de groupes ; POST …/publish publie de nouveau une compétence ou un brouillon écrit par Artific lui-même, et GET …/draft lit ce brouillon. PATCH …/settings prend aussi apply_level par type, et trials avec limit_eur et assistants. Un refus dit pourquoi, entre autres suggestion-placeholders, suggestion-target-moved, suggestion-not-yet et newer-suggestion.