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

# Outil

> Un appel d’outil.

Un appel d’outil. Émet un span `execute_tool` contenant le nom de l’outil,
les arguments, l’identifiant de l’appel d’outil et le résultat. Les arguments et
résultats de type chaîne sont enregistrés tels quels ; les autres valeurs JSON sont sérialisées.

Créé par `tracing.startTool()` (ou `turn.startTool()`, ou
`llm.startTool()`) et terminé par `end()`, qui accepte le résultat ainsi que
des métadonnées d’erreur facultatives.

## Exemples

```typescript theme={"system"}
const tool = tracing.startTool({name: 'get_weather', args: {city: 'Tokyo'}});
try {
  const result = await getWeather('Tokyo');
  tool.end({result});
} catch (error) {
  tool.end({error: error as Error, errorType: 'weather_error'});
  throw error;
}
```

## Propriétés

**args** `string`

Lecture seule.

**name** `string`

Lecture seule.

**toolCallId** `string`

Lecture seule.

## Méthodes

### `end()`

```typescript theme={"system"}
end(opts?: ToolEndOptions): void
```

Enregistre un résultat et un type d’erreur facultatifs, puis ferme le span. Méthode idempotente.
Transmettez `error` pour marquer le span en échec et `endTime` pour antidater la fermeture.

#### Paramètres

**opts** `ToolEndOptions`

Type : [`ToolEndOptions`](https://docs.coreweave.com/fr/products/agent-lens/reference/typescript-sdk/interfaces/toolendoptions)

### `setAttributes()`

```typescript theme={"system"}
setAttributes(attributes: Attributes): this
```

Définit plusieurs attributs sur le span en une seule fois. Après un appel à
`end()`, émet un avertissement et ne fait rien. Équivalent de `Span.setAttributes` d'OTel (et de
`set_attributes` dans le SDK Python).

#### Paramètres

**attributes** `Attributes` *required*

#### Renvoie

`this`

#### Exemples

```typescript theme={"system"}
span.setAttributes({'weave.tag': 'prod', 'gen_ai.response.id': id});
```
