Connect tools & data

API-forbindelser

Gør ethvert HTTP-API til en funktion, som din agent kan kalde midt i en samtale: Indsæt en cURL-kommando, så opretter guiden værktøjsdefinitionen, parametrene og godkendelsen.

API-forbindelser er brugerdefinerede HTTP-funktioner, som dine agenter kan kalde under en samtale — slå en ordre op, oprette en sag, hente kontostatus fra din egen backend. Du definerer endpointet én gang under Forbindelser → API'er (/dashboard/api-connections); agenter, der har forbindelsen tilknyttet, kan derefter kalde den, når samtalen kræver det.

Der er to måder at oprette en på: Indsæt noget, som guiden kan analysere, eller konfigurer forbindelsen manuelt.

Den hurtige vej: indsæt og analyser#

1. Klik på Ny API-forbindelse

   Dialogboksen åbner i guiden. Indsæt en eksempelkommando med cURL, en OpenAPI/Swagger-specifikation, en Postman-eksport, et TypeScript- interface eller et Zod-skema i feltet.

2. Klik på Analyser

   ThunderPhone udleder hele forbindelsen fra det, du indsætter — URL, metode, headere og et parameterskema baseret på de forespørgsels- parametre og den request body, den fandt. Headere, du indsatte (herunder godkendelsesheadere), overføres til endpointkonfigurationen.

3. Bekræft de fremhævede felter

   Den udledte konfiguration åbnes med de gættede felter fremhævet til gennemgang. Tilpas navne, beskrivelser og parametertyper, så agenten forstår, hvornår og hvordan funktionen skal kaldes — beskrivelsen er det, modellen læser.

4. Valider og gem

   Når du gemmer, køres der først en live-testanmodning mod dit endpoint. Hvis anmodningen fejler, gemmes forbindelsen ikke — ret URL'en, godkendelses- headerne eller bodyen, og prøv igen. Ved succes gemmes forbindelsen med mærket Valideret.

Hvis guiden ikke kan finde en request-URL i det, du indsætter, siger den det — inkluder et fuldt http(s)-endpoint, og prøv igen.

Manuel opsætning#

Klik på Konfigurer manuelt → i guiden (eller Vil du have AI til at udlede dette? Prøv guiden → for at gå tilbage). Den manuelle opsætning har to redigeringsværktøjer:

• Visuel — formularfelter til visningsnavn, funktionsnavn, request- URL, metode (POST, GET, PUT, PATCH, DELETE), brugerdefinerede headere og parameterskemaet (Tilføj egenskab for hvert argument, agenten kan angive).
• JSON — den samme definition som rå JSON til indsættelse eller finjustering af en værktøjsspecifikation direkte.

Et panel med Testanmodning (valgfrit) giver dig mulighed for at sende den konfigurerede anmodning før lagring og viser status, svartid og en forhåndsvisning af svaret. Valider og gem kører altid denne test og gemmer kun ved succes.

Administrer dine forbindelser#

Hver forbindelsesrække viser dens valideringsstatus — Valideret, Ikke testet eller Fejl — dens funktionsnavn og hvilke agenter, der bruger den. Fra rækkens handlingsmenu kan du:

• Rediger — genåbn konfigurationen.
• Klon — dupliker den som udgangspunkt (kopien starter som Ikke testet).
• Revisionshistorik — se tidligere versioner og gendan en i redigeringsværktøjet.
• Overfør — kopiér eller flyt forbindelsen til en anden organisation, du er medlem af. Ved flytning fjernes den her; agenter, der brugte den, kan kræve omkonfiguration.
• Slet — permanent; agenter, der bruger forbindelsen, skal omkonfigureres.

Tilknyt den til en agent#

Tilføj forbindelsen til en agent i sektionen for API-forbindelser i builderen (Byg en agent). Listen viser, hvilke agenter der bruger hver forbindelse, så du med et blik kan se, hvad en ændring påvirker.

Næste trin#