v1

latestOpenAPI 3.1.02026-08-045623.9 KB
knowledge

Store Knowledge

Store and process agent interaction knowledge asynchronously.

This endpoint accepts knowledge about agent interactions and queues it for background processing. The processing pipeline analyzes the interaction, generates insights, and stores them for future use.

Args: knowledge: Details about the agent interaction including: - tenant_id: Tenant identifier for organization/project - query: The user's original query/request - turns: List of interaction turns between user and agent - success: Whether the interaction achieved the user's goal - agent_type: Type of agent that handled the interaction - timestamp: When the interaction occurred (ISO format) background_tasks: FastAPI background tasks handler for async processing

Returns: Dict containing: - status: "accepted" - message: Processing acknowledgement - tenant_id: The tenant ID from the request

Notes: - Each turn should capture the key decision points and context - The memory field helps track the agent's understanding - Success should reflect whether the user's goal was achieved - Timestamp should be in ISO 8601 format - Agent type helps categorize different interaction patterns

Raises: HTTPException(500): If there is an error queueing the knowledge

post/store_knowledge

Request body

tenant_idstring required

Unique identifier for the tenant/user

querystring required

The original user query or instruction

successboolean nullable

Whether the agent completed its task successfully

agent_typestring nullable

Type of agent (e.g., 'browser', 'voice')

timestampstring date-time
metadataobject nullable

Response

Successful Response

object required