--- title: "API-forbindelser" description: "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 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. 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. 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. 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. Headerværdier kan kun skrives. Når de er gemt, krypteres de og vises aldrig igen, hverken i dashboardet eller API'et. Når du redigerer en forbindelse, viser en gemt header sit navn med prikker i stedet for værdien og en **Gemt**-note: lad den være som den er for at beholde den gemte værdi, eller skriv en ny for at erstatte den. Testanmodninger og liveopkald bruger den gemte værdi. **Klon** kopierer gemte værdier til den nye forbindelse. Giv parametre beskrivelser på almindeligt sprog ("Kundens e-mailadresse, f.eks. jane@example.com"). Agenten vælger argumenter ud fra disse beskrivelser i realtid midt i opkaldet. ## 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](/da/guides/build-an-agent)). Listen viser, hvilke agenter der bruger hver forbindelse, så du med et blik kan se, hvad en ændring påvirker. ## Næste trin Opret og administrer de samme forbindelser programmatisk. Forudbyggede forbindelser til Google, Slack, HubSpot, Salesforce og Cal.com. Giv dine agenter adgang til en hel værktøjsserver. Alle felter i integrationsressourcen.