Choicera

Choicera in deinen eigenen KI-Agenten einbinden

Für Entwicklerinnen und Entwickler bei Firmen, die Choicera in einen eigenen KI-Agenten einbauen, zum Beispiel einen KI-Coach in einer Studio-Software. Auf dieser Seite steht, was du zum Einbinden brauchst. Jedes Feld jedes Werkzeugs, alle Fehlercodes und alle Grenzen stehen in der Referenz. Dein Agent bekommt Werkzeuge und Felder außerdem über tools/list selbst.

Begriffe: „Partner“ bist du, die Firma, die Choicera einbindet. „Mitglied“ ist die Person, die deinen Agenten nutzt und dafür ihr Choicera-Konto verbindet. „Marken“ sind die Hersteller, deren Produkte Choicera zeigt.

In Kürze

In 5 Schritten

1. Adresse eintragen. Der MCP-Server liegt unter https://choicera.com/agent/mcp (Streamable HTTP, zustandslos, nur POST). Ruf ihn von deinem Server aus auf, nicht aus dem Browser. Der Katalog geht ohne Anmeldung.

2. Konto verbinden. Jedes Mitglied meldet sich einmal über OAuth 2.1 bei Choicera an und gibt deinem Produkt den Zugriff frei. Frag dafür advisor checkout:personalized offline_access an. Siehe Verbinden.

3. Beratung durchreichen. Choicera fragt, dein Agent reicht weiter, das Mitglied antwortet. Am Ende steht ein Plan mit Produkten und ein Link zur Planseite. Siehe Ablauf.

4. Pflichttexte zeigen, Links unverändert lassen. Siehe Deine Pflichten.

5. Testen. Gegen den echten Dienst, mit einem eigenen Choicera-Konto. Siehe Testen.

Verbinden

BerechtigungWofür
advisorBeratung, Plan, frühere Beratungen, gespeicherte Angaben, Bewertungen
checkout:personalizedProdukte und Warenkorb zum Plan, Link zur Planseite
offline_accessErneuerungstoken
checkout:catalogLink zu einem einzelnen Katalogprodukt, nur wenn du ihn brauchst

advisor:medication und advisor:maternal fragst du als Partner nicht an. Ohne sie fragt die Beratung nicht nach Medikamenten, Schwangerschaft oder Stillzeit, und die Pflichttexte sagen, was deshalb nicht geprüft wurde.

Alle Einzelheiten zu Transport, Kopfzeilen, Einwilligungsbildschirm und Laufzeiten stehen in der Referenz.

Ablauf

1. Beratung beginnen: start_consultation mit Ziel (goalSlugs aus get_goals), Thema (topic aus list_topics) oder nur dem Anliegen des Mitglieds in seinen Worten (message). Angaben, die das Mitglied schon gemacht hat, gibst du in statedProfile mit; das Mitglied bestätigt sie auf einer Karte, danach fragt die Beratung nur, was fehlt (Angaben beim Start).

2. Fragen weiterreichen: Jede Antwort der Beratung zeigst du dem Mitglied. Trägt sie options, zeig sie als Auswahl; das Mitglied darf immer auch frei antworten. Die Antwort geht mit send_message zurück, ein Formular mit answer_intake. Das wiederholst du, bis die Antwort ready_to_generate lautet.

3. Plan holen: get_plan erstellt den Plan. Solange er entsteht, kommt pending mit retryAfterSeconds; frag danach erneut. Zuerst kommt meist ein Entwurf, den das Mitglied Zeile für Zeile beantwortet.

4. Produkte wählen: get_plan_products liefert je Wirkstoff passende Produkte und zwei fertige Sets. Das Mitglied legt ein Set mit fill_cart_with_set oder einzelne Produkte mit add_to_cart in den Warenkorb und ändert ihn mit update_cart_line.

5. Bestellen: get_checkout_link mit der planId nennt den Warenkorb mit Verkäufern, Versand und Gesamtpreis und liefert den Link, direkt in die Kasse von Choicera, wenn alle Verkäufer dort bezahlt werden, sonst zur Planseite; dort bestellt und bezahlt das Mitglied. Danach zeigt get_orders Zahl- und Versandstand.

Dazu gibt es Werkzeuge, um frühere Beratungen fortzusetzen (list_consultations, get_consultation), gespeicherte Angaben zu lesen und bestätigen zu lassen (get_profile, confirm_profile), Wirkstoffe und Marken im Plan zu ändern und Plan und Antworten zu bewerten (rate_plan, rate_message). Die vollständige Liste steht in der Referenz.

Wähle nie für das Mitglied: keine Option, kein Formularfeld, kein Produkt, keine Menge und keine Bestätigung eines Warnhinweises. Dein Agent darf erklären und weiterreichen; entscheiden muss das Mitglied.

Deine Pflichten

Diese Punkte sind Bedingung für die Nutzung (Nutzungsrichtlinie für KI-Agenten, Partnerbedingungen).

KennungInhaltWo er steht
F2„Eine abwechslungsreiche, ausgewogene Ernährung und eine gesunde Lebensweise sind wichtig.“ Englisch: „A varied, balanced diet and a healthy lifestyle are important.“am Plan; an einer Antwort, die eine zugelassene Gesundheitsaussage enthält
F4 (KI-Hinweis)„Diese Empfehlung wurde automatisiert durch das KI-System von Choicera erstellt.“ Englisch: „This recommendation was generated automatically by Choicera's AI system.“an der ersten Antwort jeder Beratung; an jedem Text der Beratung außer reinen Fragen (question) und Formularen; an jeder Antwort ab dem Entwurf (plan_generated, refining_intake, completed); an Entwurf, Plan und Produkten zum Plan
F5 (keine ärztliche Beratung)„Dies ist keine medizinische Beratung und ersetzt keine ärztliche oder apothekerliche Beratung. Bei bestehenden Erkrankungen, Medikamenteneinnahme, Schwangerschaft oder Stillzeit hole vor der Einnahme ärztlichen Rat ein.“ Englisch: „This is not medical advice and does not replace advice from a doctor or pharmacist. If you have a medical condition, take medication, or are pregnant or breastfeeding, seek medical advice before taking supplements.“an denselben Stellen wie F4, dazu an jeder Antwort mit einer zugelassenen Gesundheitsaussage
F6 (Werbelink)„Werbelink: Choicera kann bei einem Kauf über diesen Link eine Provision vom Partnershop erhalten. Choicera vermittelt ausschließlich Produkte seiner Partnermarken.“ Englisch: „Advertising link: Choicera may receive a commission from the partner shop for a purchase through this link. Choicera only refers products from its partner brands.“an jedem Kauf- und Produktlink
F7Gutschein-Bedingungen, englisch „Voucher terms“am Link, wenn ein Gutschein dazugehört
F8 (Preisangabe)Gesamtpreis, Grundpreis und, wo vorhanden, Referenzpreis (niedrigster Gesamtpreis der letzten 30 Tage), etwa „Preisangabe: Gesamtpreis 20,80 €; Grundpreis 173,33 €/kg.“, englisch „Price information: total price 20,80 €; base price 173,33 €/kg.“am Preis im Katalog und am Link, wenn ein Preis dazugehört
F10„Wechselwirkungen mit Medikamenten konnten nicht geprüft werden“, „Eignung bei Schwangerschaft/Stillzeit nicht geprüft“ Englisch: „Interactions with medication could not be checked“, „Suitability during pregnancy/breastfeeding not checked“an denselben Stellen wie F5 und am Plan, ohne die jeweilige Freigabe
F11 (Rücksprache)„Bitte sprich vor der Einnahme mit Arzt oder Apotheke.“ Englisch: „Please talk to a doctor or pharmacist before taking it.“an jedem Wirkstoff des fertigen Plans und der Produkte zum Plan (consultNotice)

Die Pflichttexte kommen in der Sprache des Choicera-Kontos; im Katalog folgen F6 und F8 der Sprache aus language. Eine reine Frage der Beratung trägt keine Pflichttexte, ihr compliance ist leer.

Ohne advisor:medication steht einmal je Beratung an der Stelle, an der sonst das Medikamenten-Formular käme, dieser feste Satz am Ende von reply.text, vor den Pflichttexten: „Medikamente kann die Beratung hier nicht berücksichtigen, weil dein KI-Assistent dafür keine Freigabe hat. Wenn du sie einbeziehen möchtest, verbinde Choicera in deinem KI-Assistenten neu und setze bei der Anmeldung zusätzlich das Häkchen „Medikamente“.“ Englisch: „The advice here cannot take medication into account because your AI assistant has no permission for it. If you want to include it, connect Choicera to your AI assistant again and, when you sign in, also allow Choicera to process your medication details.“ Er gilt heute für jeden Client ohne diese Freigabe.

So bekommst du sie fertig:

Grenzen

Die Grenzen gelten je Mitglied und je OAuth-Client: Beratungsaufrufe derzeit 30 je Minute je Mitglied, Anfragen 120 je Minute je Mitglied. Überlastung kommt als HTTP 429 oder 503 mit Retry-After, bei Werkzeugen als Fehler rate_limited mit retryAfterSeconds. Halte dich daran und sag uns vor dem Start, mit welcher Last du rechnest. Alle Grenzen stehen in der Referenz.

Fehler

Kauf und Zuordnung

Daten

Testen

Den Katalog testest du sofort ohne Konto:

curl -s https://choicera.com/agent/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Den ganzen Ablauf testest du mit einem eigenen Choicera-Konto gegen den echten Dienst; ein eigenes Testsystem gibt es nicht. Beratungen und Pläne entstehen dabei echt, gekauft wird nur, wenn du selbst bestellst. Bestelle zum Testen nicht über deinen eigenen Partner-Link. Lasttests nur nach Absprache.

Kontakt und Änderungen