Felsökning av integrationer

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 inställningar 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 åtkomst i själva tjänsten. Bekräfta att kontot du avsåg att ansluta kan öppna exakt den fil, det repository, den kalender, den egenskap eller annan resurs som berörs.
4. Spara felet innan du ändrar något. Notera det exakta meddelandet, tid och tidszon, berört projekt eller Chat och senaste lyckade försök. Maskera privat information i skärmbilder.

Öppna alternativen för Chat-inmatning, 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

Vad du ser	Var du ska börja
En tjänst saknas eller dess kontroller är inte tillgängliga	Hitta eller starta en integration
Inloggning öppnas inte, blockeras eller slutförs aldrig	Slutför auktorisering
Anslutningen använder ett annat konto	Kontrollera det anslutna kontot
Ansluten, men Agent kan inte hitta en resurs	Kontrollera anslutningen och dataåtkomsten
Läsning fungerar, men att skapa eller redigera misslyckas	Kontrollera skrivåtkomst och åtgärder som stöds
En anslutning som tidigare fungerade misslyckas	Kontrollera vad som har ändrats
Resultaten är inaktuella, förfrågningar får timeout eller fel upprepas	Kontrollera förfrågan och tjänstens tillgänglighet

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 åtkomst som begärs 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å skärmar för connector-detaljer 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. Alla connectors visar inte det anslutna kontot, så använd inte enbart 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äsförfrågan 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 egenskap där det är relevant.
3. Gör förfrågan 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 och ändra flera resurser samtidigt.

Till exempel, om connectorn stöder att läsa 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 tecken 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 felmeddelanden eller bekräftelseförfrågningar. 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: Kontrollera 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 liveflö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 förfrågan: kontot, dess åtkomst till resursen, organisationens apppolicy eller anslutningens auktorisering.

1. Öppna integrationen igen i Atoms 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 gått 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äsförfrågan fungerar igen. Om samma fel kvarstår, spara det tillsammans med den senaste lyckade tiden och kontakta support.

Resultaten är inaktuella eller en förfrågan fortsätter att misslyckas

1. Jämför resultatet med själva tjänsten. Bekräfta konto, resurs, datumintervall, filter och tidszon 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- eller tjänsten-inte-tillgänglig-fel, 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äsförfrågan. Innan du försöker igen med något som ändrar externa data, kontrollera 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 förfrågan.

Innan du kopplar från: Slutför eller pausa uppgifter som är beroende av anslutningen, kontrollera resultatet av eventuella väntande externa skrivningar och se till 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 den integrationens instruktioner.
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 testflöde och verifierar resultatet på målet.

Kontrollera anslutningens status 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. Frånkoppling ingår inte i 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 för build och preview. Kontrollera den miljö där felet uppstår; en lyckad Chat-förfrågan ä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, identifiera 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.