> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt

# 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()`](https://mastra.zisheng.pro/fr/reference/coding-agent/create-coding-agent) 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` :

```typescript
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 :

```typescript
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`): Nom d’affichage utilisé dans l’en-tête du prompt. (Default: `Mastra Code`)

**coAuthorName** (`string`): Nom utilisé dans la ligne Co-Authored-By du commit. (Default: `Mastra Code`)

**coAuthorEmail** (`string`): Adresse e-mail utilisée dans la ligne Co-Authored-By du commit. (Default: `noreply@mastra.ai`)

## Valeur renvoyée

**prompt** (`string`): Prompt système de base du Coding Agent.

## Voir aussi

- [`createCodingAgent()`](https://mastra.zisheng.pro/fr/reference/coding-agent/create-coding-agent)