fleet-memory/hindsight-docs/docs/api-reference/endpoints/add-bank-background.api.mdx
2025-12-09 10:02:14 +01:00

71 lines
No EOL
5.4 KiB
Text

---
id: add-bank-background
title: "Add/merge memory bank background"
description: "Add new background information or merge with existing. LLM intelligently resolves conflicts, normalizes to first person, and optionally infers disposition traits."
sidebar_label: "Add/merge memory bank background"
hide_title: true
hide_table_of_contents: true
api: eJzVV0tv2zgQ/isDnhJA9SPdvQjoIW0D1ED6QJLuJTAKWhxZbChSJSk/1tB/Xwwp2/Qj6SLYy/piWRzOfPxm5uN4wwS6wsrGS6NZzq6FAI1LmPHiaW5NqwVIXRpbczIAY6FGO0dYSl8BrqTzUs8HcHv7GaT2qJSco/ZqDRadUQt0UBhdKll4l4EmP0r+jQ68gVJa56FB64zOgGsBJqDgSq0pKFoHQrrGOBlie8uldwOWMdOgDXgmguWMC/FjxvXTjz1mlrGGW16jR+tY/rhhmtfIchbsJK1LOm3DfcUyZvFXKy0KlnvbYsZcUWHNWb5hft3QNuet1HOWMS+9ohfvuX6CiWBdN43b0fn3Rqxpz7G3wmiP2tMSbxoliwB9+NMR4ZskWGPpYF6io1/JtudQfOhNsqMkfnk+gd4AF2KXR9ZlrG0E9/gjoTqJOTNGIddJ0O/BHD4m5sfxJyWEo8csnkkilNbU4CuMKESK9kJgyVvl8+DjMjgPLyKfXZdtsZnZTyz8Qf4ed7RN94ivhXi/838Xk3WCuX8PtRGooDSWeJJ6PiSEUs+fIZTKEVe8bihSkjQ2gSV3MDNWg9TwgCvu2Hmu46k6OphF1xjtYgFcjUb0dQjzvi0KdK5sFdz1xuzVJZY0zIu1vrPqMnZUJlyvv5ahww5duydsvCykqxPXpBBztCxjNV/Juq1Z/mfGaqnj83gf836//ThRn8wSeu9cwcJRmQQVgovxu+1zBn++2xldEm4lPVquXgvodr/9HKDeu1pTg5FX21j0B513MX5XKlzJmUJC1+8I2LAmIVq/CthNv/ccqrotKgJUGO2kQAtYm6iwECpm5QmVQM+LCgWhikjQy+KS/a7TXJojlfKzPU/Sg4lcPAQJOAH88VQlfMUDh6pFXSBUdCSsjZXogFukLq1RhKtjxzmKo5bckfv2sAjeZgdF+rbrsh39ulWKddPfMZD0z/RcvyQdeiw2cSFRm0ReokgcHSPt1XPiMoAJ8Bo4OFP6JbGDei41oo139XgEa+TWgSkBVw1aSZxSkKOO/vd8Rc364+rqVKb+4kqKWPc31hr7eo2i6pSKnqTH2p0aKFMcrO4V6VDQkvRuu6ub7hPMreXrRPVuTQRI/Vm7+UsC+Rmd4/EujSbPmwYy4IFWf1dcdK4YurdLSmxPb2T3+WN8jPSdC7Y1+fTw8O3EYcxtjb4yVHCNCVdmmJdyNlyMh/2lPKSJyg03/WDVDQ+GMEru3X46uvkPLkqa3EoTON7il1o4Oa880Eng+tvkVAz7hdBpO/u+KHkRirKfED+TwKzhfu081vHiKJB6eG9y3ZBewtVgRECtYjmrvG9cPhwul8sBD8sDY+fDfq8b3k4+3Hy5v3lzNRgNKl8rcrxA6yK88WA0GNErornmOo0lxDBO3HUERkTDAckHR02Z/V/M8n1V0mU0bBSXoeECqZu+3B7ZYpxMgVkY4qlG8v00f6jEFVVr/sg2mxl3+N2qrqPXv1q0a5Y/TjO24FbyGZXP44YEkJ4Fy0uuHL7A6MVd36CX8Bz0bR9q6sIFVy39Yhl7wnXy/yMoT4VcoA0Q4mo/z78J+rDffSKXJGVxx3VRYONftJ0mbfzt6/0DsdX/U6Hbh+XM8iVpD19GpDFzQUvDuw1TXM9bUricRZ/0+QfL3viK
sidebar_class_name: "post api-method"
info_path: docs/api-reference/endpoints/hindsight-http-api
custom_edit_url: null
---
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";
<Heading
as={"h1"}
className={"openapi__heading"}
children={"Add/merge memory bank background"}
>
</Heading>
<MethodEndpoint
method={"post"}
path={"/v1/default/banks/{bank_id}/background"}
context={"endpoint"}
>
</MethodEndpoint>
Add new background information or merge with existing. LLM intelligently resolves conflicts, normalizes to first person, and optionally infers disposition traits.
<Heading
id={"request"}
as={"h2"}
className={"openapi-tabs__heading"}
children={"Request"}
>
</Heading>
<ParamsDetails
parameters={[{"name":"bank_id","in":"path","required":true,"schema":{"type":"string","title":"Bank Id"}}]}
>
</ParamsDetails>
<RequestSchema
title={"Body"}
body={{"required":true,"content":{"application/json":{"schema":{"properties":{"content":{"type":"string","title":"Content","description":"New background information to add or merge"},"update_disposition":{"type":"boolean","title":"Update Disposition","description":"If true, infer disposition traits from the merged background (default: true)","default":true}},"type":"object","required":["content"],"title":"AddBackgroundRequest","description":"Request model for adding/merging background information.","example":{"content":"I was born in Texas","update_disposition":true}}}}}}
>
</RequestSchema>
<StatusCodes
id={undefined}
label={undefined}
responses={{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"background":{"type":"string","title":"Background"},"disposition":{"anyOf":[{"properties":{"skepticism":{"type":"integer","maximum":5,"minimum":1,"title":"Skepticism","description":"How skeptical vs trusting (1=trusting, 5=skeptical)"},"literalism":{"type":"integer","maximum":5,"minimum":1,"title":"Literalism","description":"How literally to interpret information (1=flexible, 5=literal)"},"empathy":{"type":"integer","maximum":5,"minimum":1,"title":"Empathy","description":"How much to consider emotional context (1=detached, 5=empathetic)"}},"type":"object","required":["skepticism","literalism","empathy"],"title":"DispositionTraits","description":"Disposition traits that influence how memories are formed and interpreted.","example":{"empathy":3,"literalism":3,"skepticism":3}},{"type":"null"}]}},"type":"object","required":["background"],"title":"BackgroundResponse","description":"Response model for background update.","example":{"background":"I was born in Texas. I am a software engineer with 10 years of experience.","disposition":{"empathy":3,"literalism":3,"skepticism":3}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"}}}}}}
>
</StatusCodes>