Anleitung · Framework

Formfeed in Plain tool calling

MCP ist richtig, wenn der Agent Vorlagen selbst entdecken soll. Soll er immer nur Rechnungen erzeugen, ist ein eigenes Werkzeug einfacher: Sein Schema ist die Rechnung, das Modell kann keine falsche Vorlage wählen, und das SDK übernimmt Wiederholungen und Idempotenz.

1. 1

   Test-Schlüssel anlegen

   Melden Sie sich in der App an, öffnen Sie API-Schlüssel und legen Sie einen Schlüssel in der Testumgebung an. Testrenderings werden nicht berechnet, genau richtig, solange ein Agent Ihre Vorlagen noch kennenlernt. Für den Produktivbetrieb wechseln Sie auf einen Live-Schlüssel.

2. 2

   Pakete installieren

   npm install @anthropic-ai/sdk @formfeed/sdk zod
   # or: pip install anthropic formfeed

3. 3

   Den Formfeed-Server hinzufügen

   Das Werkzeug ruft renders.create mit fester Vorlage auf. Dieselbe Funktion taugt in jedem Framework als Werkzeug: OpenAI Function Calling, LangChain @tool oder der hier gezeigte Claude Tool Runner.

   TypeScript

   invoice-agent.tsTypeScript

   import Anthropic from '@anthropic-ai/sdk';
   import { betaZodTool } from '@anthropic-ai/sdk/helpers/beta/zod';
   import { Formfeed } from '@formfeed/sdk';
   import { z } from 'zod';
   
   const anthropic = new Anthropic();
   const formfeed = new Formfeed({ apiKey: process.env.FORMFEED_API_KEY! });
   
   const renderInvoice = betaZodTool({
     name: 'render_invoice',
     description: 'Renders an invoice PDF with the invoice-de template and returns its download URL.',
     inputSchema: z.object({
       number: z.string(),
       customer: z.object({ name: z.string(), street: z.string(), zip: z.string(), city: z.string() }),
       lines: z.array(z.object({ description: z.string(), qty: z.number(), price: z.number() })),
     }),
     run: async (invoice) => {
       const render = await formfeed.renders.create({ template: 'invoice-de', data: { invoice } });
       const done = render.status === 'succeeded' ? render : await formfeed.renders.waitFor(render.id);
       return done.download_url ?? `Render ${done.id} failed: ${done.error?.message}`;
     },
   });
   
   const message = await anthropic.beta.messages.toolRunner({
     model: 'claude-opus-5-5',
     max_tokens: 16000,
     tools: [renderInvoice],
     messages: [
       {
         role: 'user',
         content: 'Invoice Olvarest GmbH, Beispielweg 2, 54321 Beispielstadt: 8 h consulting at 120 EUR. Number 2026-0042.',
       },
     ],
   });
   console.log(message.content);

   Python

   certificate_agent.pyPython

   import os
   
   import anthropic
   from anthropic import beta_tool
   from formfeed import Formfeed
   
   formfeed = Formfeed(api_key=os.environ["FORMFEED_API_KEY"])
   
   
   @beta_tool
   def render_certificate(name: str, course: str, date: str) -> str:
       """Renders a course certificate as PDF and returns the download URL.
   
       Args:
           name: Full name of the participant.
           course: Title of the course.
           date: Completion date as ISO 8601, e.g. 2026-09-10.
       """
       data = {"name": name, "course": course, "date": date}
       render = formfeed.renders.create(template="certificate", data=data)
       return render.download_url or f"Render {render.id} is {render.status}"
   
   
   prompt = "Jane Doe finished Analytical Engines 101 today. I need her certificate."
   runner = anthropic.Anthropic().beta.messages.tool_runner(
       model="claude-opus-5-5",
       max_tokens=16000,
       tools=[render_certificate],
       messages=[{"role": "user", "content": prompt}],
   )
   message = runner.until_done()
   print(next(block.text for block in message.content if block.type == "text"))

4. 4

   Verbindung prüfen

   Führen Sie es mit einem Test-Schlüssel aus: Das Rendering wird nicht berechnet und erscheint im Render-Log der App, samt den Daten, die das Modell geschickt hat, wenn der Workspace Anfragedaten aufbewahrt (eine Einstellung der bezahlten Pläne, voreingestellt aus).