Passer au contenu principal
POST
/
agents
/
search
Recherche Genai
curl --request POST \
  --url https://api.example.com/agents/search \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>",
  "agent_name": "<string>",
  "conversation_id": "<string>",
  "limit": 20,
  "offset": 0,
  "provider_name": "<string>",
  "query": "",
  "request_model": "<string>",
  "roles": [],
  "started_after": "2023-11-07T05:31:56Z",
  "started_before": "2023-11-07T05:31:56Z",
  "trace_id": "<string>",
  "truncate_content": true
}
'
{
  "results": [
    {
      "agent_name": "<string>",
      "conversation_id": "<string>",
      "conversation_name": "<string>",
      "last_activity": "2023-11-07T05:31:56Z",
      "matched_messages": [
        {
          "content_digest": "<string>",
          "content_preview": "<string>",
          "span_id": "<string>",
          "started_at": "2023-11-07T05:31:56Z",
          "trace_id": "<string>"
        }
      ]
    }
  ],
  "total_conversations": 0
}

Corps

application/json

Interrogez la table messages par contenu et/ou à l’aide de filtres au niveau des spans.

Analyse la table messages (une ligne par occurrence de message, alimentée par une vue matérialisée issue des spans) et renvoie les correspondances au niveau des spans. La recherche en texte intégral renseigne query ; la récupération structurée (par ex. tous les messages d’une trace) laisse query vide et utilise les filtres ci-dessous. L’appelant regroupe par conversation pour la structure de la réponse.

​
project_id
string
requis
​
agent_name
string | null
​
conversation_id
string | null
​
limit
integer
défaut:20
Plage requise: 0 <= x <= 1000
​
offset
integer
défaut:0
Plage requise: x >= 0
​
provider_name
string | null
​
query
string
défaut:""
​
request_model
string | null
​
roles
enum<string>[] | null
Options disponibles:
,
user,
assistant,
system,
tool,
tool_call,
tool_result
​
started_after
string<date-time> | null
​
started_before
string<date-time> | null
​
trace_id
string | null
​
truncate_content
boolean
défaut:true

Réponse

Réponse réussie

Réponse à une recherche en texte intégral dans les messages d’agent.

​
results
AgentSearchConversationResult · object[]
requis
​
total_conversations
integer
défaut:0