پرش به مطلب اصلی

تاریخچه پیام‌ها

دریافت پیام‌ها​

این سرویس برای دریافت پیام‌های یک گفت‌وگو (conversation) خاص استفاده می‌شود. قابلیت صفحه‌بندی (pagination) با استفاده از پارامترهای limit، offset و first_id (برای پیمایش مشابه cursor) پشتیبانی می‌شود.

مسیر سرویس​

GET /api/v1/core/agent/{agent_pk}/messages

پارامترهای مسیر (Path Parameters)​

نامنوعمکاناجباریتوضیح
agent_pkعدد صحیحpathبلهشناسه دستیار (Agent)
conversation_idرشتهqueryبلهشناسه گفت‌وگو برای دریافت پیام‌ها
first_idرشتهqueryخیرشناسه پیام برای دریافت پیام‌های بعد از آن
limitعدد صحیحqueryخیرحداکثر تعداد پیام‌ها در پاسخ (پیش‌فرض: 20)

هدرها (Headers)​

هدرمقدارتوضیح
AuthorizationToken api-tokenتوکن احراز هویت

نمونه فراخوانی​

curl --location 'https://app.houshyar24.ir/api/v1/core/agent/1/messages?conversation_id=ab798ead-6054-4a69-89d4-5f1956f27d52&limit=1' \
--header 'Authorization: Token api_token'

پاسخ موفق (200)​

{
  "limit": 20,
  "has_more": false,
  "data": [
    {
      "id": "3c146e6f-08ac-4c52-b18e-3e20cf3ea82c",
      "conversation_id": "738de03d-9cba-41fe-9b22-f68999a046c6",
      "parent_message_id": "00000000-0000-0000-0000-000000000000",
      "inputs": {},
      "query": "name of 10 countries",
      "answer": "Sure! Here are the names of 10 countries:\n\n1. Canada\n2. Brazil\n3. Japan\n4. Australia\n5. Germany\n6. India\n7. South Africa\n8. France\n9. Mexico\n10. Russia",
      "message_files": [],
      "feedback": null,
      "retriever_resources": [],
      "created_at": 1742902109,
      "agent_thoughts": [
        {
          "id": "b341db4c-fce8-47b3-8b7d-319acd40c5b1",
          "chain_id": null,
          "message_id": "3c146e6f-08ac-4c52-b18e-3e20cf3ea82c",
          "position": 1,
          "thought": "Sure! Here are the names of 10 countries:\n\n1. Canada\n2. Brazil\n3. Japan\n4. Australia\n5. Germany\n6. India\n7. South Africa\n8. France\n9. Mexico\n10. Russia",
          "tool": "",
          "tool_labels": {},
          "tool_input": "",
          "created_at": 1742902109,
          "observation": "",
          "files": []
        }
      ],
      "status": "normal",
      "error": null
    }
  ]
}