#ctx.ai

Dans RunJS, ctx.ai permet de déclencher des tâches d'employé IA. Il est utile dans JSBlock, JSAction et d'autres interactions où un bouton, un formulaire ou un flux métier doit confier un travail à un employé IA précis.

ctx.ai ne fait que déclencher des tâches. Il ne renvoie pas le résultat d'exécution de la tâche. Après l'appel, la tâche entre dans le flux de conversation de l'employé IA.

#Méthodes

#ctx.ai.triggerTask()

Déclenche directement une tâche d'employé IA.

ctx.ai.triggerTask(options: TriggerTaskOptions): void

Champs courants de Task:

#Ajouter le contexte de blocs de page

message.workContext sert actuellement à transmettre des blocs de page. Placez-y le uid FlowModel du bloc cible:

message: {
  user: 'Review the current users table and summarize operational risks.',
  workContext: [
    {
      type: 'flow-model',
      uid: 'USERS_TABLE_BLOCK_UID',
    },
  ],
}

Pour utiliser le JSBlock actuel comme contexte, utilisez le uid du modèle actuel:

workContext: [
  {
    type: 'flow-model',
    uid: ctx.model.uid,
  },
],

#Spécifier le modèle

model spécifie le modèle d'une tâche. S'il est omis, la configuration de modèle par défaut de l'employé IA est utilisée. null signifie qu'aucun modèle au niveau de la tâche n'est spécifié.

model: {
  llmService: 'openai-main',
  model: 'gpt-4.1',
}

#Configurer les skills / tools

skillSettings spécifie les skills et tools disponibles pour une tâche. S'il est omis, la configuration de capacités de l'employé IA est utilisée.

skillSettings: {
  skillsVersion: 2,
  toolsVersion: 2,
  skills: ['business-analysis-report'],
  tools: ['businessReportGenerator'],
}

Pour désactiver explicitement toutes les skills ou tools de cette tâche, passez des tableaux vides et conservez les champs de version:

skillSettings: {
  skillsVersion: 2,
  toolsVersion: 2,
  skills: [],
  tools: [],
}

Exemple:

if (!ctx.ai?.triggerTask) {
  ctx.message.error(ctx.t('AI employee task API is not available.'));
  return;
}

ctx.ai.triggerTask({
  aiEmployee: 'viz',
  open: true,
  tasks: [
    {
      title: ctx.t('Daily operations handoff brief'),
      message: {
        system:
          'You prepare reusable daily operations handoff briefs. Focus on risks, blockers, decisions, owners, and next actions.',
        user: [
          "Prepare today's operations handoff brief.",
          'Cover customer escalations, SLA risks, approvals, and follow-up owners.',
          'Return a concise brief that can be posted to the team channel.',
        ].join('\n'),
      },
      autoSend: true,
      webSearch: false,
    },
  ],
});

ctx.message.success(ctx.t('AI employee task triggered.'));

Si aiEmployee est une chaîne, NocoBase recherche une correspondance exacte sur username parmi les employés IA accessibles à l'utilisateur actuel.

#ctx.ai.triggerModelTask()

Lit une tâche depuis un modèle d'action d'employé IA sur la page et la déclenche.

ctx.ai.triggerModelTask(uid: string, taskIndex: number, options?: TriggerModelTaskOptions): void

if (!ctx.ai?.triggerModelTask) {
  ctx.message.error(ctx.t('AI employee task API is not available.'));
  return;
}

const weeklyReviewActionUid = 'AI_EMPLOYEE_ACTION_MODEL_UID';

ctx.ai.triggerModelTask(weeklyReviewActionUid, 0, {
  open: true,
});

ctx.message.success(ctx.t('Configured AI employee task triggered.'));

Si le modèle cible n'existe pas, si aucun employé IA n'est configuré, ou si l'index indiqué ne correspond à aucune tâche, aucune tâche n'est déclenchée et un avertissement est affiché dans la console.

#Notes

• triggerTask() et triggerModelTask() sont fire-and-forget. Ils ne renvoient pas le résultat d'exécution de la tâche.
• Les chaînes aiEmployee correspondent uniquement à AIEmployee.username de façon exacte.
• triggerModelTask() utilise un taskIndex basé sur 0.
• message.workContext décrit actuellement uniquement le contexte de blocs de page.

#Liens associés

• ctx.message: Afficher des messages légers avant et après le déclenchement.
• ctx.render: Rendre des boutons ou des formulaires dans JSBlock.
• ctx.model: Obtenir les informations du FlowModel actuel.