メインコンテンツへスキップ

概要

エピソードはイベントの時系列記録です。会話、操作、状態変化、観察などが記録されます。Neuradexの記憶システムの基盤となるデータタイプです。単純なチャンク検索と比較した構造化記憶の利点については、コンセプト概要をご覧ください。

フィールド

フィールド説明
idstring一意の識別子
contentstringエピソードの内容
episodeTypestringエピソードの種類
actorTypestringアクションの実行者
actorIdstring?アクターの識別子
actorNamestring?アクターの表示名
channelstringソースチャンネル
sessionIdstring?セッションのグループID
parentEpisodeIdstring?親エピソード(Q&Aスレッド用)
scopeTypestringスコープの種類(プロジェクト)
scopeIdstringスコープの識別子
occurredAtstringイベントの発生日時
createdAtstring作成日時

エピソードタイプ

各エピソードは、記録されたイベントの性質を表すタイプで分類されます。
タイプ説明
questionユーザーの質問
answerエージェントまたはシステムの回答
action実行された操作
observation観察された状態変化

アクタータイプ

アクタータイプは、エピソードを生成した主体を示します。
タイプ説明
user人間のユーザー
agentAIエージェントまたはアシスタント
systemシステム生成

チャンネル

エピソードはさまざまなチャンネルから生成されます。各チャンネルは異なる連携ポイントを表します。
チャンネル説明
librarian司書との対話
chatbotチャットボットウィジェットとの会話
apiSDK/API経由の直接呼び出し
mcpMCP経由のAIエージェント操作
slackSlack連携メッセージ

セッション管理

同じセッション内のエピソードは sessionId でグループ化されます。これにより、単一のインタラクションやワークフロー内で発生したすべてのイベントを取得できます。 parentEpisodeId を使用して質問と回答をスレッド化できます。たとえば、回答エピソードが対応する質問エピソードを参照することで、明確なQ&Aペアを形成します。

関連ページ

データタイプ

全データタイプのコンセプト概要

Episodes API

SDKでエピソードを管理