Smart search | ElevenLabs Documentation

import { ElevenLabsClient, ElevenLabsEnvironment } from "@elevenlabs/elevenlabs-js";
async function main() {
    const client = new ElevenLabsClient({
        environment: ElevenLabsEnvironment.Production,
    });
    await client.conversationalAi.conversations.messages.search({
        textQuery: "Customer requesting refund for a delayed order",
        agentId: "21m00Tcm4TlvDq8ikWAM",
        pageSize: 10,
        cursor: "eyJwYWdlIjoxLCJpZCI6IjEyMzQ1NiJ9",
    });
}
main();

{
  "results": [
    {
      "conversation_id": "conv_9876543210",
      "agent_id": "21m00Tcm4TlvDq8ikWAM",
      "transcript_index": 5,
      "chunk_text": "I understand your order was delayed and you would like a refund. Let me check the details and assist you with the refund process.",
      "score": 0.92,
      "conversation_start_time_unix_secs": 1685000000,
      "agent_name": "Support Agent Jane"
    }
  ],
  "has_more": false,
  "meta": {
    "total": 1,
    "page": 1,
    "page_size": 1
  },
  "next_cursor": "eyJwYWdlIjoyLCJpZCI6Ijk4NzY1NDMyMSJ9"
}

Search conversation transcripts by semantic similarity to surface relevant messages based on meaning and intent, rather than exact keyword matches

Headers

xi-api-keystringOptional

Query parameters

text_querystringRequired

The search query text for semantic similarity matching

agent_idstringOptional

The id of the agent you're taking the action on.

page_sizeintegerOptional1-50Defaults to 20

Number of results per page. Max 50.

cursorstringOptional

Used for fetching next page. Cursor is returned in the response.

Response

Successful Response

resultslist of objects

has_moreboolean

Whether there are more results available

metaobject or null

next_cursorstring or null

Cursor for the next page of results

Headers

Query parameters

Response

Errors