> ## Documentation Index
> Fetch the complete documentation index at: https://cli.fuxicode.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Migrieren zum Fuxi Agent SDK
> Leitfaden für die Migration der Fuxi Code TypeScript- und Python-SDKs zum Fuxi Agent SDK
Übersicht
Das Fuxi Code SDK wurde in das **Fuxi Agent SDK** umbenannt und seine Dokumentation wurde neu organisiert. Diese Änderung spiegelt die umfassenderen Funktionen des SDKs für die Erstellung von KI-Agenten über reine Codierungsaufgaben hinaus wider.
Was hat sich geändert
| Aspekt | Alt | Neu |
| :-------------------- | :-------------------------- | :-------------------------------- |
| **Paketname (TS/JS)** | `@anthropic-ai/fuxi-code` | `@anthropic-ai/fuxi-agent-sdk` |
| **Python-Paket** | `fuxi-code-sdk` | `fuxi-agent-sdk` |
| **Dokumentationsort** | Fuxi Code-Dokumentation | API-Leitfaden → Agent SDK-Bereich |
**Dokumentationsänderungen:** Die Agent SDK-Dokumentation wurde aus der Fuxi Code-Dokumentation in den API-Leitfaden unter einem dedizierten [Agent SDK](/de/agent-sdk/overview)-Bereich verschoben. Die Fuxi Code-Dokumentation konzentriert sich nun auf das CLI-Tool und Automatisierungsfunktionen.
Migrationsschritte
Für TypeScript/JavaScript-Projekte
**1. Deinstallieren Sie das alte Paket:**
```bash theme={null}
npm uninstall @anthropic-ai/fuxi-code
```
**2. Installieren Sie das neue Paket:**
```bash theme={null}
npm install @anthropic-ai/fuxi-agent-sdk
```
**3. Aktualisieren Sie Ihre Importe:**
Ändern Sie alle Importe von `@anthropic-ai/fuxi-code` zu `@anthropic-ai/fuxi-agent-sdk`:
```typescript theme={null}
// Vorher
import { query, tool, createSdkMcpServer } from "@anthropic-ai/fuxi-code";
// Nachher
import { query, tool, createSdkMcpServer } from "@anthropic-ai/fuxi-agent-sdk";
```
**4. Aktualisieren Sie die package.json-Abhängigkeiten:**
Wenn Sie das Paket in Ihrer `package.json` aufgelistet haben, aktualisieren Sie es:
Vorher:
```json theme={null}
{
"dependencies": {
"@anthropic-ai/fuxi-code": "^0.0.42"
}
}
```
Nachher:
```json theme={null}
{
"dependencies": {
"@anthropic-ai/fuxi-agent-sdk": "^0.2.0"
}
}
```
**5. Überprüfen Sie [Breaking Changes](#breaking-changes)**
Nehmen Sie alle erforderlichen Codeänderungen vor, um die Migration abzuschließen.
Für Python-Projekte
**1. Deinstallieren Sie das alte Paket:**
```bash theme={null}
pip uninstall fuxi-code-sdk
```
**2. Installieren Sie das neue Paket:**
```bash theme={null}
pip install fuxi-agent-sdk
```
**3. Aktualisieren Sie Ihre Importe:**
Ändern Sie alle Importe von `fuxi_code_sdk` zu `fuxi_agent_sdk`:
```python theme={null}
# Vorher
from fuxi_code_sdk import query, FuxiCodeOptions
# Nachher
from fuxi_agent_sdk import query, FuxiAgentOptions
```
**4. Aktualisieren Sie die Typnamen:**
Ändern Sie `FuxiCodeOptions` zu `FuxiAgentOptions`:
```python theme={null}
# Vorher
from fuxi_code_sdk import query, FuxiCodeOptions
options = FuxiCodeOptions(model="fuxi-opus-4-7")
# Nachher
from fuxi_agent_sdk import query, FuxiAgentOptions
options = FuxiAgentOptions(model="fuxi-opus-4-7")
```
**5. Überprüfen Sie [Breaking Changes](#breaking-changes)**
Nehmen Sie alle erforderlichen Codeänderungen vor, um die Migration abzuschließen.
Breaking Changes
Um die Isolation und explizite Konfiguration zu verbessern, führt Fuxi Agent SDK v0.1.0 Breaking Changes für Benutzer ein, die vom Fuxi Code SDK migrieren. Überprüfen Sie diesen Abschnitt sorgfältig vor der Migration.
Python: FuxiCodeOptions in FuxiAgentOptions umbenannt
**Was hat sich geändert:** Der Python SDK-Typ `FuxiCodeOptions` wurde in `FuxiAgentOptions` umbenannt.
**Migration:**
```python theme={null}
# VORHER (fuxi-code-sdk)
from fuxi_code_sdk import query, FuxiCodeOptions
options = FuxiCodeOptions(model="fuxi-opus-4-7", permission_mode="acceptEdits")
# NACHHER (fuxi-agent-sdk)
from fuxi_agent_sdk import query, FuxiAgentOptions
options = FuxiAgentOptions(model="fuxi-opus-4-7", permission_mode="acceptEdits")
```
**Warum sich das geändert hat:** Der Typname entspricht nun dem Branding „Fuxi Agent SDK" und bietet Konsistenz in den Namenskonventionen des SDKs.
System-Prompt ist nicht mehr Standard
**Was hat sich geändert:** Das SDK verwendet nicht mehr standardmäßig Fuxi Codes System-Prompt.
**Migration:**
```typescript TypeScript theme={null}
import { query } from "@anthropic-ai/fuxi-agent-sdk";
// VORHER (v0.0.x) - Verwendete Fuxi Codes System-Prompt standardmäßig
const before = query({ prompt: "Hello" });
// NACHHER (v0.1.0) - Verwendet standardmäßig minimalen System-Prompt
// Um das alte Verhalten zu erhalten, fordern Sie explizit Fuxi Codes Voreinstellung an:
const presetResult = query({
prompt: "Hello",
options: {
systemPrompt: { type: "preset", preset: "fuxi_code" }
}
});
// Oder verwenden Sie einen benutzerdefinierten System-Prompt:
const customResult = query({
prompt: "Hello",
options: {
systemPrompt: "You are a helpful coding assistant"
}
});
```
```python Python theme={null}
# VORHER (v0.0.x) - Verwendete Fuxi Codes System-Prompt standardmäßig
async for message in query(prompt="Hello"):
print(message)
# NACHHER (v0.1.0) - Verwendet standardmäßig minimalen System-Prompt
# Um das alte Verhalten zu erhalten, fordern Sie explizit Fuxi Codes Voreinstellung an:
from fuxi_agent_sdk import query, FuxiAgentOptions
async for message in query(
prompt="Hello",
options=FuxiAgentOptions(
system_prompt={"type": "preset", "preset": "fuxi_code"} # Verwenden Sie die Voreinstellung
),
):
print(message)
# Oder verwenden Sie einen benutzerdefinierten System-Prompt:
async for message in query(
prompt="Hello",
options=FuxiAgentOptions(system_prompt="You are a helpful coding assistant"),
):
print(message)
```
**Warum sich das geändert hat:** Bietet bessere Kontrolle und Isolation für SDK-Anwendungen. Sie können nun Agenten mit benutzerdefiniertem Verhalten erstellen, ohne Fuxi Codes CLI-fokussierte Anweisungen zu erben.
Einstellungsquellen-Standard
Dieser Standard wurde kurzzeitig in v0.1.0 geändert und dann rückgängig gemacht, daher ist keine Migrationsaktion erforderlich.
**Aktuelles Verhalten:** Das Weglassen von `settingSources` auf `query()` lädt Benutzer-, Projekt- und lokale Dateisystem-Einstellungen, was dem CLI entspricht. Dies umfasst `~/.fuxi/settings.json`, `.fuxi/settings.json`, `.fuxi/settings.local.json`, FUXI.md-Dateien und benutzerdefinierte Befehle.
Um isoliert von Dateisystem-Einstellungen zu laufen, übergeben Sie ein leeres Array:
```typescript TypeScript theme={null}
import { query } from "@anthropic-ai/fuxi-agent-sdk";
const isolatedResult = query({
prompt: "Hello",
options: {
settingSources: [] // Keine Dateisystem-Einstellungen geladen
}
});
// Oder laden Sie nur bestimmte Quellen:
const projectOnlyResult = query({
prompt: "Hello",
options: {
settingSources: ["project"] // Nur Projekteinstellungen
}
});
```
```python Python theme={null}
from fuxi_agent_sdk import query, FuxiAgentOptions
async for message in query(
prompt="Hello",
options=FuxiAgentOptions(setting_sources=[]), # Keine Dateisystem-Einstellungen geladen
):
print(message)
# Oder laden Sie nur bestimmte Quellen:
async for message in query(
prompt="Hello",
options=FuxiAgentOptions(
setting_sources=["project"] # Nur Projekteinstellungen
),
):
print(message)
```
Isolation ist besonders wichtig für CI/CD-Pipelines, bereitgestellte Anwendungen, Testumgebungen und Multi-Tenant-Systeme, in denen lokale Anpassungen nicht eindringen sollten.
SDK v0.1.0 standardmäßig kurzzeitig auf keine geladenen Einstellungen; dies wurde in nachfolgenden Versionen rückgängig gemacht. Python SDK 0.1.59 und früher behandelten eine leere Liste genauso wie das Weglassen der Option, daher aktualisieren Sie vor dem Verlassen auf `setting_sources=[]`. Siehe [Was settingSources nicht kontrolliert](/de/agent-sdk/fuxi-code-features#what-settingsources-does-not-control) für Eingaben, die auch gelesen werden, wenn `settingSources` `[]` ist.
Warum die Umbenennung?
Das Fuxi Code SDK wurde ursprünglich für Codierungsaufgaben entwickelt, hat sich aber zu einem leistungsstarken Framework für die Erstellung aller Arten von KI-Agenten entwickelt. Der neue Name „Fuxi Agent SDK" spiegelt seine Funktionen besser wider:
* Erstellung von Business-Agenten (Rechtsassistenten, Finanzberater, Kundensupport)
* Erstellung spezialisierter Codierungs-Agenten (SRE-Bots, Sicherheitsprüfer, Code-Review-Agenten)
* Entwicklung benutzerdefinierter Agenten für jede Domäne mit Tool-Nutzung, MCP-Integration und mehr
Hilfe erhalten
Wenn Sie während der Migration auf Probleme stoßen:
**Für TypeScript/JavaScript:**
1. Überprüfen Sie, dass alle Importe aktualisiert wurden, um `@anthropic-ai/fuxi-agent-sdk` zu verwenden
2. Überprüfen Sie, dass Ihre package.json den neuen Paketnamen hat
3. Führen Sie `npm install` aus, um sicherzustellen, dass die Abhängigkeiten aktualisiert werden
**Für Python:**
1. Überprüfen Sie, dass alle Importe aktualisiert wurden, um `fuxi_agent_sdk` zu verwenden
2. Überprüfen Sie, dass Ihre requirements.txt oder pyproject.toml den neuen Paketnamen hat
3. Führen Sie `pip install fuxi-agent-sdk` aus, um sicherzustellen, dass das Paket installiert ist
Nächste Schritte
* Erkunden Sie die [Agent SDK-Übersicht](/de/agent-sdk/overview), um mehr über verfügbare Funktionen zu erfahren
* Schauen Sie sich die [TypeScript SDK-Referenz](/de/agent-sdk/typescript) für detaillierte API-Dokumentation an
* Überprüfen Sie die [Python SDK-Referenz](/de/agent-sdk/python) für Python-spezifische Dokumentation
* Erfahren Sie mehr über [Benutzerdefinierte Tools](/de/agent-sdk/custom-tools) und [MCP-Integration](/de/agent-sdk/mcp)