{"openapi":"3.1.0","info":{"title":"LSH AI Agent API","version":"0.1"},"paths":{"/ric/lsh-ai-agent/v1/data-retrieval-agent":{"post":{"tags":["LSH AI Agent"],"summary":"Public endpoint for the data retrieval agent","operationId":"public_data_retrieval_agent_endpoint_ric_lsh_ai_agent_v1_data_retrieval_agent_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicAgentSuccessResponse"},{"$ref":"#/components/schemas/PublicAgentMessageResponse"}],"title":"Response Public Data Retrieval Agent Endpoint Ric Lsh Ai Agent V1 Data Retrieval Agent Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ric/lsh-ai-agent/v1/reasoning-agent":{"post":{"tags":["LSH AI Agent"],"summary":"Public endpoint for the reasoning agent","operationId":"public_reasoning_agent_endpoint_ric_lsh_ai_agent_v1_reasoning_agent_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReasoningAgentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicReasoningAgentSuccessResponse"},{"$ref":"#/components/schemas/PublicReasoningAgentMessageResponse"}],"title":"Response Public Reasoning Agent Endpoint Ric Lsh Ai Agent V1 Reasoning Agent Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AgentStatus":{"type":"string","enum":["SUCCESS","CLARIFICATION_REQUIRED","NOT_FOUND"],"title":"AgentStatus"},"Evidence":{"properties":{"index":{"type":"integer","title":"Index","description":"1-based index used as [1],[2] reference in the report"},"question":{"type":"string","title":"Question","description":"Question sent to the data retrieval agent"},"reasoning":{"type":"string","title":"Reasoning","description":"Explanation of why this data retrieval was performed"},"conversation_id":{"type":"string","title":"Conversation Id","description":"Data agent conversation ID for this call"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message","description":"Message returned by the data retrieval agent"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data","description":"Retrieved data"},"cypher_query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cypher Query","description":"Final Cypher query executed by the data agent"},"assumptions":{"items":{"type":"string"},"type":"array","title":"Assumptions","description":"Assumptions made by the data agent"},"status":{"$ref":"#/components/schemas/AgentStatus","description":"Data agent response status"}},"type":"object","required":["index","question","reasoning","conversation_id","status"],"title":"Evidence","description":"A single data retrieval agent call and its results."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IntermediateStep":{"properties":{"tool":{"type":"string","title":"Tool"},"reason":{"type":"string","title":"Reason"},"duration":{"type":"number","title":"Duration"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Tool-specific metadata (e.g., search indices, result details)"}},"type":"object","required":["tool","reason","duration"],"title":"IntermediateStep"},"PublicAgentMessageResponse":{"properties":{"status":{"$ref":"#/components/schemas/AgentStatus"},"conversation_id":{"type":"string","title":"Conversation Id"},"message":{"type":"string","title":"Message"},"assumptions":{"items":{"type":"string"},"type":"array","title":"Assumptions"},"intermediate_steps":{"items":{"$ref":"#/components/schemas/IntermediateStep"},"type":"array","title":"Intermediate Steps"},"usage":{"$ref":"#/components/schemas/PublicUsageInfo"}},"type":"object","required":["status","conversation_id","message"],"title":"PublicAgentMessageResponse"},"PublicAgentRequest":{"properties":{"question":{"type":"string","title":"Question","description":"Natural language question"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id","description":"Existing conversation context ID"}},"type":"object","required":["question"],"title":"PublicAgentRequest"},"PublicAgentSuccessResponse":{"properties":{"status":{"$ref":"#/components/schemas/AgentStatus","default":"SUCCESS"},"conversation_id":{"type":"string","title":"Conversation Id"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data"},"assumptions":{"items":{"type":"string"},"type":"array","title":"Assumptions"},"intermediate_steps":{"items":{"$ref":"#/components/schemas/IntermediateStep"},"type":"array","title":"Intermediate Steps"},"cypher_query":{"type":"string","title":"Cypher Query"},"usage":{"$ref":"#/components/schemas/PublicUsageInfo"}},"type":"object","required":["conversation_id","cypher_query"],"title":"PublicAgentSuccessResponse"},"PublicReasoningAgentMessageResponse":{"properties":{"status":{"type":"string","title":"Status"},"conversation_id":{"type":"string","title":"Conversation Id"},"message":{"type":"string","title":"Message"},"usage":{"$ref":"#/components/schemas/PublicReasoningUsageInfo"}},"type":"object","required":["status","conversation_id","message"],"title":"PublicReasoningAgentMessageResponse"},"PublicReasoningAgentRequest":{"properties":{"question":{"type":"string","title":"Question","description":"Natural language question"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id","description":"Existing reasoning agent conversation ID"}},"type":"object","required":["question"],"title":"PublicReasoningAgentRequest"},"PublicReasoningAgentSuccessResponse":{"properties":{"status":{"type":"string","title":"Status","default":"SUCCESS"},"conversation_id":{"type":"string","title":"Conversation Id"},"report":{"type":"string","title":"Report","description":"Markdown report containing summary (with [n] evidence refs), assumptions, and reasoning steps"},"evidence":{"items":{"$ref":"#/components/schemas/Evidence"},"type":"array","title":"Evidence"},"usage":{"$ref":"#/components/schemas/PublicReasoningUsageInfo"}},"type":"object","required":["conversation_id","report"],"title":"PublicReasoningAgentSuccessResponse"},"PublicReasoningUsageInfo":{"properties":{"reasoning_request_input_tokens":{"type":"integer","title":"Reasoning Request Input Tokens","default":0},"reasoning_request_output_tokens":{"type":"integer","title":"Reasoning Request Output Tokens","default":0},"reasoning_conversation_input_tokens":{"type":"integer","title":"Reasoning Conversation Input Tokens","default":0},"reasoning_conversation_output_tokens":{"type":"integer","title":"Reasoning Conversation Output Tokens","default":0},"reasoning_current_context_window":{"type":"integer","title":"Reasoning Current Context Window","default":0},"reasoning_model_context_window":{"type":"integer","title":"Reasoning Model Context Window","default":0},"data_agent_request_input_tokens":{"type":"integer","title":"Data Agent Request Input Tokens","default":0},"data_agent_request_output_tokens":{"type":"integer","title":"Data Agent Request Output Tokens","default":0},"data_agent_conversation_input_tokens":{"type":"integer","title":"Data Agent Conversation Input Tokens","default":0},"data_agent_conversation_output_tokens":{"type":"integer","title":"Data Agent Conversation Output Tokens","default":0},"total_duration":{"type":"number","title":"Total Duration","default":0}},"type":"object","title":"PublicReasoningUsageInfo","description":"Cost/usage breakdown for a reasoning agent request."},"PublicUsageInfo":{"properties":{"request_input_tokens":{"type":"integer","title":"Request Input Tokens","default":0},"request_output_tokens":{"type":"integer","title":"Request Output Tokens","default":0},"conversation_input_tokens":{"type":"integer","title":"Conversation Input Tokens","default":0},"conversation_output_tokens":{"type":"integer","title":"Conversation Output Tokens","default":0},"total_duration":{"type":"number","title":"Total Duration","default":0}},"type":"object","title":"PublicUsageInfo"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"key":{"type":"apiKey","in":"header","name":"X-ApiKey"}}},"servers":[{"url":"https://api.clarivate.com"}],"security":[{"key":[]}]}