Excel-Zielwertsuche über eine API
Gleich am Anfang: SpreadAPI hat keinen Endpunkt für die Zielwertsuche (Goal Seek) und keinen für den Solver. Ein Service nimmt Eingabewerte, berechnet die Arbeitsmappe und gibt die Ausgaben zurück. Er sucht nicht nach einer Eingabe.
Die Frage der Zielwertsuche, "welche Eingabe liefert mir dieses Ergebnis?", kannst du trotzdem beantworten, von außen. Dieser Beitrag zeigt drei Wege. Zwei davon liefen am 13. November 2026 gegen den öffentlichen Demo-Angebotsrechner der SpreadAPI-Startseite; der Code ist der Code, den wir ausgeführt haben, und die Iterationen sind die echten. {serviceId} steht für die ID des Service.
Warum es in einem Service keine Zielwertsuche gibt
Zielwertsuche und Solver sind Werkzeuge der Excel-Anwendung. Sie sind keine Formeln. Sie ändern eine Zelle immer wieder und beobachten eine andere. Ein SpreadAPI-Service führt die Formeln deiner Arbeitsmappe aus: Jeder Aufruf setzt die Eingaben für diesen einen Aufruf, rechnet und liest die Ausgaben. Die veröffentlichte Arbeitsmappe selbst wird durch einen Aufruf nicht verändert.
Die Suche muss also an einer von zwei Stellen stattfinden: im Code, der den Service aufruft, oder in der Arbeitsmappe als Formel.
Die Frage
Der Demo-Service kalkuliert ein Software-Angebot aus licenses, edition und discount. Für 50 Business-Lizenzen mit 5 % Rabatt liefert er eine Gesamtsumme von 25.716,06.
Die Frage für diesen Beitrag: Welcher Rabatt bringt die Gesamtsumme für 50 Business-Lizenzen auf 24.000?
Der Rabatt darf zwischen 0 und 0.5 (50 %) liegen. Das ist der Suchbereich.
Weg 1: Bisektion über einzelne Aufrufe
Die Bisektion halbiert den Bereich in jedem Schritt. Berechne die Mitte; liegt die Summe noch über dem Ziel, muss der Rabatt größer sein, also geht es in der oberen Hälfte weiter, sonst in der unteren.
// Goal seek from the outside: bisection over single calls
const URL =
'https://spreadapi.io/api/v1/services/{serviceId}/execute?flatten=true';
async function total(discount) {
const response = await fetch(URL, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
inputs: { licenses: 50, edition: 'Business', discount }
})
});
const data = await response.json();
if (!response.ok) throw new Error(data.message || data.error);
return data.result.total;
}
async function goalSeek(target, low, high, tolerance, maxSteps) {
// the total falls when the discount rises
const atLow = await total(low);
const atHigh = await total(high);
console.log(`discount ${low} -> ${atLow}, discount ${high} -> ${atHigh}`);
if (target > atLow || target < atHigh) {
throw new Error('Target is outside the range the inputs allow');
}
for (let step = 1; step <= maxSteps; step++) {
const middle = Math.round(((low + high) / 2) * 10000) / 10000;
const value = await total(middle);
console.log(`step ${step}: discount ${middle} -> total ${value}`);
if (Math.abs(value - target) <= tolerance) return { discount: middle, total: value, step };
if (value > target) low = middle; else high = middle;
}
return { discount: (low + high) / 2, total: null, step: maxSteps };
}
console.log(await goalSeek(24000, 0, 0.5, 10, 10));Die Ausgabe des Laufs:
discount 0 -> 27069.47, discount 0.5 -> 13534.74
step 1: discount 0.25 -> total 20302.17
step 2: discount 0.125 -> total 23685.82
step 3: discount 0.0625 -> total 25377.58
step 4: discount 0.0938 -> total 24530.35
step 5: discount 0.1094 -> total 24108.08
step 6: discount 0.1172 -> total 23896.89
step 7: discount 0.1133 -> total 24002.55
{ discount: 0.1133, total: 24002.55, step: 7 }Ein Rabatt von 11,33 % ergibt eine Gesamtsumme von 24.002,55. Das liegt innerhalb der Toleranz von 10, die wir verlangt haben, nach neun Aufrufen: zwei für die Enden des Bereichs und sieben Schritte.
Was du zu diesem Weg wissen solltest:
- Er braucht kein Wissen über das Modell. Er setzt nur voraus, dass sich die Ausgabe in eine Richtung bewegt, wenn die Eingabe steigt. Hier fällt die Summe, wenn der Rabatt steigt.
- Jeder Schritt ist ein Aufruf. Eine engere Toleranz kostet mehr Aufrufe: Jeder Schritt halbiert den verbleibenden Bereich.
- Die ersten beiden Aufrufe prüfen, ob das Ziel überhaupt erreichbar ist. Ohne diese Prüfung läuft die Schleife bis zum Ende und liefert Unsinn.
- Die Schritte laufen nacheinander, weil jeder vom Ergebnis des vorigen abhängt.
Weg 2: Ein Raster in einem Batch, dann interpolieren
Der zweite Weg fragt mehrere Punkte auf einmal ab. Die Discovery-Adresse eines Service hat eine Batch-Aktion, die 2 bis 20 Szenarien in einer Anfrage nimmt. Sechs Punkte über den Bereich zeigen, wo das Ziel liegt; eine Gerade zwischen den beiden Nachbarn liefert den Schätzwert; eine zweite Anfrage prüft ihn.
// Goal seek from the outside: a grid in one batch, then interpolate
const DISCOVERY = 'https://spreadapi.io/d/{serviceId}';
async function batch(discounts) {
const response = await fetch(DISCOVERY, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
action: 'batch',
scenarios: discounts.map((discount) => ({
label: String(discount),
inputs: { licenses: 50, edition: 'Business', discount }
}))
})
});
const data = await response.json();
if (!data.success) throw new Error(data.error);
return data.scenarios.map((s) => ({
discount: Number(s.label),
total: s.outputs.find((o) => o.name === 'total').value
}));
}
const target = 24000;
// 1. Six points across the allowed range, one request
const grid = await batch([0, 0.1, 0.2, 0.3, 0.4, 0.5]);
console.table(grid);
// 2. The two neighbours that enclose the target
const index = grid.findIndex((point) => point.total < target);
const [a, b] = [grid[index - 1], grid[index]];
// 3. A straight line between them
const share = (a.total - target) / (a.total - b.total);
const guess = Math.round((a.discount + share * (b.discount - a.discount)) * 10000) / 10000;
// 4. Check the guess, together with a neighbour, in a second request
console.table(await batch([guess, Math.round((guess + 0.0001) * 10000) / 10000]));Die Ausgabe des Laufs:
┌─────────┬──────────┬──────────┐
│ (index) │ discount │ total │
├─────────┼──────────┼──────────┤
│ 0 │ 0 │ 27069.47 │
│ 1 │ 0.1 │ 24362.52 │
│ 2 │ 0.2 │ 21655.58 │
│ 3 │ 0.3 │ 18948.63 │
│ 4 │ 0.4 │ 16241.68 │
│ 5 │ 0.5 │ 13534.74 │
└─────────┴──────────┴──────────┘
┌─────────┬──────────┬──────────┐
│ (index) │ discount │ total │
├─────────┼──────────┼──────────┤
│ 0 │ 0.1134 │ 23999.85 │
│ 1 │ 0.1135 │ 23997.14 │
└─────────┴──────────┴──────────┘Ein Rabatt von 11,34 % ergibt 23.999,85. Das brauchte zwei Anfragen mit insgesamt acht Berechnungen und landete näher am Ziel als die Bisektion.
Was du zu diesem Weg wissen solltest:
- Die Gerade hat so gut funktioniert, weil in dieser Arbeitsmappe die Summe gleichmäßig mit dem Rabatt fällt: Je 10 Punkte Rabatt senken sie um etwa 2.707. Dein Modell ist vielleicht nicht so. Mit Preisstufen, Obergrenzen oder Mindestgebühren zwischen zwei Rasterpunkten liegt die Gerade daneben. Dann sende ein zweites, feineres Raster zwischen den beiden Nachbarn, statt zu interpolieren.
- Das Raster zeigt dir auch die Form des Modells. Wenn sich die Summen nicht in eine Richtung bewegen, siehst du es hier, und die Bisektion wäre das falsche Werkzeug gewesen.
- Jedes Szenario zählt als ein Aufruf des Service. Ein Batch spart Anfragen und Wartezeit, keine Aufrufe.
- Ein Batch fasst höchstens 20 Szenarien.
Weg 3: Die Umkehrformel in die Arbeitsmappe legen
Wenn die Frage oft kommt, ist die sauberste Antwort eine Formel. Wer die Arbeitsmappe pflegt, ergänzt eine Eingabezelle für das Ziel und eine Ergebniszelle, die die nötige Eingabe berechnet. Dann beantwortet ein Aufruf die Frage, und die Regel steht dort, wo der Rest der Logik steht.
Für die Rabattfrage ist die Formel kurz, weil die Summe gleichmäßig mit dem Rabatt fällt:
=1 - Zielsumme / SummeOhneRabattMit den Zahlen aus den Läufen oben ist das 1 − 24.000 / 27.069,47 = 0,1134, der Wert, den das Raster gefunden hat. Das haben wir von Hand aus den gemessenen Summen berechnet; die Demo-Arbeitsmappe enthält keine solche Zelle.
Was du zu diesem Weg wissen solltest:
- Er funktioniert nur dort, wo sich das Modell mit Formeln umkehren lässt. Bei einem Kredit geht das oft: Excel hat
BWfür "welcher Kredit passt zu dieser Rate" undZINSundZZRfür Zinssatz und Laufzeit. Bei einem Modell mit Verweisen und Stufen ist eine geschlossene Formel womöglich nicht möglich. - Er ist eine Änderung an der Arbeitsmappe. Sie muss importiert und veröffentlicht werden wie jede andere Änderung.
- Er ist der einzige der drei Wege, den ein KI-Assistent mit einem einzigen Tool-Aufruf nutzen kann.
Welcher Weg wann
- Eine einmalige Frage, ein unbekanntes Modell: Bisektion. Wenig Code, keine Annahmen außer der einen Richtung.
- Du willst die Kurve sehen, oder das Modell hat Stufen: das Batch-Raster, mit einem feineren zweiten Raster.
- Die Frage gehört zum Produkt: die Umkehrformel in der Arbeitsmappe.
Und mehrere Variablen mit Nebenbedingungen?
Das macht in Excel der Solver, und dafür gibt es in SpreadAPI kein Gegenstück. Wenn du es brauchst, läuft die Suche in deinem Code, mit einer Optimierungsbibliothek deiner Wahl, und der Service ist die Funktion, die sie auswertet. Zähle die Aufrufe, bevor du anfängst: Eine Suche über mehrere Variablen kann viele Auswertungen brauchen, jede ist ein Aufruf auf die Monatsaufrufe des Plans, und ein Service beantwortet höchstens 1.000 Aufrufe pro Minute. Siehe Aufruf-Limits.
KI-Assistenten und Zielwertsuche
Ein Assistent, der über MCP mit einem Service verbunden ist, hat ein Tool für eine Berechnung und ein Tool, das 2 bis 20 Szenarien in einem Aufruf vergleicht. Damit kann er bei einer Frage wie "was bräuchte ich für ..." mehrere Werte ausprobieren. Ob er so sorgfältig sucht wie der Code oben, hängt vom Modell ab. Wenn deine Nutzer solche Fragen regelmäßig stellen, gib dem Assistenten mit Weg 3 eine direkte Antwort.
Ein Assistent kann über einen Service keine Zellen deiner veröffentlichten Arbeitsmappe ändern, und der Tab KI-Bereiche des Editors bietet das auch nicht: Einen Bereich hinzuzufügen ist in der App als "coming soon" markiert. Was heute funktioniert, steht in KI-Bereiche.
Was du im Blick behalten solltest
- Gespeicherte Ergebnisse. Gleiche Eingaben werden bis zu 15 Minuten aus einem gespeicherten Ergebnis beantwortet. Für eine Suche ist das willkommen. Es zählt trotzdem als Aufruf.
- Rundung. Der Code rundet den Rabatt auf vier Nachkommastellen, damit er keine Werte wie 0.11328125 sendet. Entscheide vor der Suche, welche Genauigkeit für deine Eingabe sinnvoll ist.
- Grenzen der Eingaben. Ein Wert außerhalb des erlaubten Bereichs einer Eingabe wird mit HTTP 400 abgelehnt. Halte den Suchbereich innerhalb der Grenzen des Service; die Discovery-Adresse listet sie auf.
- Ein Ziel, das nicht erreichbar ist. Das Bisektions-Skript prüft, ob das Ziel zwischen den Ergebnissen an den Enden des Bereichs liegt. Das Raster-Skript tut das nicht: Liegt kein Rasterpunkt unter dem Ziel, schlägt es fehl. Ergänze diese Prüfung, bevor du es ernsthaft einsetzt.