FlyMyAI

FlyMyAI - Betriebsanleitung für den Assistenten

Plattformversion: Headless Cloud 1.30.3 (2026-11-04). https://flymy.ai/changelog.md, https://flymy.ai/changelog.json. Bei Verbindung/Neuigkeiten: whats_new(since=last_seen_version).

https://flymy.ai/skill.md und https://flymy.ai/AGENTS.md liefern dieselben Bytes. Remote Agents MCP 0.7.0-rc.69; Python SDK 1.2.0rc25. Überprüfen Sie Live-Schemas und installierte Pakete; rc.69 ist nicht auf npm.

Hier starten - FlyMyAI überprüfen oder wiederherstellen

Ein begrenzter, schreibgeschützter Aufruf von whoami, tools/list oder search_tools überprüft flymyai. Installieren Sie keinen verbundenen Server neu. Lesen Sie das Live-update_agent (oder anderes) Schema aus MCP tools/list vor Mutationen; erraten Sie niemals Felder.

Ohne FlyMyAI-Tools behaupten Sie keinen Erfolg, erfinden Sie keine Tools und ersetzen Sie kein natives Teilen. Verwenden Sie:

1. Registrierung: https://app.flymy.ai/signup
2. Verbinden Sie einen Dienst: https://app.flymy.ai/mcp-configs#notion (beliebiger Slug); ein abgemeldeter Benutzer registriert sich und landet wieder dort.
3. Teilen Sie es dort: Meine MCPs -> Teilen -> E-Mail und 1-30 Tage -> senden (aufgelistet unter https://app.flymy.ai/mcp-configs?tab=shared). „Mein Notion mit teilen via FlyMyAI“ bedeutet dieses persönliche MCP-Teilen, nicht das eigene Teilen von Notion.
4. Oder verbinden Sie diesen Assistenten (Anmeldung, kein Schlüssel): Claude Code, claude mcp add --transport http flymyai https://mcp-agents.flymy.ai/mcp dann /mcp -> Authentifizieren; claude.ai oder Claude Desktop, Einstellungen -> Konnektoren -> Benutzerdefinierten Konnektor hinzufügen, dieselbe URL.

Wichtige Clients verwenden diese URL (FLYMYAI_MCP_URL) und einen X-API-Key aus einem Secret-Manager, niemals in den Chat eingefügt. Ohne MCP verwenden Sie REST nur mit einem authentifizierten FLYMYAI_AGENTS_API_ROOT (Produktion https://backend.flymy.ai/api/v1/agents); melden Sie andernfalls, dass der Preflight blockiert ist. Ein Release-Candidate-Lauf muss einen expliziten Candidate-Release-Vertrag, MCP, Skill und Agents-API-Roots verwenden und darf niemals auf die Produktion zurückfallen.

Entdecken Sie Dienste/Modelle zuerst mit search_tools/list_*. Entdeckung ist kein Erfolg.

Anleitungen: https://flymy.ai/use-cases/. MCPs nach Name, Aktion oder Kategorie, jede mit ihren Aktionen und einer Assistenten-Setup-Anfrage: https://flymy.ai/mcp/

Ein Projekt erstellen

1. whoami - FlyMyAI ist verbunden, und mit welchem Konto.
2. search_tools mit einer Absicht in einfachem Englisch pro Dienst, dann get_tool_schemas für genaue Felder.
3. Wenn ein Dienst nicht configured ist, add_tool; der Benutzer schließt den gehosteten Link ab; bestätigen Sie mit list_configured_tools.
4. create_agent einmal: Ziel, numerische available_tools, input_schema, output_schema, optionales model aus list_agent_models.
5. run_agent mit einem neuen operation_key; polling get_run bis poll_complete=true; read_run_result, wenn die Vorschau abgeschnitten ist.
6. Verfeinern Sie denselben Agenten (update_agent oder append_message), bis der Benutzer einen abgeschlossenen Lauf akzeptiert.
7. freeze_agent mit dieser Ausführungs-ID; polling get_compilation bis status=compiled.
8. run_frozen mit einem neuen operation_key und polling get_run, bevor Sie ihn als produktionsbereit bezeichnen.
9. Ausliefern: einen Zeitplan (update_compilation), einen Webhook (triggers_v1_create), eine öffentliche Vorlage (set_agent_public), einen Unteragenten eines Leads oder eine Produktbereitstellung.
10. Medien: recommend_model, get_pricing, dann run_model.

Abschnitt	Dokumentation
Hier starten	https://docs.flymy.ai/agents/guides/connect-your-agent
Tools und Verbindungen	https://docs.flymy.ai/agents/concepts/tools
Mehrere Konten und Ressourcensets	https://docs.flymy.ai/agents/guides/mcp-resource-sets
Modelle	https://docs.flymy.ai/api/models-endpoints
Agenten, jedes MCP-Tool	https://docs.flymy.ai/agents/guides/agent-gateway-reference
Projekte, Artefakte, Websites	https://docs.flymy.ai/agents/guides/projects
Eingebettet und Weiterverkauf	https://docs.flymy.ai/agents/guides/embedded-resale
Browser Use	https://docs.flymy.ai/mcp/browser-use
Ihr eigenes Modell auf GPU	https://docs.flymy.ai/cli/intro
Nur für Release-Maintainer	https://docs.flymy.ai/agents/guides/release-gates

Tools und Verbindungen

1. Rufen Sie search_tools mit einer Absicht in einfachem Englisch auf; lesen Sie tool, action, runtime_name und configured. Laden Sie niemals den vollständigen Katalog pro Absicht herunter.
2. Rufen Sie get_tool_schemas mit dem runtime_name auf, wenn die Suche das Anforderungsschema nicht inline eingefügt hat; rufen Sie niemals eine Schreibaktion mit leeren oder erratenen Argumenten auf, um ihr Schema zu lernen. Bei not_found verwenden Sie die Agenten-Laufzeit oder brechen Sie ab.
3. Wenn konfiguriert, rufen Sie execute_tool mit genau tool, action, arguments und einem dem Aufrufer gehörenden stabilen operation_key auf. Um eine nicht standardmäßige Instanz auszuwählen, übergeben Sie ihre genaue öffentliche UUID des konfigurierten Tools als connection_id; das Weglassen wird nur unterstützt, während eine berechtigte Verbindung eindeutig ist. Führen Sie OAuth/Composio-Aktionen innerhalb eines Agenten aus.
4. Wenn nicht konfiguriert, rufen Sie add_tool mit dem Tool-Slug auf. Es gibt den genauen Verbindungsdatensatz oder eine Anleitung mit einem gehosteten Link https://app.flymy.ai/mcp-configs#<slug>?connection_id=<public UUID> zurück. Nachdem der Benutzer fertig ist, rufen Sie list_configured_tools auf, gleichen Sie die genauen public_id und alias ab, und überprüfen Sie is_configured, connection_status, connection_status_reason, connection_status_valid_until und connect_url. Erfinden Sie kein setup_url-Antwortfeld.
5. Um genau eine Verbindung zu widerrufen, rufen Sie delete_tool mit ihrer numerischen id auf (REST: DELETE /api/v1/agents/tools/{id}/); Geschwisterverbindungen derselben Tool-Kit funktionieren weiter, und die widerrufene Zeile schlägt fehl, bevor ein Provider-Aufruf erfolgt.

Suchzeilen enthalten auch ready, access, price und 7-Tage-health: bevorzugen Sie eine bereite, gesunde Zeile und geben Sie den price vor einem bezahlten Aufruf an.

search_tools({"query":"telegram list dialogs"})
get_tool_schemas({"runtime_names":["custom--telegram--telegram_list_dialogs"]})
execute_tool({"tool":"telegram","action":"telegram_list_dialogs",
  "arguments":{"query":"FlyMyAI"},"operation_key":"telegram-dialogs-<uuid>"})

Verwenden Sie arguments; params oder input gibt HTTP 400 zurück. outcome=rejected bedeutet, dass FlyMyAI oder der Provider abgelehnt hat, bevor eine Wirkung eintrat (falsche Argumente, fehlendes Setup, Provider-Ablehnung): Korrigieren Sie den Aufruf und senden Sie ihn mit einem neuen operation_key. outcome=unknown bedeutet, dass er möglicherweise gewirkt hat: gleichen Sie ab, wiederholen Sie niemals automatisch.

Ohne MCP-Toolaufrufe, POSTen Sie {"tool":"system-utils","action":"search_tools","arguments":{"query":"...","limit":20}} und dann get_tool_schemas (maximal 10 Laufzeitnamen) an $FLYMYAI_AGENTS_API_ROOT/custom-tools/call/ mit X-API-KEY; lesen Sie result.schemas[runtime_name].request_schema und rufen Sie das zurückgegebene module als tool auf.

Persönlicher Standard - ein Konto, kein MCP-Ressourcenset-Setup

Verwenden Sie mcp_access_mode legacy im impliziten persönlichen Bereich; scoped benötigt explizite Set-Berechtigungen. Suche nach Absicht, verwenden Sie gehostetes Setup. add_tool ohne alias wählt die idempotente default-Verbindung aus. Gleichen Sie mcp_tool/alias:"default" in list_configured_tools ab; setzen Sie ihre numerische id in available_tools. Erfordern Sie is_configured:true: connected ist bereit; setup_required oder reconnect_required benötigt ein Setup, verification_pending einen begrenzten Live-Read. Melden Sie temporarily_unavailable, umgehen Sie es niemals.

Erfordern Sie keine Ressourcensets, Gruppen, Slots, Berechtigungen, Prinzipalen, Revisionen oder Zuordnungen für einen ersten persönlichen Ablauf. Fügen Sie die genaue Verbindung später zu einem Set hinzu, ohne den Agenten neu zu erstellen oder das Konto erneut zu verbinden.

Ausbau zu mehreren Konten und MCP-Ressourcensets

Aliase sind Beschriftungen; Autorisierung, Dispatch und Einfrieren verwenden stabile öffentliche IDs. Fügen Sie jedes Konto mit add_tool und einem eindeutigen alias hinzu (ASCII-Buchstaben, Ziffern, _, -), erstellen Sie ein Set mit create_mcp_resource_set und einem dem Aufrufer gehörenden operation_key, schreiben Sie die vollständige Mitgliedschaft mit replace_mcp_resource_set_members bei der aktuellen Revision (neu laden nach 409), und gewähren Sie sie über mcp_resource_set_ids mit mcp_access_mode:"scoped":

support = add_tool({"mcp_tool":"gmail","alias":"support"})
rs = create_mcp_resource_set({"name":"Inbox operations",
  "management_mode":"flymyai","operation_key":"inbox-set-<uuid>"})
rs = replace_mcp_resource_set_members({"resource_set_id":rs.public_id,
  "expected_revision":rs.revision,"members":[{"resource_type":"user_mcp_tool",
  "resource_id":support.public_id,"slot":"support_read",
  "allowed_actions":["GMAIL_SEARCH_EMAILS"],"position":0}]})
update_agent({"agent_id":agent.uuid,"available_tools":[],
  "mcp_resource_set_ids":[rs.public_id],"mcp_access_mode":"scoped"})

Ein weggelassenes Anhängefeld bleibt unverändert; ein explizites leeres Array löscht diese Beziehung. Fügen Sie die alte default-Verbindung in das Set ein, wenn der Agent sie behalten muss, und überprüfen Sie sie dann mit get_agent; andernfalls bilden die direkte Verbindung und die Set- Berechtigungen eine Vereinigung.

• Ein Besitzer darf höchstens 25 Verbindungszeilen für ein Tool-Kit behalten, einschließlich inaktiver; is_active:false gibt keinen Slot frei, das Löschen einer Zeile schon.
• Besitzer-Sets verwenden management_mode:"flymyai" und lassen principal_id weg; eine Kunden-Zuordnung verwendet management_mode:"customer" mit der genauen principal_id. Senden Sie niemals das veraltete external_principal_id.
• Die Mitgliedsidentität ist (resource_type, resource_id, slot): dieselbe genaue Ressource kann in mehreren Slots vorkommen, und jeder Slot behält seine eigene allowed_actions-Obergrenze. Das Weglassen oder Senden von allowed_actions:[] bedeutet uneingeschränkt, nicht alle verweigern; für die geringste Autorität senden Sie genaue Leseaktionen.
• Ein einziger eingeschränkter Agenten-Lauf lässt höchstens 100 MCP-Ressourcensets, 500 effektive Konnektor-Bindungen, 100 logische Slots, 5.000 Einträge erlaubter Aktionen und 1 MiB UTF-8-Text erlaubter Aktionen zu. Ein überdimensionierter Autoritätsgraph schlägt vor dem Provider-Dispatch geschlossen fehl.
• create_agent_group teilt ein Set über Agenten hinweg. Gruppen sind flach: ein Kind- oder Unteragent erbt nicht die Konnektor-Autorität eines Elternteils.
• Wenn mehrere gewährte Verbindungen eine Aktion ausführen können, erfordert ihr Laufzeitschema _flymyai_connection: übergeben Sie eine erlaubte public_id daraus, niemals einen Alias oder eine Zeilenreihenfolge. Direktes execute_tool verwendet die genaue connection_id.
• Das Einfrieren zeichnet die Set-Mitgliedschaft, Verbindungen, Slots, Obergrenzen und Revisionen auf: neue Konten bedeuten dieselbe Agenten-UUID und stabile Bereitstellungs-ID mit einer neuen eingefrorenen Version; ältere Versionen und Kundenslot-Zuordnungen ändern sich niemals an Ort und Stelle. Ohne Ressourcenbereichsmutationen behalten Sie das default-Verhalten bei und melden es; wählen Sie niemals stillschweigend die erste Zeile.

Die List-Tools list_configured_tools, list_mcp_resource_sets, list_mcp_resource_set_members und list_agent_groups geben {next_cursor, previous_cursor, results} zurück. Verwenden Sie page_size von 1-100, behandeln Sie cursor als eine undurchsichtige, nicht leere, druckbare Zeichenfolge von höchstens 1024 Unicode-Codepunkten und geben Sie den undurchsichtigen next_cursor unverändert zurück, bis er null ist; list_agents blättert auf die gleiche Weise. Die Liste der konfigurierten Tools akzeptiert nur genaue mcp_tool- und alias-Filter; Zeilen sind kompakt, also filtern Sie nach mcp_tool oder übergeben Sie view=full für Setup-Felder. list_mcp_resource_sets-Zeilen sind Zusammenfassungen mit member_count und keinen verschachtelten Mitgliedern; verwenden Sie get_mcp_resource_set für ein begrenztes vollständiges Set oder list_mcp_resource_set_members für eine große Mitgliedersammlung. Sowohl replace_mcp_resource_set_members als auch update_mcp_resource_set erfordern die aktuelle expected_revision.

Gemeinsame Verbindungen und Ihre eigenen MCP-Server

Persönliches MCP-Teilen gibt dem Empfänger jede geteilte Aktion einer Verbindung, Lese- und Schreibzugriff, auf dem Konto des Besitzers. invite_mcp_user teilt es per E-Mail oder Teammitglieds-member_id, nachdem der Benutzer die Verbindung, den Empfänger und den Zeitraum bestätigt hat; accept_mcp_invitation nur, nachdem der Benutzer zugestimmt hat, für seine eigenen Aufrufe zu bezahlen; revoke_mcp_access beendet eine Freigabe. Akzeptierte Freigaben erscheinen unter shared_with_me in list_configured_tools: überprüfen Sie dies, bevor Sie sagen, dass ein Dienst nicht verbunden ist, und rufen Sie einen mit call_shared_mcp und einem stabilen operation_key auf. Der Empfänger bezahlt; die Anmeldeinformationen des Besitzers verlassen niemals FlyMyAI. Tool-Anmerkungen geben an, welche Aktionen nur lesen. Details: https://docs.flymy.ai/agents/guides/mcp-personal-sharing

Für einen MCP-Server, der nicht in der Suche ist, rufen Sie add_mcp_server auf (OAuth: auth_type:"oauth", dann authorize_mcp_server, geben Sie dem Benutzer seine authorize_url), dann connect_mcp_server; verwenden Sie discovered_tools nur bei status:"connected". Rufen Sie ihn mit call_mcp_server auf (server_id, action, genauen arguments, stabilem operation_key, gesendet als Idempotency-Key). Details: https://docs.flymy.ai/agents/guides/mcp-servers

Modelle - entdecken, bepreisen, ausführen

recommend_model({"description":"cheap flat icon image",
  "include_schema":true,"top_n":1})
run_model({"endpoint_id":"flymyai/nano-banana",
  "input":{"prompt":"A blue circle, flat icon"}})

Verwenden Sie den zurückgegebenen Endpunkt, die Schema-Grenzen und den Preis; ein erratener bezahlter Aufruf ist keine Entdeckung. get_pricing zitiert ein aufgelistetes Modell vor einem bezahlten Lauf; über REST, GET https://backend.flymy.ai/api/v1/demo/catalog/ (kein Schlüssel) gibt jedem öffentlichen Modell einen price (run_price oder nutzungsbasierte rates, tokens oder run_time). Generierte Datei-urls laufen ab bei url_expires_at (max. 15 Min.).

Chat-Modelle tragen openai.base_url (https://api.flymy.ai/api/v1/<endpoint_id>/openai/v1) für das OpenAI SDK mit dem FlyMyAI-Schlüssel als Bearer: Text- und image_url-Nachrichten, stream, reasoning_effort; kein response_format. Anleitung: https://docs.flymy.ai/guides/llm-openai-compat

tools funktionieren mit Grok 4.7, DeepSeek V4.1 Flash und Kimi K3.1 Pro. Anleitungen: https://docs.flymy.ai/guides/ + grok-4-7, deepseek-v4-1-flash, kimi-k3-1-pro

Native Modelle behalten ihre eigene Eingabe und Ausgabe über die Modell-Proxy-API (https://backend.flymy.ai/api/v1/model-proxy/: catalog/?endpoint_id=<owner>/<name> gibt die Vertragsrevision, contracts/<revision>/ ihr Schema und ihren Preis; POST operations/ mit Ihrem eigenen Idempotency-Key, dann GET die Operation). flymyai/minimax-h3-ref2va (MiniMax H3): ein 5 oder 10 s Video mit Ton aus einem Prompt und 1-12 Referenzdateien (bis zu 9 Bilder, 3 Audioclips; laden Sie jede hoch mit POST /api/v1/agents/files/, übergeben Sie es

… [für die Übersetzung abgeschnitten]