Felsökning av integrationer

Om en integration inte ansluter, slutar fungera eller inte kan slutföra en uppgift kan du använda den här guiden för att kontrollera anslutningen, kontoåtkomst och vald resurs.

Den här sidan täcker vanliga problem med anslutning och auktorisering i Atoms. För tjänstspecifik konfiguration, åtgärder som stöds eller konfiguration i din app börjar du med Anslut och hantera integrationer och väljer guiden för din tjänst.

Börja med dessa kontroller

1. Kontrollera var felet uppstår. Kan Agent inte använda en tjänst i Chat, eller misslyckas funktionen bara i din app? Att ansluta en tjänst för Chat bekräftar inte i sig att din app är korrekt konfigurerad. För fel som bara gäller appen, se Anslut och hantera integrationer.
2. Öppna integrationen. I ditt projekts Chat öppnar du alternativmenyn bredvid meddelandeinmatningen och väljer sedan Connectors → Add connectors. Sök efter och välj tjänsten. Kontrollera om den är ansluten eller fortfarande erbjuder Connect. Vissa tjänster öppnar sin egen hanteringsskärm.
3. Kontrollera åtkomsten i själva tjänsten. Bekräfta att kontot du avsåg att ansluta kan öppna den exakta fil, det repository, den kalender, egendom eller annan resurs som berörs.
4. Spara felet innan du ändrar något. Registrera det exakta meddelandet, tid och tidszon, berört projekt eller Chat samt senaste lyckade försök. Maskera privat information i skärmbilder.

Öppna inmatningsalternativen i Chat, välj Connectors (1) och sedan Add connectors (2) för att bläddra bland tillgängliga integrationer.

Du kan också hantera tillgängliga anslutningar i Settings → Connectors. Välj den integration du vill kontrollera.

Håll autentiseringsuppgifter privata. Klistra aldrig in lösenord, inloggningskoder, API-nycklar, åtkomsttoken eller andra hemligheter i Chat eller i en supportförfrågan. Ange autentiseringsuppgifter endast i tjänstens inloggningsflöde eller i det avsedda säkra konfigurationsfältet.

Hitta ditt problem

Du kan inte hitta eller starta en integration

1. Använd Add connectors för att söka i katalogen. Den kortare listan i Chat-menyn är inte hela katalogen.
2. Om Atoms säger att funktionen bara är tillgänglig inom ett projekt öppnar du det avsedda projektet och försöker där.
3. Om en kontroll är inaktiverad, läs förklaringen. Om den kräver en annan roll eller behörighet, be projekt- eller workspace-ägaren om hjälp. Koppla inte från en annan tjänst bara för att kringgå en begränsning.

Kontrollera resultatet: Du kan öppna tjänstens anslutnings- eller hanteringsskärm. Om den fortfarande inte visas, kontrollera Anslut och hantera integrationer eller kontakta support för att bekräfta tillgänglighet. Anta inte att en saknad tjänst kan aktiveras genom upprepade inloggningsförsök.

Auktorisering slutförs inte

1. Välj Connect en gång och leta efter tjänstens inloggningsfönster. Om din webbläsare rapporterar ett blockerat popup-fönster, tillåt popup-fönster för Atoms-webbplatsen och försök igen. I Chrome följer du instruktionerna för att tillåta popup-fönster från en specifik webbplats; du behöver inte aktivera dem för alla webbplatser.
2. Välj det avsedda kontot och granska den begärda åtkomsten. Slutför tjänstens auktoriseringsflöde innan du stänger dess fönster.
3. Om tjänsten uttryckligen säger att din organisation har blockerat appen eller den begärda åtkomsten, spara meddelandet och kontakta din administratör. Kringgå inte organisationens policy.
4. Gå tillbaka till Atoms och öppna integrationen igen för att kontrollera dess status. Att stänga ett inloggningsfönster är inte en bekräftelse på att auktoriseringen lyckades.

Granska den begärda åtkomsten innan du slutför auktoriseringen. Att auktorisera ett konto bekräftar inte i sig att den avsedda resursen är ansluten.

Om auktoriseringen innehåller en väljare för organisation eller workspace, bekräfta det avsedda valet och granska de begärda behörigheterna.

Kontrollera resultatet: Integrationen visas som ansluten. På detaljskärmar för connectors som använder standardlayouten ersätts Connect av Disconnect och Try it out. Andra tjänster har sina egna layouter. Om den fortfarande erbjuder Connect eller visar ett fel, fånga det resultatet och kontakta support efter ett nytt försök.

Fel konto är anslutet

Om integrationens hanteringsskärm visar ett konto, jämför det med kontot som äger eller kan komma åt resursen. Inte alla connectors visar det anslutna kontot, så använd inte bara webbläsarens aktuella inloggning som bevis för vilket konto Atoms använder.

Öppna resursen direkt i tjänsten med det avsedda kontot. Om det kontot inte kan komma åt den, be först resursägaren om åtkomst. Om anslutningen använder fel konto följer du tjänstens instruktioner för att byta konto eller återansluter säkert och väljer uttryckligen rätt konto under auktoriseringen.

Kontrollera resultatet: En liten läsbegäran som stöds returnerar den avsedda resursen. Om du fortfarande inte kan fastställa vilket konto som är anslutet, kontakta support i stället för att koppla från upprepade gånger.

Integrationen är ansluten, men Agent kan inte hitta dina data

1. Kontrollera anslutningen. Öppna integrationens detaljer i Connectors och bekräfta att den är ansluten. Kontrollera valt konto eller resurs där det visas.
2. Kontrollera den exakta resursen. Öppna den direkt i tjänsten med det avsedda kontot. Bekräfta dess plats och åtkomstbehörigheter, inklusive rätt organisation, workspace, mapp eller egendom där det är relevant.
3. Gör begäran specifik. Namnge tjänsten och ange det exakta resursnamnet eller länken när connectorn stöder det. Be först om en läsåtgärd som stöds, i stället för att söka efter och ändra flera resurser samtidigt.

Till exempel, om connectorn stöder läsning av dokument: “Använd [service] för att läsa [document name or link] och berätta dess titel. Ändra det inte.”

Kontrollera resultatet: Agent returnerar den avsedda resursen. Om direkt åtkomst fungerar men Agent fortfarande inte kan läsa den, kontrollera connectorns funktioner som stöds och beviljad åtkomst. Återanslut bara om det finns bevis på ett auktoriseringsproblem.

Agent kan läsa data, men kan inte ändra dem

Att läsning lyckas bekräftar inte att connectorn stöder den begärda ändringen eller har behörighet att göra den.

1. Se Anslut och hantera integrationer eller connectorns lista What you can do, om den visas. Bekräfta att den begärda åtgärden stöds.
2. Kontrollera om det anslutna kontot får göra den ändringen i den exakta resursen. Be resursägaren eller administratören om endast den åtkomst som behövs.
3. Läs eventuella fel eller begäran om bekräftelse. Om ytterligare auktorisering krävs följer du tjänstens dokumenterade flöde. Återanslutning kan inte lägga till en åtgärd som connectorn inte stöder.

Innan du försöker skriva igen: Inspektera målet för att se om det första försöket redan skapade eller ändrade något. Ett misslyckat svar räcker inte för att bevisa att ingen ändring skedde. Upprepa inte en betalning, ett meddelande, en inbjudan eller skapandet av en post förrän du känner till det tidigare resultatet.

Kontrollera resultatet: En ändring som stöds lyckas på en lämplig testresurs, och du bekräftar den direkt i tjänsten. För betalningar eller andra livearbetsflöden använder du tjänstspecifika testinstruktioner i stället för en verklig transaktion.

En anslutning som fungerade tidigare har slutat fungera

Kontrollera vad som har ändrats sedan den senaste lyckade begäran: kontot, dess åtkomst till resursen, organisationens apppolicy eller anslutningens auktorisering.

1. Öppna integrationen i Atoms igen och kontrollera om den fortfarande är ansluten.
2. Försök att öppna resursen direkt i tjänsten. Om åtkomsten har tagits bort, lös det med resursägaren eller administratören.
3. Om felet säger att auktoriseringen har löpt ut, återkallats eller är ogiltig, följ Återanslut säkert. Om felet gäller ett tjänstavbrott, en begränsning eller en åtgärd som inte stöds, åtgärda först den orsaken.

Kontrollera resultatet: En liten läsbegäran fungerar igen. Om samma fel kvarstår, spara det tillsammans med den senaste lyckade tiden och kontakta support.

Resultaten är inaktuella eller en begäran fortsätter att misslyckas

1. Jämför resultatet med själva tjänsten. Bekräfta kontot, resursen, datumintervallet, filtren och tidszonen där det är relevant. Be Agent hämta det aktuella värdet i stället för att förlita sig på ett tidigare svar i konversationen.
2. Vid ett uttryckligt timeout-fel eller fel om att tjänsten inte är tillgänglig, kontrollera tjänstens officiella status- eller hjälpsida. Om felet anger en tid för nytt försök, vänta tills dess; skicka inte upprepade förfrågningar medan begränsningen eller avbrottet kvarstår.
3. Spara eventuell oskickad text, uppdatera Atoms och kontrollera connectorns status igen. Att uppdatera sidan är inte samma sak som att auktorisera kontot på nytt.
4. Försök igen med en liten läsbegäran. Innan du försöker igen med något som ändrar externa data, inspektera målet för det tidigare resultatet.

Kontrollera resultatet: Det nya resultatet matchar den avsedda resursen i tjänsten. Om det fortfarande är felaktigt, skicka support det förväntade och faktiska värdet med tidsstämplar. Anta inte att alla integrationer uppdateras enligt samma schema.

Återanslut säkert

Återanslut när auktoriseringen är ogiltig eller fel konto är länkat — inte som första steg för varje misslyckad begäran.

Innan du kopplar från: Slutför eller pausa uppgifter som är beroende av anslutningen, kontrollera resultatet av eventuell väntande extern skrivning och säkerställ att du kan logga in igen med den åtkomst som krävs. Att koppla från gör anslutningen otillgänglig tills den ansluts igen. Kontrollera Anslut och hantera integrationer för eventuella ytterligare effekter; anta inte att frånkoppling återställer tidigare ändringar eller avbryter arbete som redan har skickats.

1. Öppna tjänstens anslutningsdetaljer. Om den har sin egen skärm för kontohantering följer du instruktionerna för den integrationen.
2. På standardskärmen för connector-detaljer väljer du Disconnect när du är redo och väljer sedan Connect. Anta inte att det kommer en extra bekräftelse innan frånkoppling.
3. Välj det avsedda kontot och slutför auktoriseringen. Granska de begärda behörigheterna.
4. Gå tillbaka till Atoms och bekräfta att den är ansluten.
5. Kör återställningskontrollen nedan innan du återupptar den ursprungliga uppgiften.

Om samma fel återkommer, sluta återansluta och kontakta support med felet och de kontroller som redan har genomförts.

Verifiera att problemet är löst

1. Be om en åtgärd som stöds och är skrivskyddad på en resurs som du kan verifiera direkt. Om du använder Try it out, granska den föreslagna prompten innan du skickar den.
2. Jämför svaret med själva tjänsten. Bekräfta rätt resurs, kontokontext och begärt resultat — inte bara indikatorn för ansluten.
3. Om din uppgift kräver ändringar använder du en lämplig testresurs eller tjänstens dokumenterade testarbetsflöde och verifierar resultatet på målet.

Kontrollera anslutningsstatusen och vald resurs. Enbart en indikator för ansluten bekräftar inte att de förväntade uppgifterna är tillgängliga eller uppdaterade.

Bekräfta organisationen och projektet och öppna sedan Dashboard för att inspektera resursen utan att göra ändringar. Att koppla från är inte en del av denna kontroll.

Om kontrollen lyckas återupptar du din uppgift. Om Chat fungerar men funktionen fortfarande misslyckas i din app, se Anslut och hantera integrationer eller felsökning av build och preview. Kontrollera miljön där felet uppstår; en lyckad Chat-begäran är inte ett bevis på att appen är korrekt konfigurerad.

Få hjälp

Om problemet kvarstår använder du Få support och inkluderar:

• Integrationens namn och e-postadressen för ditt Atoms-konto.
• Länken till det berörda projektet eller Chat, och om felet uppstår i Chat eller i din app. För en app, ange den berörda miljön.
• Det avsedda tjänstkontot och resursen, med endast de icke-hemliga identifierare som behövs för att undersöka.
• Det exakta felet, datum, tid och tidszon; inkludera den senaste lyckade tiden om den är känd.
• Stegen för att återskapa problemet, förväntat resultat, faktiskt resultat och kontroller som redan har provats.
• Din webbläsare och enhet, plus maskerade skärmbilder eller en kort inspelning om det är användbart.

För en misslyckad skrivning, ange om målet visar en slutförd ändring, ingen ändring eller ett okänt resultat. Ta bort lösenord, inloggningskoder, API-nycklar, token och orelaterade privata data från alla bilagor.