DEV-14675 - LLM 'filter-search/' API endpoint

usaspending_api/api_docs/markdown/endpoints.md

@@ -133,6 +133,7 @@ The currently available endpoints are listed in the following table.
 |[/api/v2/idvs/count/federal_account/<AWARD_ID\>/](/api/v2/idvs/count/federal_account/CONT_IDV_NNK14MA74C_8000/)|GET| Returns the number of federal accounts associated with children and grandchild awards of an IDV. |
 |[/api/v2/idvs/funding/](/api/v2/idvs/funding/)|POST| Returns File C funding records associated with an IDV |
 |[/api/v2/idvs/funding_rollup/](/api/v2/idvs/funding_rollup/)|POST| Returns aggregated count of awarding agencies, federal accounts, and total transaction obligated amount for all contracts under an IDV |
+|[/api/v2/llm/filter-search/](/api/v2/llm/filter-search/)|POST| Returns a streaming response for LLM-powered search operations with advanced filtering capabilities |
 |[/api/v2/recipient/](/api/v2/recipient/)|POST| Returns a list of recipients in USAspending DB |
 |[/api/v2/recipient/children/<DUNS_OR_UEI\>/](/api/v2/recipient/children/006928857/)|GET| Returns recipient details based on DUNS or UEI number |
 |[/api/v2/recipient/count/](/api/v2/recipient/count/)|POST| Returns the count of recipents for the given filters |

usaspending_api/llm/assistants/filter_search.py

@@ -158,7 +158,7 @@ def handle_tool_use(self, tool_requests: list[dict], message: Message) -> Genera
             tool = self.tools_by_name[tool_use["name"]]
 
             yield {
-                "search_id": self.session.id,
+                "search_id": str(self.session.id),
                 "type": "tool_start",
                 "tool_use_id": t.id,
                 "message": tool.logging(tool_use["input"]) + "\n",

usaspending_api/llm/fixtures/prompts.yaml

@@ -9,4 +9,4 @@
       - You may need to call other tools before calling the `execute_filter` tool in order to get valid input parameters to `execute_filter`.
       - You may only call the `execute_filter` tool once. Calling `execute_filter` terminates the conversation. Therefore, include all the relevant parameters in the first and only call to `execute_filter`.
       - Only include the relevant input paramaters to `execute_filter`.
-      - You must call `execute_filter`.  Do not quit before calling this tool.
+      - You must call `execute_filter`.  Do not quit before calling this tool.