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일