Memory API Reference

प्रमाणीकरण

सभी endpoints को निम्नलिखित headers की आवश्यकता होती है:

x-api-key: <your-api-key>
x-api-secret: <your-api-secret>
Content-Type: application/json

Endpoints

Agent Memory Settings प्राप्त करें

GET /agents/{agent_id}/memory-settings

एक agent के लिए वर्तमान memory कॉन्फ़िगरेशन लौटाता है।

प्रतिक्रिया उदाहरण:

{
  "memory_enabled": true,
  "max_memories": 50,
  "auto_approve": false,
  "memory_types": ["preference", "fact", "context"]
}

Agent Memory Settings अपडेट करें

PUT /agents/{agent_id}/memory-settings

एक agent के लिए memory कॉन्फ़िगरेशन सक्षम, अक्षम या अपडेट करता है।

अनुरोध body:

{
  "memory_enabled": true,
  "max_memories": 50,
  "auto_approve": false,
  "memory_types": ["preference", "fact", "context"]
}

प्रतिक्रिया उदाहरण:

{
  "success": true,
  "message": "Memory settings updated successfully",
  "settings": {
    "memory_enabled": true,
    "max_memories": 50,
    "auto_approve": false,
    "memory_types": ["preference", "fact", "context"]
  }
}

Agent के लिए अनुमोदित Memories प्राप्त करें

GET /agents/{agent_id}/memories

एक agent के लिए सभी अनुमोदित memories उपयोगकर्ता के अनुसार समूहित लौटाता है।

प्रतिक्रिया उदाहरण:

{
  "memories_by_user": {
    "user_123": [
      {
        "id": "memory_abc",
        "agent_id": "agent_123",
        "user_id": "user_123",
        "memory_content": "User prefers concise technical answers.",
        "memory_type": "preference",
        "confidence_score": 0.92,
        "status": "approved",
        "created_at": 1710000000,
        "updated_at": 1710000100,
        "approved_at": 1710000100,
        "source_message_id": "msg_123"
      }
    ]
  },
  "total_users": 1,
  "total_memories": 1
}

विशिष्ट उपयोगकर्ता के लिए अनुमोदित Memories प्राप्त करें

GET /agents/{agent_id}/memories/user/{user_id}

एक उपयोगकर्ता और एक agent के लिए अनुमोदित memory records लौटाता है।

प्रतिक्रिया उदाहरण:

[
  {
    "id": "memory_abc",
    "agent_id": "agent_123",
    "user_id": "user_123",
    "memory_content": "User prefers concise technical answers.",
    "memory_type": "preference",
    "confidence_score": 0.92,
    "status": "approved",
    "created_at": 1710000000,
    "updated_at": 1710000100,
    "approved_at": 1710000100,
    "source_message_id": "msg_123"
  }
]

Pending Memory अनुमोदन प्राप्त करें

GET /memory-approvals/pending

प्रमाणित उपयोगकर्ता के लिए pending memory अनुमोदन लौटाता है। वैकल्पिक रूप से ?agent_id={agent_id} का उपयोग करके agent के अनुसार फ़िल्टर करें।

प्रतिक्रिया उदाहरण:

[
  {
    "id": "memory_abc",
    "agent_id": "agent_123",
    "user_id": "user_123",
    "memory_content": "User prefers concise technical answers.",
    "memory_type": "preference",
    "confidence_score": 0.92,
    "source_message": "Please keep answers short and technical.",
    "created_at": 1710000000,
    "expires_at": 1710604800
  }
]

Memory अनुमोदित या अस्वीकृत करें

POST /memory-approvals/{memory_id}/action

एक pending memory record को अनुमोदित या अस्वीकृत करता है।

अनुरोध body:

{
  "action": "approve"
}

प्रतिक्रिया उदाहरण:

{
  "success": true,
  "message": "Memory approved successfully",
  "memory_id": "memory_abc"
}

Memory हटाएँ

DELETE /memories/{memory_id}

एक memory record को अस्वीकृत के रूप में चिह्नित करके हटाता है।

प्रतिक्रिया उदाहरण:

{
  "success": true,
  "message": "Memory deleted successfully",
  "memory_id": "memory_abc"
}