buildBasePrompt()

buildBasePrompt() construit le prompt système de base partagé d’un Coding Agent : les instructions de comportement qui font de l’Agent un bon assistant de programmation. La fonction reçoit un PromptContext décrivant l’environnement actuel (projet, plateforme, branche git, mode et modèle), puis renvoie le prompt sous forme de chaîne.

Les chaînes propres au produit sont paramétrées au moyen de productName, coAuthorName et coAuthorEmail. Vous pouvez ainsi modifier la marque du prompt et du pied de commit sans créer de fork. Leurs valeurs par défaut sont "Mastra Code" / "noreply@mastra.ai", ce qui permet aux appelants existants de conserver une sortie identique.

Utilisez cette fonction avec createCodingAgent() lorsque vous construisez des instructions définies au moment de l’exécution pour l’Agent.

Exemple d’utilisation

Construisez le prompt de base à partir d’un PromptContext :

src/mastra/prompt.ts

import { buildBasePrompt } from '@mastra/core/coding-agent'

const prompt = buildBasePrompt({
  projectPath: process.cwd(),
  projectName: 'my-app',
  gitBranch: 'main',
  platform: process.platform,
  date: new Date().toDateString(),
  mode: 'build',
  modelId: 'openai/gpt-5',
  toolGuidance: '',
})

Pour modifier la marque du prompt, transmettez les champs du produit et du co-auteur :

const prompt = buildBasePrompt({
  // ...environment fields
  productName: 'Acme Coder',
  coAuthorName: 'Acme Bot',
  coAuthorEmail: 'bot@acme.dev',
})

Paramètres

buildBasePrompt() accepte un seul objet PromptContext.

projectPath:

string

Chemin absolu vers la racine du projet.

projectName:

string

Nom d’affichage du projet.

gitBranch?:

string

Branche git actuelle, si le projet est un dépôt git.

platform:

string

Plateforme du système d’exploitation (par exemple, la valeur de process.platform).

commonBinaries?:

{ name: string; path: string | null }[]

Binaires courants détectés sur le système, chacun avec un nom et un chemin résolu (ou null s’il est introuvable).

date:

string

Chaîne de date actuelle injectée dans le prompt.

mode:

string

Mode actif de l’Agent (par exemple, "build" ou "plan").

modelId?:

string

Identifiant du modèle actif, inclus dans la ligne Co-Authored-By du commit lorsqu’il est fourni.

activePlan?:

{ title: string; plan: string; approvedAt: string } | null

Plan actuellement approuvé, le cas échéant.

toolGuidance:

string

Section de consignes d’utilisation des Tools ajoutée au prompt.

productName?:

string

= Mastra Code

Nom d’affichage utilisé dans l’en-tête du prompt.

coAuthorName?:

string

= Mastra Code

Nom utilisé dans la ligne Co-Authored-By du commit.

coAuthorEmail?:

string

= noreply@mastra.ai

Adresse e-mail utilisée dans la ligne Co-Authored-By du commit.

Valeur renvoyée

prompt:

string

Prompt système de base du Coding Agent.

Voir aussi

• createCodingAgent()