AI-driven e-postspamdetektering och supportdirigering
Detta AI-arbetsflöde klassificerar automatiskt inkommande e-post som spam eller inte, och dirigerar intelligent legitima meddelanden till en AI-assistent som ut...
4 min läsning
Komponenten API-begäran är ett mångsidigt verktyg som är utformat för att underlätta HTTP-förfrågningar inom dina AI-arbetsflöden. Den gör det möjligt för ditt arbetsflöde att interagera med externa API:er eller webbtjänster genom att skicka förfrågningar till en eller flera URL:er och bearbeta svaren. Denna möjlighet är avgörande för uppgifter som datainhämtning, integration med tredjepartstjänster eller anrop av egna endpoints som en del av automatiserade eller intelligenta processer.
Vad gör komponenten?
Den här komponenten låter dig konfigurera och skicka HTTP-förfrågningar (GET, POST, PATCH, PUT) till angivna URL:er. Du kan anpassa förfrågan genom att lägga till headers, query-parametrar och en request body. Den stöder även hantering av formulärdata och att ange egna timeouts, vilket gör den lämplig för en mängd olika API-interaktioner.
Inmatningar
Komponenten API-begäran stöder följande konfigurerbara inmatningar:
| Fält | Beskrivning | Typ | Standard/Alternativ |
|---|---|---|---|
| URL | Ange en eller flera mål-URL:er, separerade med kommatecken. | Sträng | |
| Metod | HTTP-metod som ska användas för förfrågan. | Dropdown | GET, POST, PATCH, PUT |
| Headers | Anpassade headers som ska inkluderas i förfrågan (som en ordbok). | Ordbok/Data | |
| Body | Datapayload för POST, PATCH eller PUT-förfrågningar (som en ordbok). | Ordbok/Data | |
| Query-parametrar | Nyckel-värde-par att lägga till som URL-query-parametrar. | Ordbok/Data | |
| Använd formulärdata | Växla för att skicka data som application/x-www-form-urlencoded. | Boolean | false |
| Timeout | Tid (i sekunder) innan förfrågan avbryts. | Heltal | 5 |
| Cache TTL | Hur länge API-svaret ska cachas. Sätt till ‘Ingen cache’ för att inaktivera. | Dropdown | Ingen cache, 5 min, … osv. |
| Utförlig logg | Om aktiverad, skrivs utförlig logg för felsökning. | Boolean | false |
| Verktygsnamn | Namn på detta API-begäran-verktyg (för användning av agenter). | Sträng | |
| Verktygsbeskrivning | Beskrivning som hjälper agenter att förstå hur verktyget ska användas. | Sträng (flerradig) |
Utmatningar
Komponenten genererar två huvudsakliga utmatningar:
| Utmatningsnamn | Typ | Beskrivning |
|---|---|---|
| Data | Data | Svarsdata från API-begäran. |
| Verktyg | Verktyg | Gör denna API-begäran tillgänglig som ett “verktyg” för agentbaserade arbetsflöden. |
Varför använda denna komponent?
- Integration: Koppla ditt AI-arbetsflöde till valfritt externt API eller webbtjänst, vilket gör det enkelt att utöka dina processer med ny data eller åtgärder.
- Flexibilitet: Stöder flera HTTP-metoder, anpassade headers, bodies och query-parametrar—passar både enkla och komplexa API-anrop.
- Caching: Kan valfritt cacha svar för förbättrad prestanda och minskade redundanta API-anrop.
- Stöd för formulärdata: Skicka enkelt formulärkodad data till kompatibla endpoints.
- Agentvänlig: Ange verktygsnamn och beskrivningar så att komponenten kan användas som verktyg av agentbaserade AI-arbetsflöden.
Exempel på användningsområden
- Hämta realtidsdata (t.ex. väder, nyheter, finans) från publika API:er.
- Skicka information till en tredjepartstjänst (t.ex. CRM, ärendehanteringssystem).
- Integrera med egna backend-endpoints för databehandling eller arbetsflödesautomation.
- Låta LLM-agenter anropa externa API:er som en del av sitt resonemang eller uppgiftsutförande.
Sammanfattning
Komponenten API-begäran är en grundläggande byggsten för alla AI-processer som behöver interagera med webbtjänster eller externa datakällor. Den erbjuder ett omfattande utbud av konfigurationsalternativ för att hantera en mängd olika HTTP-förfrågningsscenarier, och dess utmatningar kan användas direkt eller göras tillgängliga som ett verktyg för agentbaserade AI-arbetsflöden.
