본문으로 건너뛰기

빌드베이스Prompt()

buildBasePrompt()코딩 Agent에 대한 공유 기반 시스템 Prompt, 즉 Agent를 좋은 코딩 보조자로 만드는 행동 지침을 구축합니다. 소요되는 시간PromptContext현재 환경(프로젝트, 플랫폼, Git 브랜치, 모드, Model)을 설명하고 Prompt를 문자열로 반환합니다.

제품별 문자열은 productName, coAuthorName, coAuthorEmail을 통해 매개변수화되므로, 포크하지 않고도 Prompt와 커밋 트레일러의 브랜드를 변경할 수 있습니다. 기본값은 "Mastra Code" / "noreply@mastra.ai"이므로 기존 호출자는 동일한 출력을 유지합니다. Agent에 런타임 정의 지침을 빌드할 때 createCodingAgent()와 함께 사용하세요.

사용예
사용예에 대한 직접 링크

다음에서 기본 Prompt를 구축합니다.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: '',
})

Prompt의 브랜드를 변경하려면 제품 및 공동 작성자 필드를 전달하세요.

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

매개변수
매개변수에 대한 직접 링크

buildBasePrompt()한 개를 가져간다PromptContext object.

projectPath:

string
프로젝트 루트의 절대 경로입니다.

projectName:

string
프로젝트의 표시 이름입니다.

gitBranch?:

string
프로젝트가 git 저장소인 경우 현재 git 브랜치입니다.

platform:

string
운영 체제 플랫폼입니다(예: process.platform의 값).

commonBinaries?:

{ name: string; path: string | null }[]
시스템에서 감지된 일반 바이너리입니다. 각각 이름과 확인된 경로를 포함하며, 찾지 못한 경우 경로는 null입니다.

date:

string
Prompt에 삽입되는 현재 날짜 문자열입니다.

mode:

string
활성 Agent 모드입니다(예: "build" 또는 "plan").

modelId?:

string
활성 Model의 식별자이며, 제공된 경우 커밋의 Co-Authored-By 줄에 포함됩니다.

activePlan?:

{ title: string; plan: string; approvedAt: string } | null
현재 승인된 계획이 있는 경우 해당 계획입니다.

toolGuidance:

string
Prompt에 추가되는 Tool 사용 지침 섹션입니다.

productName?:

string
= Mastra Code
Prompt 헤더에 사용되는 표시 이름입니다.

coAuthorName?:

string
= Mastra Code
커밋의 Co-Authored-By 줄에 사용되는 이름입니다.

coAuthorEmail?:

string
= noreply@mastra.ai
커밋의 Co-Authored-By 줄에 사용되는 이메일입니다.

보고
보고에 대한 직접 링크

prompt:

string
코딩 Agent의 기본 시스템 Prompt입니다.
On this page