System-Eingabeaufforderungen

Mit System-Eingabeaufforderungen können Sie das Verhalten von Agenten einschränken, domänenspezifischen Kontext hinzufügen oder den Ton und Stil der Antworten festlegen.

Standardmäßig verwendet die SDK eine integrierte System-Eingabeaufforderung, die den Agenten mit seinen Kernfunktionen ausstattet, einschließlich der Dateibearbeitung, der Codesuche und des Shell-Zugriffs. Sie können diese Eingabeaufforderung entweder ganz ersetzen oder zusätzliche Anweisungen an sie anhängen.

Ersetzen Sie die Standardeingabeaufforderung

Übergeben Sie einen String an die Option systemPrompt, um den integrierten System-Prompt vollständig zu ersetzen. Verwenden Sie diese, wenn Sie die vollständige Kontrolle über das Verhalten des Agenten benötigen und keine der Standardanweisungen wünschen.

import { createCortexCodeSession } from "cortex-code-agent-sdk";

const session = await createCortexCodeSession({
  cwd: process.cwd(),
  systemPrompt: `You are a code review assistant.
Prioritize finding bugs, security issues, and maintainability risks.
Explain the issue and suggest concrete fixes.`,
});

Warnung

Beim Ersetzen der Standardeingabeaufforderung werden alle integrierten Anweisungen entfernt, einschließlich der Anleitungen zur Verwendung von Tools und der Sicherheitsbarrieren. Ersetzen Sie die Eingabeaufforderung nur, wenn Sie die volle Kontrolle über das Verhalten des Agenten benötigen.

Anhängen an die Standardaufforderung

Um die integrierten Funktionen beizubehalten und gleichzeitig eigene Anweisungen hinzuzufügen, verwenden Sie ein System-Prompt-Preset-Objekt mit dem Feld append. Der voreingestellte Name ist implizit, sodass Sie nur {"type": "preset", "append": ...} benötigen. Dies fügt Ihre Anweisungen nach der Standard-Systemeingabeaufforderung ein.

import { createCortexCodeSession } from "cortex-code-agent-sdk";

const session = await createCortexCodeSession({
  cwd: process.cwd(),
  systemPrompt: {
    type: "preset",
    append: "Focus on Python files. Always run pytest after making changes.",
  },
});

Beide SDKs bieten auch eine Nur-Anfügen-Abkürzung:

import { createCortexCodeSession } from "cortex-code-agent-sdk";

const session = await createCortexCodeSession({
  cwd: process.cwd(),
  appendSystemPrompt: "Focus on Python files. Always run pytest after making changes.",
});

Gemeinsame Muster

Überprüfungsorientierter Code-Prüfer

Einstellung des Agenten in Bezug auf das Analyse-First-Verhalten bei der Codeüberprüfung:

import { createCortexCodeSession } from "cortex-code-agent-sdk";

const session = await createCortexCodeSession({
  cwd: process.cwd(),
  appendSystemPrompt: `You are a code reviewer. Follow these rules:
- Prioritize reading code and analyzing behavior before proposing changes.
- Do not modify files unless the user explicitly asks for an implementation.
- Identify bugs, security issues, and style problems.
- Provide specific line numbers and suggested fixes in your response.`,
});

Domänenspezifischer Experte

Fokussieren des Agenten auf eine bestimmte Technologie oder Domäne:

import { createCortexCodeSession } from "cortex-code-agent-sdk";

const session = await createCortexCodeSession({
  cwd: process.cwd(),
  appendSystemPrompt: `You are a SQL and database specialist working with Snowflake.
- Write efficient SQL queries optimized for Snowflake's columnar storage.
- Use Snowflake-specific features like VARIANT columns and FLATTEN.
- Always include LIMIT clauses in exploratory queries.
- Validate SQL syntax before suggesting changes.`,
});

Stil-Erzwinger

Stellen Sie sicher, dass der Agent bestimmte Codierungsstandards befolgt:

import { createCortexCodeSession } from "cortex-code-agent-sdk";

const session = await createCortexCodeSession({
  cwd: process.cwd(),
  appendSystemPrompt: `Enforce these coding standards in all changes:
- Use TypeScript strict mode conventions.
- Prefer const over let; never use var.
- All functions must have explicit return types.
- Use async/await instead of raw Promises.
- Run "npm run lint" after every file change.`,
});

Best Practices

Zeitpunkt des Anhängens vs. Ersetzens

Anhängen an die Standardaufforderung

Ersetzen Sie die Standardeingabeaufforderung

Hinzufügen von Domänenkontext oder -Einschränkungen

Volle Kontrolle über das Verhalten des Agenten

Beibehalten integrierter Hinweise zur Verwendung von Tools

Erstellen eines hochspezialisierten Agenten

Aufrechterhalten der Sicherheitsbarrieren

Die Standardanweisungen stehen im Konflikt mit Ihrem Anwendungsfall