Skip to main content
POST
Genai Search

ボディ

application/json

Query the messages table by content and/or span-level filters.

Scans the messages table (one row per message occurrence, populated by an MV from spans) and returns matching span-level hits. Full-text search sets query; structured retrieval (e.g. all messages in a trace) leaves query empty and uses the filters below. The caller groups by conversation for the response shape.

project_id
string
必須
query
string
デフォルト:""
trace_id
string | null
roles
enum<string>[] | null
利用可能なオプション:
,
user,
assistant,
system,
tool,
tool_call,
tool_result
conversation_id
string | null
agent_name
string | null
provider_name
string | null
request_model
string | null
truncate_content
boolean
デフォルト:true
started_after
string<date-time> | null
started_before
string<date-time> | null
limit
integer
デフォルト:20
必須範囲: 0 <= x <= 1000
offset
integer
デフォルト:0
必須範囲: x >= 0

レスポンス

Successful Response

Response from a full-text search across agent messages.

results
AgentSearchConversationResult · object[]
必須
total_conversations
integer
デフォルト:0
必須
最終更新日 2026年9月30日