autogen_ext.agents.file_surfer#

class FileSurfer(name: str, model_client: ChatCompletionClient, description: str = DEFAULT_DESCRIPTION, base_path: str = os.getcwd())[Quellcode]#

Bases: BaseChatAgent, Component[FileSurferConfig]

Ein Agent, der von MagenticOne verwendet wird und als lokaler Dateivorschauer fungiert. FileSurfer kann eine Vielzahl gängiger Dateitypen öffnen und lesen und die lokale Dateihierarchie durchsuchen.

Installation

pip install "autogen-ext[file-surfer]"
Parameter:

  • name (str) – Der Name des Agenten

  • model_client (ChatCompletionClient) – Das zu verwendende Modell (muss Tool-Nutzung aktiviert haben)

  • description (str) – Die Beschreibung des Agenten, die vom Team verwendet wird. Standardwert ist DEFAULT_DESCRIPTION

  • base_path (str) – Der Basispfad, der für den Dateibrowser verwendet werden soll. Standardwert ist das aktuelle Arbeitsverzeichnis.

component_config_schema#

alias von FileSurferConfig

component_provider_override: ClassVar[str | None] = 'autogen_ext.agents.file_surfer.FileSurfer'#

Überschreibe den Anbieter-String für die Komponente. Dies sollte verwendet werden, um zu verhindern, dass interne Modulnamen Teil des Modulnamens werden.

DEFAULT_DESCRIPTION = 'Ein Agent, der mit lokalen Dateien umgehen kann.'#
DEFAULT_SYSTEM_MESSAGES = [SystemMessage(content='\n        Sie sind ein hilfreicher KI-Assistent.\n        Wenn Sie eine Benutzeranfrage erhalten, verwenden Sie verfügbare Funktionen, um dem Benutzer bei seiner Anfrage zu helfen.', type='SystemMessage')]#
property produced_message_types: Sequence[type[BaseChatMessage]]#

Die Arten von Nachrichten, die der Agent im Feld Response.chat_message produziert. Sie müssen BaseChatMessage-Typen sein.

async on_messages(messages: Sequence[BaseChatMessage], cancellation_token: CancellationToken) → Response[Quellcode]#

Verarbeitet eingehende Nachrichten und gibt eine Antwort zurück.

Hinweis

Agenten sind zustandsbehaftet, und die an diese Methode übergebenen Nachrichten sollten die neuen Nachrichten seit dem letzten Aufruf dieser Methode sein. Der Agent sollte seinen Zustand zwischen den Aufrufen dieser Methode beibehalten. Wenn der Agent sich beispielsweise die vorherigen Nachrichten merken muss, um auf die aktuelle Nachricht zu reagieren, sollte er die vorherigen Nachrichten im Agentenzustand speichern.

async on_reset(cancellation_token: CancellationToken) → None[Quellcode]#

Setzt den Agenten in seinen Initialzustand zurück.

_to_config() → FileSurferConfig[Quellcode]#

Gib die Konfiguration aus, die erforderlich wäre, um eine neue Instanz einer Komponente zu erstellen, die der Konfiguration dieser Instanz entspricht.

Gibt zurück:

T – Die Konfiguration der Komponente.

classmethod _from_config(config: FileSurferConfig) → Self[Quellcode]#

Erstelle eine neue Instanz der Komponente aus einem Konfigurationsobjekt.

Parameter:

config (T) – Das Konfigurationsobjekt.

Gibt zurück:

Self – Die neue Instanz der Komponente.