mirror of
https://github.com/simstudioai/sim.git
synced 2026-04-06 03:00:16 -04:00
* fix: update i18n.lock * feat(docs): enhance documentation with new sections on file handling, form deployment, quick reference, agent skills, and A2A integration
344 lines
12 KiB
Plaintext
344 lines
12 KiB
Plaintext
---
|
||
title: Copilot
|
||
---
|
||
|
||
import { Callout } from 'fumadocs-ui/components/callout'
|
||
import { Card, Cards } from 'fumadocs-ui/components/card'
|
||
import { Image } from '@/components/ui/image'
|
||
import { MessageCircle, Package, Zap, Infinity as InfinityIcon, Brain, BrainCircuit } from 'lucide-react'
|
||
|
||
Copilot ist dein Assistent im Editor, der dir hilft, Workflows mit Sim Copilot zu erstellen und zu bearbeiten sowie diese zu verstehen und zu verbessern. Er kann:
|
||
|
||
- **Erklären**: Beantwortet Fragen zu Sim und deinem aktuellen Workflow
|
||
- **Anleiten**: Schlägt Bearbeitungen und Best Practices vor
|
||
- **Bearbeiten**: Nimmt Änderungen an Blöcken, Verbindungen und Einstellungen vor, wenn du zustimmst
|
||
|
||
<Callout type="info">
|
||
Copilot ist ein von Sim verwalteter Dienst. Für selbst gehostete Installationen generiere einen Copilot API-Schlüssel in der gehosteten App (sim.ai → Einstellungen → Copilot)
|
||
1. Gehe zu [sim.ai](https://sim.ai) → Einstellungen → Copilot und generiere einen Copilot API-Schlüssel
|
||
2. Setze `COPILOT_API_KEY` in deiner selbst gehosteten Umgebung auf diesen Wert
|
||
</Callout>
|
||
|
||
## Kontextmenü (@)
|
||
|
||
Verwende das `@` Symbol, um auf verschiedene Ressourcen zu verweisen und Copilot mehr Kontext über deinen Arbeitsbereich zu geben:
|
||
|
||
<Image
|
||
src="/static/copilot/copilot-menu.png"
|
||
alt="Copilot-Kontextmenü mit verfügbaren Referenzoptionen"
|
||
width={600}
|
||
height={400}
|
||
/>
|
||
|
||
Das `@` Menü bietet Zugriff auf:
|
||
- **Chats**: Verweise auf vorherige Copilot-Gespräche
|
||
- **Alle Workflows**: Verweise auf beliebige Workflows in deinem Arbeitsbereich
|
||
- **Workflow-Blöcke**: Verweise auf bestimmte Blöcke aus Workflows
|
||
- **Blöcke**: Verweise auf Blocktypen und Vorlagen
|
||
- **Wissen**: Verweise auf deine hochgeladenen Dokumente und Wissensdatenbank
|
||
- **Dokumentation**: Verweise auf Sim-Dokumentation
|
||
- **Vorlagen**: Verweise auf Workflow-Vorlagen
|
||
- **Logs**: Verweise auf Ausführungsprotokolle und Ergebnisse
|
||
|
||
Diese kontextbezogenen Informationen helfen Copilot, genauere und relevantere Unterstützung für deinen spezifischen Anwendungsfall zu bieten.
|
||
|
||
## Modi
|
||
|
||
<Cards>
|
||
<Card
|
||
title={
|
||
<span className="inline-flex items-center gap-2">
|
||
<MessageCircle className="h-4 w-4 text-muted-foreground" />
|
||
Fragen
|
||
</span>
|
||
}
|
||
>
|
||
<div className="m-0 text-sm">
|
||
Frage-Antwort-Modus für Erklärungen, Anleitungen und Vorschläge ohne Änderungen an deinem Workflow vorzunehmen.
|
||
</div>
|
||
</Card>
|
||
<Card
|
||
title={
|
||
<span className="inline-flex items-center gap-2">
|
||
<Package className="h-4 w-4 text-muted-foreground" />
|
||
Agent
|
||
</span>
|
||
}
|
||
>
|
||
<div className="m-0 text-sm">
|
||
Erstellen-und-Bearbeiten-Modus. Copilot schlägt spezifische Änderungen vor (Blöcke hinzufügen, Variablen verbinden, Einstellungen anpassen) und wendet sie an, wenn du zustimmst.
|
||
</div>
|
||
</Card>
|
||
</Cards>
|
||
|
||
<div className="flex justify-center">
|
||
<Image
|
||
src="/static/copilot/copilot-mode.png"
|
||
alt="Copilot-Modusauswahl-Oberfläche"
|
||
width={600}
|
||
height={400}
|
||
className="my-6"
|
||
/>
|
||
</div>
|
||
|
||
## Tiefenebenen
|
||
|
||
<Cards>
|
||
<Card
|
||
title={
|
||
<span className="inline-flex items-center gap-2">
|
||
<Zap className="h-4 w-4 text-muted-foreground" />
|
||
Schnell
|
||
</span>
|
||
}
|
||
>
|
||
<div className="m-0 text-sm">Am schnellsten und günstigsten. Ideal für kleine Änderungen, einfache Arbeitsabläufe und geringfügige Anpassungen.</div>
|
||
</Card>
|
||
<Card
|
||
title={
|
||
<span className="inline-flex items-center gap-2">
|
||
<InfinityIcon className="h-4 w-4 text-muted-foreground" />
|
||
Auto
|
||
</span>
|
||
}
|
||
>
|
||
<div className="m-0 text-sm">Ausgewogene Geschwindigkeit und Denkleistung. Empfohlene Standardeinstellung für die meisten Aufgaben.</div>
|
||
</Card>
|
||
<Card
|
||
title={
|
||
<span className="inline-flex items-center gap-2">
|
||
<Brain className="h-4 w-4 text-muted-foreground" />
|
||
Erweitert
|
||
</span>
|
||
}
|
||
>
|
||
<div className="m-0 text-sm">Mehr Denkleistung für umfangreichere Arbeitsabläufe und komplexe Änderungen bei gleichzeitiger Leistungsfähigkeit.</div>
|
||
</Card>
|
||
<Card
|
||
title={
|
||
<span className="inline-flex items-center gap-2">
|
||
<BrainCircuit className="h-4 w-4 text-muted-foreground" />
|
||
Behemoth
|
||
</span>
|
||
}
|
||
>
|
||
<div className="m-0 text-sm">Maximale Denkleistung für tiefgreifende Planung, Fehlerbehebung und komplexe architektonische Änderungen.</div>
|
||
</Card>
|
||
</Cards>
|
||
|
||
### Modusauswahl-Oberfläche
|
||
|
||
Du kannst einfach zwischen verschiedenen Denkmodi über die Modusauswahl in der Copilot-Oberfläche wechseln:
|
||
|
||
<Image
|
||
src="/static/copilot/copilot-models.png"
|
||
alt="Copilot-Modusauswahl zeigt den erweiterten Modus mit MAX-Umschalter"
|
||
width={600}
|
||
height={300}
|
||
/>
|
||
|
||
Die Oberfläche ermöglicht dir:
|
||
- **Denkebene auswählen**: Wähle zwischen Schnell, Auto, Erweitert oder Behemoth
|
||
- **MAX-Modus aktivieren**: Umschalten für maximale Denkfähigkeiten, wenn du die gründlichste Analyse benötigst
|
||
- **Modusbeschreibungen anzeigen**: Verstehe, wofür jeder Modus optimiert ist
|
||
|
||
Wähle deinen Modus basierend auf der Komplexität deiner Aufgabe - verwende Schnell für einfache Fragen und Behemoth für komplexe architektonische Änderungen.
|
||
|
||
## Abrechnung und Kostenberechnung
|
||
|
||
### Wie Kosten berechnet werden
|
||
|
||
Die Copilot-Nutzung wird pro Token vom zugrundeliegenden LLM abgerechnet:
|
||
|
||
- **Eingabe-Tokens**: werden zum Basispreis des Anbieters berechnet (**zum Selbstkostenpreis**)
|
||
- **Ausgabe-Tokens**: werden mit dem **1,5-fachen** des Basis-Ausgabepreises des Anbieters berechnet
|
||
|
||
```javascript
|
||
copilotCost = (inputTokens × inputPrice + outputTokens × (outputPrice × 1.5)) / 1,000,000
|
||
```
|
||
|
||
| Komponente | Angewendeter Tarif |
|
||
|------------|------------------------|
|
||
| Eingabe | inputPrice |
|
||
| Ausgabe | outputPrice × 1,5 |
|
||
|
||
<Callout type="warning">
|
||
Die angezeigten Preise spiegeln die Tarife vom 4. September 2025 wider. Überprüfen Sie die Anbieter-Dokumentation für aktuelle Preise.
|
||
</Callout>
|
||
|
||
<Callout type="info">
|
||
Modellpreise werden pro Million Tokens angegeben. Die Berechnung teilt durch 1.000.000, um die tatsächlichen Kosten zu ermitteln. Siehe <a href="/execution/costs">die Seite zur Kostenberechnung</a> für Hintergründe und Beispiele.
|
||
</Callout>
|
||
|
||
Fahre mit der Maus über eine deiner Nachrichten und klicke auf **Bearbeiten**, um sie zu ändern und erneut zu senden. Dies ist nützlich, um deine Eingaben zu verfeinern.
|
||
|
||
### Nachrichtenwarteschlange
|
||
|
||
Wenn du eine Nachricht sendest, während Copilot noch antwortet, wird sie in die Warteschlange gestellt. Du kannst:
|
||
- Warteschlangennachrichten im erweiterbaren Warteschlangenpanel anzeigen
|
||
- Eine Nachricht aus der Warteschlange sofort senden (bricht die aktuelle Antwort ab)
|
||
- Nachrichten aus der Warteschlange entfernen
|
||
|
||
## Dateianhänge
|
||
|
||
Klicke auf das Anhang-Symbol, um Dateien mit deiner Nachricht hochzuladen. Unterstützte Dateitypen umfassen:
|
||
- Bilder (Vorschau-Thumbnails werden angezeigt)
|
||
- PDFs
|
||
- Textdateien, JSON, XML
|
||
- Andere Dokumentformate
|
||
|
||
Dateien werden als anklickbare Thumbnails angezeigt, die in einem neuen Tab geöffnet werden.
|
||
|
||
## Checkpoints & Änderungen
|
||
|
||
Wenn Copilot Änderungen an deinem Workflow vornimmt, speichert es Checkpoints, damit du bei Bedarf zurückkehren kannst.
|
||
|
||
### Checkpoints anzeigen
|
||
|
||
Fahre mit der Maus über eine Copilot-Nachricht und klicke auf das Checkpoints-Symbol, um gespeicherte Workflow-Zustände für diese Nachricht anzuzeigen.
|
||
|
||
### Änderungen rückgängig machen
|
||
|
||
Klicke bei jedem Checkpoint auf **Rückgängig machen**, um deinen Workflow auf diesen Zustand zurückzusetzen. Ein Bestätigungsdialog warnt dich, dass diese Aktion nicht rückgängig gemacht werden kann.
|
||
|
||
### Änderungen akzeptieren
|
||
|
||
Wenn Copilot Änderungen vorschlägt, kannst du:
|
||
- **Akzeptieren**: Die vorgeschlagenen Änderungen anwenden (`Mod+Shift+Enter`)
|
||
- **Ablehnen**: Die Änderungen verwerfen und deinen aktuellen Workflow beibehalten
|
||
|
||
## Denkblöcke
|
||
|
||
Bei komplexen Anfragen kann Copilot seinen Denkprozess in erweiterbaren Denkblöcken anzeigen:
|
||
|
||
- Blöcke werden automatisch erweitert, während Copilot denkt
|
||
- Klicken zum manuellen Erweitern/Reduzieren
|
||
- Zeigt die Dauer des Denkprozesses an
|
||
- Hilft dir zu verstehen, wie Copilot zu seiner Lösung gekommen ist
|
||
|
||
## Optionsauswahl
|
||
|
||
Wenn Copilot mehrere Optionen präsentiert, kannst du auswählen mit:
|
||
|
||
| Steuerung | Aktion |
|
||
|---------|--------|
|
||
| **1-9** | Option nach Nummer auswählen |
|
||
| **Pfeiltaste auf/ab** | Zwischen Optionen navigieren |
|
||
| **Eingabetaste** | Hervorgehobene Option auswählen |
|
||
|
||
Ausgewählte Optionen sind hervorgehoben; nicht ausgewählte Optionen erscheinen durchgestrichen.
|
||
|
||
## Tastenkombinationen
|
||
|
||
| Tastenkombination | Aktion |
|
||
|----------|--------|
|
||
| `@` | Kontextmenü öffnen |
|
||
| `/` | Slash-Befehle öffnen |
|
||
| `Arrow Up/Down` | Menüelemente navigieren |
|
||
| `Enter` | Menüelement auswählen |
|
||
| `Esc` | Menüs schließen |
|
||
| `Mod+Shift+Enter` | Copilot-Änderungen akzeptieren |
|
||
|
||
## Nutzungslimits
|
||
|
||
Die Copilot-Nutzung wird pro Token des zugrunde liegenden LLM abgerechnet. Wenn Sie Ihr Nutzungslimit erreichen, fordert Copilot Sie auf, Ihr Limit zu erhöhen. Sie können die Nutzung in Schritten (50 $, 100 $) von Ihrer aktuellen Basis aus hinzufügen.
|
||
|
||
<Callout type="info">
|
||
Siehe die [Seite zur Kostenberechnung](/execution/costs) für Abrechnungsdetails.
|
||
</Callout>
|
||
## Copilot MCP
|
||
|
||
Sie können Copilot als MCP-Server in Ihrem bevorzugten Editor oder AI-Client verwenden. Damit können Sie Sim-Workflows direkt aus Tools wie Cursor, Claude Code, Claude Desktop und VS Code erstellen, testen, bereitstellen und verwalten.
|
||
|
||
### Generieren eines Copilot-API-Schlüssels
|
||
|
||
Um sich mit dem Copilot-MCP-Server zu verbinden, benötigen Sie einen **Copilot-API-Schlüssel**:
|
||
|
||
1. Gehen Sie zu [sim.ai](https://sim.ai) und melden Sie sich an
|
||
2. Navigieren Sie zu **Einstellungen** → **Copilot**
|
||
3. Klicken Sie auf **API-Schlüssel generieren**
|
||
4. Kopieren Sie den Schlüssel – er wird nur einmal angezeigt
|
||
|
||
Der Schlüssel sieht aus wie `sk-sim-copilot-...`. Sie werden ihn in der folgenden Konfiguration verwenden.
|
||
|
||
### Cursor
|
||
|
||
Fügen Sie Folgendes zu Ihrer `.cursor/mcp.json` (Projektebene) oder den globalen Cursor-MCP-Einstellungen hinzu:
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"sim-copilot": {
|
||
"url": "https://www.sim.ai/api/mcp/copilot",
|
||
"headers": {
|
||
"X-API-Key": "YOUR_COPILOT_API_KEY"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
Ersetzen Sie `YOUR_COPILOT_API_KEY` durch den oben generierten Schlüssel.
|
||
|
||
### Claude Code
|
||
|
||
Führen Sie den folgenden Befehl aus, um den Copilot MCP-Server hinzuzufügen:
|
||
|
||
```bash
|
||
claude mcp add sim-copilot \
|
||
--transport http \
|
||
https://www.sim.ai/api/mcp/copilot \
|
||
--header "X-API-Key: YOUR_COPILOT_API_KEY"
|
||
```
|
||
|
||
Ersetzen Sie `YOUR_COPILOT_API_KEY` durch Ihren Schlüssel.
|
||
|
||
### Claude Desktop
|
||
|
||
Claude Desktop benötigt [`mcp-remote`](https://www.npmjs.com/package/mcp-remote), um sich mit HTTP-basierten MCP-Servern zu verbinden. Fügen Sie Folgendes zu Ihrer Claude Desktop-Konfigurationsdatei hinzu (`~/Library/Application Support/Claude/claude_desktop_config.json` unter macOS):
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"sim-copilot": {
|
||
"command": "npx",
|
||
"args": [
|
||
"-y",
|
||
"mcp-remote",
|
||
"https://www.sim.ai/api/mcp/copilot",
|
||
"--header",
|
||
"X-API-Key: YOUR_COPILOT_API_KEY"
|
||
]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
Ersetzen Sie `YOUR_COPILOT_API_KEY` durch Ihren Schlüssel.
|
||
|
||
### VS Code
|
||
|
||
Fügen Sie Folgendes zu Ihrer VS Code `settings.json` oder Workspace `.vscode/settings.json` hinzu:
|
||
|
||
```json
|
||
{
|
||
"mcp": {
|
||
"servers": {
|
||
"sim-copilot": {
|
||
"type": "http",
|
||
"url": "https://www.sim.ai/api/mcp/copilot",
|
||
"headers": {
|
||
"X-API-Key": "YOUR_COPILOT_API_KEY"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
Ersetzen Sie `YOUR_COPILOT_API_KEY` durch Ihren Schlüssel.
|
||
|
||
<Callout type="info">
|
||
Für selbst gehostete Deployments ersetzen Sie `https://www.sim.ai` durch Ihre selbst gehostete Sim-URL.
|
||
</Callout>
|