Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Dieser Artikel ist eine Vorabdokumentation und kann geändert werden.]
Benutzer können Dateien an eine Nachricht anhängen, damit der Agent sie für diese Runde lesen, zusammenfassen oder anderweitig begründen kann. Anhänge sind eine Eingabe pro Runde des Benutzers, keine persistente, vom Hersteller konfigurierte Datenquelle.
Note
Die Funktionen in diesem Artikel werden vom GitHub Copilot-Harness unterstützt, das Copilot Credits für nutzungsbasierte Abrechnung verwendet. Erfahren Sie mehr über Copilot-Credits in Überblick über die Abrechnung von Agenten, die vom GitHub Copilot-Harness betrieben werden.
Nutzungsbasierte Abrechnung gilt für die Nutzung, den Bau, das Testen und die Bewertung von Agenten. Diese Aktionen könnten Copilot-Credits verbrauchen.
Anhänge vs. Wissensquellen
Anhänge und Wissensquellen sind unterschiedliche Konzepte. Wähle den, der zu deinem Szenario passt.
| Konzept | Wer stellt sie bereit | Geltungsbereich | Typische Nutzung |
|---|---|---|---|
| Anhang | Der Endnutzer, pro Nachricht | Eine Unterhaltung | "Fasse diesen Vertrag zusammen", "Was ist in diesem Screenshot?" |
| Wissensquelle | Der Ersteller, zur Entwurfszeit | Jedes Gespräch mit dem Agenten | Richtliniendokumente, Produktkataloge, Hilfeartikel |
Füge eine Wissensquelle hinzu, wenn der Agent immer Zugriff auf denselben Inhalt haben sollte. Bitte Nutzer, eine Datei anzuhängen, wenn der Inhalt einzigartig für ihre Anfrage ist.
Unterstützte Anhangstypen
| Typ | Beispiele | Hinweise |
|---|---|---|
| Bilder | .png, .jpg, .gif, .webp | Der Agent verwendet visuell fähige Modelle, um Fragen zum Bild zu beschreiben oder zu beantworten. |
| PDF-Dateien | Der Text wird extrahiert, damit der Agent darüber nachdenken kann. | |
| Textdokumente | .txt, .csv, .html, .md | Inhalte werden dem Agenten als Text übermittelt. |
| URLs | Jede öffentlich erreichbare HTTP- oder HTTPS-URL | Der Agent lädt die verlinkte Datei für den aktuellen Zug herunter (siehe das URL-Downloadverhalten später in diesem Artikel). |
Wo Benutzer Dateien anhängen
Benutzer können Dateien auf jeder Oberfläche anhängen, auf der der Agent ausgeführt wird:
- Der Reiter "Vorschau" im Copilot Studio, wenn du den Agenten testest. Erfahren Sie mehr in Test an Agent.
- Jeder veröffentlichte Kanal, der Anhänge unterstützt, wie Microsoft Teams, Microsoft 365 Copilot und Webchat.
Der Benutzer wählt das Anhangssymbol im Nachrichtenkomponist aus, wählt eine oder mehrere Dateien, fügt eine optionale Nachricht hinzu und sendet den Turn. Der Agent erhält die Anhänge zusammen mit der Nachricht.
Wie der Agent Anhänge verarbeitet
- Der Agent liest jeden Anhang, wenn er die Nachricht verarbeitet. Anhänge beeinflussen nur die Nachricht, mit der sie gesendet werden, es sei denn, der Agent verweist später im selben Gespräch erneut auf sie.
- Wenn ein Anhang nicht verarbeitet werden kann (zum Beispiel eine ungültige Datei oder ein fehlgeschlagener URL-Download), überspringt der Agent diesen Anhang und verarbeitet den Rest der Nachricht. Die Nachricht wird trotzdem gesendet.
- Anhänge ersetzen keine Wissensquellen, Speicher oder Werkzeugausgaben . Sie sind ein weiteres Signal, das der Agent für die aktuelle Runde in Betracht zieht.
URL-Anhänge
Wenn ein Nutzer eine URL anhängt, lädt der Agent die Datei an dieser URL herunter und behandelt sie wie einen hochgeladenen Anhang für die Runde.
- Der Download muss innerhalb von 30 Sekunden abgeschlossen sein. Bei langsameren Antworten tritt eine Zeitüberschreitung auf, und die URL wird in diesem Durchlauf übersprungen.
- Die URL muss über den Dienst von Microsoft öffentlich erreichbar sein. Verbindungen, die eine Anmeldung erfordern oder die hinter einer Firewall liegen, funktionieren nicht.
- Die Nachricht wird weiterhin gesendet, selbst wenn der URL-Download fehlschlägt.
Aufbewahrung und Grenzwerte
Anhänge werden für die gesamte Lebensdauer des Gesprächs gespeichert, nicht nur für die aktuelle Wendung. Wenn ein Nutzer eine Datei früher im Gespräch angehängt hat, kann der Agent sie in einer späteren Runde erneut referenzieren (zum Beispiel: "Vergleiche dies mit der Datei, die ich zuvor gesendet habe").
| Artikel | Begrenzung |
|---|---|
| Anhangsgröße (pro Datei) | 16 MiB |
| Zeitüberschreitung beim Download von URL-Anhängen | 30 Sekunden |
| Bindungsbindung (pro Gespräch) | 28 Tage nach der letzten Aktivität im Gespräch |
| Bindungsverhalten beim Scheitern | Der Agent überspringt den gescheiterten Anhang und verarbeitet die Nachricht weiter |
Nach Ablauf des Aufbewahrungsfensters werden gespeicherte Anhänge aus der Unterhaltung gelöscht und stehen dem Agenten nicht mehr zur Verfügung. Dieses gleiche Aufbewahrungsfenster gilt für alle Dateien, die der Agent während des Gesprächs erstellt.