メインコンテンツへスキップ
重要なイベント、インタラクション、会話を時系列のログエントリとして記録します。エピソードはメモリとは別の監査証跡を提供します。用途: デバッグセッション、重要な意思決定、デプロイイベント、エラー調査。

パラメータ

content
string
必須
エピソードの内容。説明的に記述してください: 何が起きたか、なぜ、結果はどうだったかを含めます。デバッグの場合: 症状、調査手順、解決策を含めてください。
contentType
string
デフォルト:"text"
コンテンツ形式。
ValueDescription
textフリーフォームテキスト(デフォルト)
json構造化 JSON データ
message会話やチャットメッセージ形式
source
string
エピソードの発生元。例: "session:abc123""file:src/auth.ts""debug:OOM-investigation"
refs
object[]
このエピソードをナレッジグラフのエンティティ/エッジにリンクする参照。エピソードから関連する概念への探索を可能にします。各 ref の構成:
  • refType: エンティティを参照する場合は "node"、関係を参照する場合は "edge"
  • refId: 参照先のエンティティまたはエッジの ID
scope
string
デフォルト:"project"
保存スコープ。
ValueDescription
project現在のプロジェクト配下に保存(デフォルト)
global全プロジェクトで共有

使用例

{
  "content": "Debugged OOM error in GraphService. Root cause: unbounded connection pool. Fixed by adding limit of 10.",
  "contentType": "text",
  "source": "debug:OOM-investigation",
  "refs": [
    { "refType": "node", "refId": "entity_graphservice_id" }
  ]
}