Zum Inhalt springen

KI-Assistenten

Assistenten, die für dich antworten, privat oder öffentlich.

KI-Assistenten öffnen
Am 20. November 2026 mit dem Dashboard abgeglichen

AI Assistants hat sechs öffentliche Methoden. Sie wirken auf einen Assistenten, der schon existiert: die Favoritenmarkierung, die Anheftung, das Archiv und sein Bild. Jede handelt für das Konto, dessen API-Schlüssel du verwendest.

Einen Assistenten erstellen, seine Einrichtung, seine Voreinstellungen und seine Einladungen ändern, eine Einladung senden, seine Sitzungen lesen und einen Tarif wählen geht im Dashboard. Dafür gibt es heute keine öffentliche Methode.

Sende mit deinem Schlüssel eine Anfrage an eine Methode:

curl -s https://xuda.ai/cpi/favorite_ai_agent \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","agent_id":"YOUR_ASSISTANT_ID"}'
const res = await fetch('https://xuda.ai/cpi/favorite_ai_agent', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    agent_id: 'YOUR_ASSISTANT_ID',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/favorite_ai_agent',
    json={
        'api_key': 'YOUR_API_KEY',
        'agent_id': 'YOUR_ASSISTANT_ID',
    },
)

Eine gute Antwort hat code 1. Eine abgelehnte hat einen negativen code und nennt den Grund in data. Siehe Eine Methode aufrufen für die Anfrageformen.

Die Listen Assistants und Skills teilen sich diese Methoden, daher heißt das Feld agent_id: Es ist die ID des Assistenten. Jede Methode nimmt außerdem ein optionales workspace_id, um in einem anderen Workspace als deinem eigenen zu handeln. Der Aufrufer muss ihn besitzen.

Einen Assistenten markieren

  • favorite_ai_agent nimmt agent_id und markiert den Assistenten als Favoriten. Das ist das Herz auf seiner Karte, und die Auswahl Favoriten im Menü Anzeigen der Seite listet ihn auf.
  • unfavorite_ai_agent nimmt dasselbe Feld und nimmt die Markierung weg.
  • pin_ai_agent nimmt agent_id und markiert den Assistenten als angeheftet.
  • unpin_ai_agent nimmt dasselbe Feld und nimmt die Anheftung weg.

Einen Assistenten archivieren

archive_ai_agent nimmt agent_id und archiviert den Assistenten. Er verlässt die Liste Aktiv und erscheint unter Archiviert, und seine Unterhaltungen werden mit ihm archiviert. Eine optionale conversation_id beschränkt die archivierten Unterhaltungen auf diese eine.

Nur der Macher des Assistenten kann ihn archivieren. Ein Assistent, der mit dir geteilt wurde, wird mit Operation not allowed abgelehnt. Ein Assistent, den du an andere freigegeben hast, wird mit active share found abgelehnt, bis die Freigabe endet.

Einen archivierten Assistenten wiederherstellen und ihn endgültig löschen sind Dashboard-Aktionen: Aus Archiv holen und Löschen im Menü der Karte, unter dem Status Archiviert.

Ein Bild zeichnen

generate_ai_agent_image nimmt agent_id und zeichnet ein neues Bild für einen Assistenten, der dir gehört, mit dem Generator, der beim Erstellen eines Assistenten läuft. Nutze es, wenn eine Karte den Platzhalter zeigt. Es läuft im Hintergrund als Job, und das neue Bild erscheint beim nächsten Laden.

Die Auswahlmöglichkeiten des Bildes, wie Land, Geschlecht, Branche und deine eigenen Worte, die Nutzung deines eigenen Porträts und ein hochgeladenes Bild werden im Einrichtungsfenster des Dashboards festgelegt.

Was jeder Tarif ändert

Keine dieser Methoden wird von einem Tarif gehalten. Was ein Tarif ändert, ist, was der Assistent für Besucher tun kann, und das ist über eine Methode nicht erreichbar. Siehe Tarife und Abrechnung.

Wie findest du diese Anleitung?

Zuletzt aktualisiert am 16. November 2026