> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WeaveClient

> Référence du SDK TypeScript

Défini dans : [src/weaveClient.ts:445](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L445)

<div id="properties">
  ## Propriétés
</div>

<div id="projectid">
  ### projectId
</div>

> **projectId** : `string`

Défini dans : [src/weaveClient.ts:456](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L456)

***

<div id="settings">
  ### settings
</div>

> **settings** : [`Settings`](../type-aliases/settings)

Défini dans : [src/weaveClient.ts:457](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L457)

***

<div id="traceserverapi">
  ### traceServerApi
</div>

> **traceServerApi**: `Api`\<`any`>

Défini dans : [src/weaveClient.ts:455](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L455)

<div id="methods">
  ## Méthodes
</div>

<div id="addscore">
  ### addScore()
</div>

> **addScore**(`predictCallId`, `scorerCallId`, `runnableRefUri`, `scorerOutput`) : `Promise`\<`string`>

Ajoute le résultat d’un scorer (par exemple, sa sortie) à un appel.
Utilisé dans une évaluation impérative pour joindre les résultats du scorer aux appels de prédiction.

Défini dans : [src/weaveClient.ts:1727](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1727)

#### Paramètres

<div id="predictcallid">
  ##### predictCallId
</div>

`string`

ID de l’appel predict auquel joindre le feedback

<div id="scorercallid">
  ##### scorerCallId
</div>

`string`

ID de l’appel du scorer ayant généré le feedback

<div id="runnablerefuri">
  ##### runnableRefUri
</div>

`string`

URI du scorer (op ou réf. d’objet)

<div id="scoreroutput">
  ##### scorerOutput
</div>

`any`

Résultat du scorer

#### Renvoie

`Promise`\<`string`>

***

<div id="createcall">
  ### createCall()
</div>

> **createCall**(`internalCall`, `opRef`, `params`, `parameterNames`, `thisArg`, `currentCall`, `parentCall`, `startTime`, `displayName?`, `attributes?`) : `Promise`\<`void`>

Défini dans : [src/weaveClient.ts:1570](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1570)

#### Paramètres

<div id="internalcall">
  ##### internalCall
</div>

`InternalCall`

<div id="opref">
  ##### opRef
</div>

`any`

<div id="params">
  ##### params
</div>

`any`\[]

<div id="parameternames">
  ##### nomsDesParamètres
</div>

`ParameterNamesOption`

<div id="thisarg">
  ##### thisArg
</div>

`any`

<div id="currentcall">
  ##### currentCall
</div>

`CallStackEntry`

<div id="parentcall">
  ##### parentCall
</div>

`CallStackEntry` | `undefined`

<div id="starttime">
  ##### startTime
</div>

`Date`

##### nomAffiché ?

`string`

<div id="attributes">
  ##### attributs ?
</div>

`Record`\<`string`, `any`>

#### Renvoie

`Promise`\<`void`>

***

<div id="finishcall">
  ### finishCall()
</div>

> **finishCall**(`call`, `result`, `currentCall`, `parentCall`, `summarize`, `endTime`, `startCallPromise`): `Promise`\<`void`>

Défini dans : [src/weaveClient.ts:1630](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1630)

#### Paramètres

<div id="call">
  ##### appel
</div>

`InternalCall`

<div id="result">
  ##### résultat
</div>

`any`

<div id="currentcall">
  ##### currentCall
</div>

`CallStackEntry`

<div id="parentcall">
  ##### parentCall
</div>

`CallStackEntry` | `undefined`

<div id="summarize">
  ##### summarize
</div>

((`result`) => `Record`\<`string`, `any`>) | `undefined`

<div id="endtime">
  ##### endTime
</div>

`Date`

<div id="startcallpromise">
  ##### startCallPromise
</div>

`Promise`\<`void`>

#### Renvoie

`Promise`\<`void`>

***

<div id="finishcallwithexception">
  ### finishCallWithException()
</div>

> **finishCallWithException**(`call`, `error`, `currentCall`, `parentCall`, `endTime`, `startCallPromise`): `Promise`\<`void`>

Défini dans : [src/weaveClient.ts:1672](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1672)

#### Paramètres

<div id="call">
  ##### appel
</div>

`InternalCall`

<div id="error">
  ##### erreur
</div>

`any`

<div id="currentcall">
  ##### currentCall
</div>

`CallStackEntry`

<div id="parentcall">
  ##### parentCall
</div>

`CallStackEntry` | `undefined`

<div id="endtime">
  ##### endTime
</div>

`Date`

<div id="startcallpromise">
  ##### startCallPromise
</div>

`Promise`\<`void`>

#### Renvoie

`Promise`\<`void`>

***

<div id="get">
  ### get()
</div>

> **get**(`ref`) : `Promise`\<`any`>

Défini dans : [src/weaveClient.ts:1025](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1025)

#### Paramètres

<div id="ref">
  ##### réf.
</div>

[`ObjectRef`](../classes/objectref)

#### Renvoie

`Promise`\<`any`>

***

<div id="getagentcustomattributes">
  ### getAgentCustomAttributes()
</div>

> **getAgentCustomAttributes**(`options`): `Promise`\<[`Réponse`](../type-aliases/response)\<`GetAgentCustomAttributesResult`>>

Découvrez les clés d’attributs personnalisés typés observées dans les spans d’agent du
projet. Chaque ligne de résultat correspond à un triplet `(source, key, value_type)`, accompagné du
nombre de spans qui le portent. Les API de requête, de regroupement et de statistiques des
spans l’utilisent pour référencer les attributs personnalisés.

Filtrez les spans pris en compte en transmettant `query` (un filtre de span
structuré), `startedAfter` / `startedBefore` (ISO-8601), ou les deux. Utilisez
`limit` / `offset` pour parcourir les clés découvertes par pages.

Défini dans : [src/weaveClient.ts:772](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L772)

#### Paramètres

##### options

`GetAgentCustomAttributesOptions`

#### Renvoie

`Promise`\<[`Réponse`](../type-aliases/response)\<`GetAgentCustomAttributesResult`>>

<div id="example">
  #### Exemple
</div>

```ts twoslash theme={null}
// @noErrors
const client = await weave.init('entity/project');
const resp = await client.getAgentCustomAttributes({
  query: {
    $expr: {
      $eq: [{$getField: 'agent_name'}, {$literal: 'my-agent'}],
    },
  },
  startedAfter: '2026-06-15T00:00:00Z',
  limit: 200,
});

for (const attr of resp.data.attributes ?? []) {
  console.log(`${attr.source}.${attr.key} (${attr.value_type}): ${attr.span_count}`);
}
```

***

<div id="getagents">
  ### getAgents()
</div>

> **getAgents**(`options?`): `Promise`\<[`Réponse`](../type-aliases/response)\<[`GetAgentsResult`](../type-aliases/getagentsresult)>>

Répertorie les agents avec des statistiques agrégées.

Défini dans : [src/weaveClient.ts:488](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L488)

#### Paramètres

##### options ?

[`GetAgentsOptions`](./getagentsoptions) = `{}`

#### Renvoie

`Promise`\<[`Réponse`](../type-aliases/response)\<[`GetAgentsResult`](../type-aliases/getagentsresult)>>

<div id="example">
  #### Exemple
</div>

```ts twoslash theme={null}
// @noErrors
const client = await weave.init('entity/project');
const resp = await client.getAgents({limit: 20});

for (const agent of resp.data.agents) {
  console.log(agent.agent_name, agent.total_input_tokens);
}

console.log(`total count: ${resp.data.total_count}`)
```

***

<div id="getagentspans">
  ### getAgentSpans()
</div>

> **getAgentSpans**(`options`) : `Promise`\<[`Réponse`](../type-aliases/response)\<[`GetAgentSpansResult`](../type-aliases/getagentspansresult)>>

Interroge les spans d’agent, éventuellement filtrés par nom d’agent et/ou par une expression de requête de type Mongo.

Défini dans : [src/weaveClient.ts:566](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L566)

#### Paramètres

##### options

[`GetAgentSpansOptions`](./getagentspansoptions)

#### Renvoie

`Promise`\<[`Réponse`](../type-aliases/response)\<[`GetAgentSpansResult`](../type-aliases/getagentspansresult)>>

<div id="examples">
  #### Exemples
</div>

```ts twoslash theme={null}
// @noErrors
const client = await weave.init('entity/project');
const resp = await client.getAgentSpans({agentName: 'my-agent', limit: 20});

for (const span of resp.data.spans) {
  console.log(span.span_id, span.span_name, span.input_tokens);
}
```

```ts twoslash theme={null}
// @noErrors
const client = await weave.init('entity/project');

const resp = await client.getAgentSpans({
  agentName: 'my-agent',
  query: {
    $expr: {$gt: [{$getField: 'input_tokens'}, {$literal: 1000}]},
  },
});

for (const span of resp.data.spans) {
  console.log(span.span_id, span.span_name, span.input_tokens);
}
```

***

<div id="getagentspanstats">
  ### getAgentSpanStats()
</div>

> **getAgentSpanStats**(`options`) : `Promise`\<[`Réponse`](../type-aliases/response)\<`GetAgentSpanStatsResult`>>

Agrégations sur les agent spans du projet, renvoyées sous forme de lignes et de métadonnées de colonnes
adaptées aux visualisations de séries temporelles ou par compartiments.

`start` (requis) et `end` définissent la fenêtre temporelle. Chaque entrée de
`metrics` indique un champ à extraire et la façon de l’agréger (`sum`,
`avg`, `count`, percentiles, etc.). Transmettez `granularity` (en secondes) pour
regrouper les lignes par intervalle temporel, ou `groupBy` pour ventiler les résultats par agent /
provider / model / etc. `query` filtre les spans sous-jacents avant
l’agrégation.

Défini dans : [src/weaveClient.ts:621](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L621)

#### Paramètres

##### options

`GetAgentSpanStatsOptions`

#### Renvoie

`Promise`\<[`Réponse`](../type-aliases/response)\<`GetAgentSpanStatsResult`>>

<div id="example">
  #### Exemple
</div>

```ts twoslash theme={null}
// @noErrors
const client = await weave.init('entity/project');
const resp = await client.getAgentSpanStats({
  start: '2026-06-10T00:00:00Z',
  end: '2026-06-23T00:00:00Z',
  granularity: 86400, // une ligne par jour
  metrics: [
    {
      alias: 'total_input_tokens',
      value_type: 'number',
      aggregations: ['sum'],
      value: {source: 'field', key: 'input_tokens'},
    },
  ],
  groupBy: [{key: 'agent_name'}],
});

for (const row of resp.data.rows ?? []) {
  console.log(row.started_at_bucket, row.agent_name, row.total_input_tokens);
}
```

***

<div id="getagentturn">
  ### getAgentTurn()
</div>

> **getAgentTurn**(`options`) : `Promise`\<[`Réponse`](../type-aliases/response)\<`AgentTraceChatRes`>>

Obtenir les données, y compris les messages, d’un seul tour de conversation (par traceId).

Défini dans : [src/weaveClient.ts:655](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L655)

#### Paramètres

##### options

[`GetAgentTurnOptions`](./getagentturnoptions)

#### Renvoie

`Promise`\<[`Réponse`](../type-aliases/response)\<`AgentTraceChatRes`>>

<div id="example">
  #### Exemple
</div>

```ts twoslash theme={null}
// @noErrors
const client = await weave.init('entity/project');
const resp = await client.getAgentTurn({
  traceId: '01997b8a-2c89-7c4d-9d0e-2f7e5b9a1b2c',
  includeFeedback: true,
});

console.log(resp.data.root_span_name, resp.data.total_duration_ms);

for (const message of resp.data.messages ?? []) {
  if (message.user_message) console.log('user:', message.user_message);
  if (message.assistant_message) console.log('assistant:', message.assistant_message);
}
```

***

<div id="getagentturns">
  ### getAgentTurns()
</div>

> **getAgentTurns**(`options`): `Promise`\<[`Réponse`](../type-aliases/response)\<[`GetAgentTurnsResult`](../type-aliases/getagentturnsresult)>>

Obtenir les données (y compris les messages) de nombreux tours de conversation (par conversationId).

Défini dans : [src/weaveClient.ts:688](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L688)

#### Paramètres

##### options

[`GetAgentTurnsOptions`](./getagentturnsoptions)

#### Renvoie

`Promise`\<[`Réponse`](../type-aliases/response)\<[`GetAgentTurnsResult`](../type-aliases/getagentturnsresult)>>

<div id="example">
  #### Exemple
</div>

```ts twoslash theme={null}
// @noErrors
const client = await weave.init('entity/project');
const resp = await client.getAgentTurns({
  conversationId: 'trace_c50312356de3487fa90e381c9399b5b4',
  limit: 20,
  includeFeedback: true,
});

for (const turn of resp.data.turns ?? []) {
  console.log(turn.trace_id, turn.root_span_name);
  for (const message of turn.messages ?? []) {
    if (message.user_message) console.log('user:', message.user_message);
    if (message.assistant_message) console.log('assistant:', message.assistant_message);
  }
}

console.log(`total turns: ${resp.data.total_turns}, has more: ${resp.data.has_more}`);
```

***

<div id="getagentversions">
  ### getAgentVersions()
</div>

> **getAgentVersions**(`options`) : `Promise`\<[`Réponse`](../type-aliases/response)\<[`GetAgentVersionsResult`](../type-aliases/getagentversionsresult)>>

Liste les versions d’un agent donné.

Défini dans : [src/weaveClient.ts:522](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L522)

#### Paramètres

##### options

[`GetAgentVersionsOptions`](./getagentversionsoptions)

#### Renvoie

`Promise`\<[`Réponse`](../type-aliases/response)\<[`GetAgentVersionsResult`](../type-aliases/getagentversionsresult)>>

<div id="example">
  #### Exemple
</div>

```ts twoslash theme={null}
// @noErrors
const client = await weave.init('entity/project');
const resp = await client.getAgentVersions({agentName: 'my-agent', limit: 20});

for (const version of resp.data.versions) {
  console.log(version.agent_version, version.total_input_tokens);
}

console.log(`total count: ${resp.data.total_count}`)
```

***

<div id="getcall">
  ### getCall()
</div>

> **getCall**(`callId`, `includeCosts?`) : `Promise`\<`Call`>

Défini dans : [src/weaveClient.ts:902](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L902)

#### Paramètres

<div id="callid">
  ##### callId
</div>

`string`

##### includeCosts ?

`boolean` = `false`

#### Renvoie

`Promise`\<`Call`>

***

<div id="getcalls">
  ### getCalls()
</div>

<div id="call-signature">
  #### Signature de l’appel
</div>

> **getCalls**(`options?`): `Promise`\<`Call`\[]>

Défini dans : [src/weaveClient.ts:935](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L935)

<div id="parameters">
  ##### Paramètres
</div>

<div id="options">
  ###### options ?
</div>

[`GetCallsOptions`](./getcallsoptions)

<div id="returns">
  ##### Renvoie
</div>

`Promise`\<`Call`\[]>

<div id="call-signature">
  #### Signature de l’appel
</div>

> **getCalls**(`options?`, `includeCosts?`, `limit?`): `Promise`\<`Call`\[]>

Défini dans : [src/weaveClient.ts:936](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L936)

<div id="parameters">
  ##### Paramètres
</div>

<div id="options">
  ###### options ?
</div>

[`CallsFilter`](./callsfilter)

<div id="includecosts">
  ###### includeCosts ?
</div>

`boolean`

<div id="limit">
  ###### limite ?
</div>

`number`

<div id="returns">
  ##### Renvoie
</div>

`Promise`\<`Call`\[]>

***

<div id="getcallsiterator">
  ### getCallsIterator()
</div>

<div id="call-signature">
  #### Signature de l’appel
</div>

> **getCallsIterator**(`options?`, `includeCosts?`, `limit?`): `AsyncIterableIterator`\<[`CallSchema`](./callschema)>

Défini dans : [src/weaveClient.ts:957](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L957)

<div id="parameters">
  ##### Paramètres
</div>

<div id="options">
  ###### options ?
</div>

[`CallsFilter`](./callsfilter)

<div id="includecosts">
  ###### includeCosts ?
</div>

`boolean`

<div id="limit">
  ###### limite ?
</div>

`number`

<div id="returns">
  ##### Renvoie
</div>

`AsyncIterableIterator`\<[`CallSchema`](./callschema)>

#### Signature d’appel

> **getCallsIterator**(`options?`): `AsyncIterableIterator`\<[`CallSchema`](./callschema)>

Défini dans : [src/weaveClient.ts:962](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L962)

<div id="parameters">
  ##### Paramètres
</div>

<div id="options">
  ###### options ?
</div>

[`GetCallsOptions`](./getcallsoptions)

<div id="returns">
  ##### Renvoie
</div>

`AsyncIterableIterator`\<[`CallSchema`](./callschema)>

***

<div id="getcallstack">
  ### getCallStack()
</div>

> **getCallStack**(): `CallStack`

Défini dans : [src/weaveClient.ts:1482](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1482)

#### Renvoie

`CallStack`

***

<div id="getcurrentattributes">
  ### getCurrentAttributes()
</div>

> **getCurrentAttributes**(): `Record`\<`string`, `any`>

Défini dans : [src/weaveClient.ts:1486](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1486)

#### Renvoie

`Record`\<`string`, `any`>

***

<div id="linkprompttoregistry">
  ### linkPromptToRegistry()
</div>

> **linkPromptToRegistry**(`prompt`, `options`): `Promise`\<`LinkAssetToRegistryRes`>

Associe une version publiée d’un prompt à un portefeuille de registre.

Défini dans : [src/weaveClient.ts:1181](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1181)

#### Paramètres

<div id="prompt">
  ##### prompt
</div>

`RegistryLinkable`

##### options

`LinkPromptToRegistryOptions`

#### Renvoie

`Promise`\<`LinkAssetToRegistryRes`>

***

<div id="publish">
  ### publish()
</div>

> **publish**(`obj`, `objId?`): `Promise`\<[`ObjectRef`](../classes/objectref)>

Défini dans : [src/weaveClient.ts:890](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L890)

#### Paramètres

<div id="obj">
  ##### obj
</div>

`any`

<div id="objid">
  ##### objId?
</div>

`string`

#### Renvoie

`Promise`\<[`ObjectRef`](../classes/objectref)>

***

<div id="pushnewcall">
  ### pushNewCall()
</div>

> **pushNewCall**() : `objet`

Défini dans : [src/weaveClient.ts:1490](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1490)

#### Renvoie

`objet`

<div id="currentcall">
  ##### currentCall
</div>

> **currentCall** : `CallStackEntry`

<div id="newstack">
  ##### newStack
</div>

> **newStack** : `CallStack`

<div id="parentcall">
  ##### parentCall
</div>

> `facultatif` **parentCall** : `CallStackEntry`

***

<div id="runwithattributes">
  ### runWithAttributes()
</div>

> **runWithAttributes**\<`T`>(`attributes`, `fn`): `T`

Défini dans : [src/weaveClient.ts:1498](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1498)

<div id="type-parameters">
  #### Paramètres de type
</div>

<div id="t">
  ##### T
</div>

`T`

#### Paramètres

##### attributs

`Record`\<`string`, `any`>

<div id="fn">
  ##### fn
</div>

() => `T`

#### Renvoie

`T`

***

<div id="runwithcallstack">
  ### runWithCallStack()
</div>

> **runWithCallStack**\<`T`>(`callStack`, `fn`) : `T`

Défini dans : [src/weaveClient.ts:1494](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1494)

<div id="type-parameters">
  #### Paramètres de type
</div>

<div id="t">
  ##### T
</div>

`T`

#### Paramètres

<div id="callstack">
  ##### pileDAppels
</div>

`CallStack`

<div id="fn">
  ##### fn
</div>

() => `T`

#### Renvoie

`T`

***

<div id="savecallend">
  ### saveCallEnd()
</div>

> **saveCallEnd**(`callEnd`) : `void`

Défini dans : [src/weaveClient.ts:1477](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1477)

#### Paramètres

<div id="callend">
  ##### callEnd
</div>

`EndedCallSchemaForInsert`

#### Renvoie

`void`

***

<div id="savecallstart">
  ### saveCallStart()
</div>

> **saveCallStart**(`callStart`) : `void`

Défini dans : [src/weaveClient.ts:1472](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1472)

#### Paramètres

<div id="callstart">
  ##### callStart
</div>

`StartedCallSchemaForInsert`

#### Renvoie

`void`

***

<div id="saveop">
  ### saveOp()
</div>

> **saveOp**(`op`, `objId?`): `Promise`\<`OpRef`>

Défini dans : [src/weaveClient.ts:1537](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1537)

#### Paramètres

<div id="op">
  ##### op
</div>

[`Op`](../type-aliases/op)\<(...`args`) => `any`>

<div id="objid">
  ##### objId?
</div>

`string`

#### Renvoie

`Promise`\<`OpRef`>

***

<div id="searchagents">
  ### searchAgents()
</div>

> **searchAgents**(`options`) : `Promise`\<[`Réponse`](../type-aliases/response)\<`SearchAgentsResult`>>

Recherche en texte intégral parmi les messages d’agent du projet. Renvoie les résultats
regroupés par conversation, avec un aperçu de chaque message correspondant.

`query` correspond au terme de recherche en texte intégral. Transmettez une chaîne vide pour récupérer
tous les messages correspondant aux filtres structurés (`agentName`,
`conversationId`, `traceId`) sans effectuer de recherche textuelle. Utilisez `limit` /
`offset` pour parcourir les résultats page par page.

Défini dans : [src/weaveClient.ts:730](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L730)

#### Paramètres

##### options

`SearchAgentsOptions`

#### Renvoie

`Promise`\<[`Réponse`](../type-aliases/response)\<`SearchAgentsResult`>>

<div id="example">
  #### Exemple
</div>

```ts twoslash theme={null}
// @noErrors
const client = await weave.init('entity/project');
const resp = await client.searchAgents({
  query: 'Liverpool',
  agentName: 'Assistant',
  limit: 20,
});

for (const conversation of resp.data.results ?? []) {
  console.log(`${conversation.conversation_id} (${conversation.agent_name})`);
  for (const match of conversation.matched_messages) {
    console.log(`  [${match.role}] ${match.content_preview}`);
  }
}

console.log(`total conversations: ${resp.data.total_conversations}`);
```

***

<div id="serializeaudio">
  ### serializeAudio()
</div>

> **serializeAudio**(`data`, `audioType?`): `Promise`\<`SerializedFileBlob`>

Téléverse des octets audio bruts vers le magasin de contenu Weave et renvoie l’espace réservé
`CustomWeaveType` pouvant être intégré à une sortie d’appel.

Utilisez cette méthode lorsque vous créez manuellement des sorties d’appel (par ex. via `saveCallEnd`)
et que le pipeline de sérialisation automatique de `finishCall` n’est pas utilisé.

Défini dans : [src/weaveClient.ts:1424](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1424)

#### Paramètres

<div id="data">
  ##### data
</div>

`Buffer`

Données audio brutes (WAV pour une compatibilité optimale avec les navigateurs)

<div id="audiotype">
  ##### audioType ?
</div>

`"wav"` = `DEFAULT_AUDIO_TYPE`

Format de fichier — seul le format « wav » est actuellement pris en charge

#### Renvoie

`Promise`\<`SerializedFileBlob`>

***

<div id="updatecall">
  ### updateCall()
</div>

> **updateCall**(`callId`, `displayName`) : `Promise`\<`void`>

Défini dans : [src/weaveClient.ts:1710](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L1710)

#### Paramètres

<div id="callid">
  ##### callId
</div>

`string`

<div id="displayname">
  ##### nom d’affichage
</div>

`string`

#### Renvoie

`Promise`\<`void`>

***

<div id="waitforbatchprocessing">
  ### waitForBatchProcessing()
</div>

> **waitForBatchProcessing**(): `Promise`\<`void`>

Défini dans : [src/weaveClient.ts:801](https://github.com/wandb/weave/blob/8c5f077eb11c42b84000726ff20504abc728d3fb/sdks/node/src/weaveClient.ts#L801)

#### Renvoie

`Promise`\<`void`>