跳转至

memory

feishu.agent.memory

MemoryIdentityConflict

Bases: ValueError

Trusted caller aliases refer to more than one established memory owner.

源代码位于： feishu/agent/memory.py
Python
 9
10
class MemoryIdentityConflict(ValueError):
    """Trusted caller aliases refer to more than one established memory owner."""

MemoryRecord dataclass

A bounded durable fact owned by one user or shared within one project namespace.

源代码位于： feishu/agent/memory.py
Python
13
14
15
16
17
18
19
20
21
22
23
24
@dataclass(frozen=True)
class MemoryRecord:
    """A bounded durable fact owned by one user or shared within one project namespace."""

    memory_id: str
    namespace: str
    scope: MemoryScope
    owner_key: str | None
    content: str
    created_at: int
    updated_at: int
    expires_at: int = 0

MemoryStore

Bases: Protocol

源代码位于： feishu/agent/memory.py
Python
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
@runtime_checkable
class MemoryStore(Protocol):
    async def remember(
        self,
        *,
        namespace: str,
        scope: MemoryScope,
        owner_key: str | None,
        content: str,
        expires_at: int = 0,
    ) -> MemoryRecord: ...

    async def recall(self, *, namespace: str, owner_key: str | None, query: str, limit: int = 12) -> list[MemoryRecord]:
        """Return memories matching an explicit query within the caller's scope."""
        ...

recall async

Python
recall(*, namespace: str, owner_key: str | None, query: str, limit: int = 12) -> list[MemoryRecord]

Return memories matching an explicit query within the caller’s scope.

源代码位于： feishu/agent/memory.py
Python
39
40
41
async def recall(self, *, namespace: str, owner_key: str | None, query: str, limit: int = 12) -> list[MemoryRecord]:
    """Return memories matching an explicit query within the caller's scope."""
    ...

MemoryIdentityStore

Bases: MemoryStore, Protocol

Optional extension for durable links between trusted identifiers of the same user.

源代码位于： feishu/agent/memory.py
Python
44
45
46
47
48
49
50
@runtime_checkable
class MemoryIdentityStore(MemoryStore, Protocol):
    """Optional extension for durable links between trusted identifiers of the same user."""

    async def resolve_owner(self, *, namespace: str, owner_keys: tuple[str, ...]) -> str | None:
        """Link caller identifiers within one namespace, rejecting conflicting established owners."""
        ...

resolve_owner async

Python
resolve_owner(*, namespace: str, owner_keys: tuple[str, ...]) -> str | None

Link caller identifiers within one namespace, rejecting conflicting established owners.

源代码位于： feishu/agent/memory.py
Python
48
49
50
async def resolve_owner(self, *, namespace: str, owner_keys: tuple[str, ...]) -> str | None:
    """Link caller identifiers within one namespace, rejecting conflicting established owners."""
    ...