Korlátos melléklet- és tudástártartalom olvasása
Engedélyezd a szükséges toolt a Complexity felületen, miután kiválasztottad a saját postafiókodat. Minden toolhoz külön csoportos engedély, csevegési kiválasztás, MailGen-licenc és aktuális jogosultság kell.
| Tool | Bemenet és alapértékek | Jogosultság | Eredményhatár |
|---|---|---|---|
readMailAttachment | emailId, attachmentId, opcionális byteOffset=0, byteLimit=16384 | mail.read | Legfeljebb 16 KiB egy aktív, saját üzenet tárolt mellékletéből. |
readSyncArchiveAttachment | Változatlan messageId, attachmentId, opcionális ugyanazzal a bájtablakkal | mail.sync.read | Legfeljebb 16 KiB egy saját, nem törölt, csak olvasható archívum-mellékletből. |
readKnowledgeFile | fileId, opcionális ordinal=0, limit=10 | knowledge.read | Legfeljebb 10 kinyert darab, darabonként legfeljebb 1600 karakter. |
A bemenetek kanonikus azonosítókat és korlátos lapozást tartalmaznak, nem tárolókulcsot, URL-t, tulajdonjogot vagy modell által megadott bájtokat. A bájthatárok 1 és 16384 között vannak. A tudástár-határok 1 és 10 között.
A tudástár-hozzáféréshez tulajdonjog vagy egy jelenlegi bérlői csoportos read megosztás kell. A keresési, kezelési és kimenő jogok nem helyettesítik az olvasási jogot. A toolok kizárják a törölt fájlokat, mappákat és tudástárakat. A backend a darabok olvasása után újra ellenőrzi az állapotot és a hozzáférést.
Kanonikus olvasási útvonalak
A GET /getAttachmentContent és a GET /sync/permanent-delete-archive a byteOffset és a byteLimit értéket együtt fogadja korlátos JSON-hez. Az emberi letöltés és az előnézet továbbra is elérhető. Az archívumablakokhoz postafiók-, üzenet- és mellékletazonosító kell.
A tulajdonos- és életciklus-ellenőrzések után a backend a tárolt bájtokat szeleteli, vagy natív S3-tartományt kér. Az eredmények tartalmazzák a metaadatokat, a totalBytes, byteOffset, returnedBytes, nextOffset és base64 contentBytes mezőket. A BFF ellenőrzi a kanonikus base64-et, a tényleges bájtszámot és a lapozás következetességét.
Az érvényes UTF-8 kódolású, támogatott szövegformátumok passzív text mezőt is visszaadnak. A bináris vagy érvénytelen UTF-8 tartalomhoz nem készül kitalált szöveg. A nextOffset: null a vég jelölése.
Az S3 a Range: bytes=start-end fejlécet használja. A válaszoknak érvényes 206 státuszra és Content-Range fejlécre van szükségük, helyes tényleges mérettel, legfeljebb 16 KiB-tal. Az olvasó a törzs pufferelése előtt elutasít egy figyelmen kívül hagyott Range fejlécet. Nincs korlátlan visszalépés. A Microsoft-melléklet-aliasok szülő- és tulajdonosszűrőkön keresztül oldódnak fel, soha nem tetszőleges Graph URL-eken.
A GET /knowledge/content a tárolt knowledge_chunks rekordokat olvassa sorszám szerint. Minden oldal ellenőrzi a kész állapotot és az olvasási hozzáférést. Mindkét útvonalházirend megköveteli a knowledge.read jogosultságot. Megőrzi a dokumentum-, oldal-, munkalap- és szakaszhivatkozásokat, valamint a nextOrdinal értéket.
A GET /knowledge/file az emberi eredeti bájtletöltés marad. A tool a kinyert szöveget olvassa. Csonkolt tartalomnál kérd a következő ablakot. Ne tekintsd a kivonatokat teljes forrásnak.