telnyx-ai-assistants-javascript

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Telnyx AI Assistants - JavaScript

Telnyx AI助手 - JavaScript

Installation

安装

bash

npm install telnyx

bash

npm install telnyx

Setup

配置

javascript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

All examples below assume

client

is already initialized as shown above.

javascript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

以下所有示例均默认

client

已按照上方步骤完成初始化。

Error Handling

错误处理

All API calls can fail with network errors, rate limits (429), validation errors (422), or authentication errors (401). Always handle errors in production code:

javascript

try {
  const assistant = await client.ai.assistants.create({
    instructions: 'You are a helpful assistant.',
    model: 'openai/gpt-4o',
    name: 'my-resource',
  });
} catch (err) {
  if (err instanceof Telnyx.APIConnectionError) {
    console.error('Network error — check connectivity and retry');
  } else if (err instanceof Telnyx.RateLimitError) {
    const retryAfter = err.headers?.['retry-after'] || 1;
    await new Promise(r => setTimeout(r, retryAfter * 1000));
  } else if (err instanceof Telnyx.APIError) {
    console.error(`API error ${err.status}: ${err.message}`);
    if (err.status === 422) {
      console.error('Validation error — check required fields and formats');
    }
  }
}

Common error codes:

invalid API key,

insufficient permissions,

resource not found,

validation error (check field formats),

rate limited (retry with exponential backoff).

所有API调用都可能遇到网络错误、速率限制(429)、校验错误(422)，或认证错误(401)。在生产代码中请务必做好错误处理：

javascript

try {
  const assistant = await client.ai.assistants.create({
    instructions: 'You are a helpful assistant.',
    model: 'openai/gpt-4o',
    name: 'my-resource',
  });
} catch (err) {
  if (err instanceof Telnyx.APIConnectionError) {
    console.error('Network error — check connectivity and retry');
  } else if (err instanceof Telnyx.RateLimitError) {
    const retryAfter = err.headers?.['retry-after'] || 1;
    await new Promise(r => setTimeout(r, retryAfter * 1000));
  } else if (err instanceof Telnyx.APIError) {
    console.error(`API error ${err.status}: ${err.message}`);
    if (err.status === 422) {
      console.error('Validation error — check required fields and formats');
    }
  }
}

常见错误码：

API密钥无效，

权限不足，

资源不存在，

校验错误（请检查字段格式），

触发速率限制（请使用指数退避策略重试）。

Important Notes

重要注意事项

Phone numbers must be in E.164 format (e.g.,
```
+13125550001
```
). Include the
```
+
```
prefix and country code. No spaces, dashes, or parentheses.
Pagination: List methods return an auto-paginating iterator. Use
```
for await (const item of result) { ... }
```
to iterate through all pages automatically.

电话号码必须采用E.164格式（例如
```
+13125550001
```
），需要包含
```
+
```
前缀和国家代码，不能包含空格、横杠或括号。
分页： 列表类方法返回自动分页的迭代器。使用
```
for await (const item of result) { ... }
```
即可自动遍历所有分页结果。

Reference Use Rules

参考使用规则

Do not invent Telnyx parameters, enums, response fields, or webhook fields.

If the parameter, enum, or response field you need is not shown inline in this skill, read references/api-details.md before writing code.
Before using any operation in
```
## Additional Operations
```
, read the optional-parameters section and the response-schemas section.

不要自行杜撰Telnyx的参数、枚举值、响应字段或webhook字段。

如果你需要的参数、枚举或响应字段没有在本技能文档中直接说明，请先阅读references/api-details.md再编写代码。
在使用
```
## 额外操作
```
中的任何接口前，请先阅读可选参数章节和响应格式章节。

Core Tasks

核心任务

Create an assistant

创建助手

Assistant creation is the entrypoint for any AI assistant integration. Agents need the exact creation method and the top-level fields returned by the SDK.

client.ai.assistants.create()

—

POST /ai/assistants

Parameter	Type	Required	Description
`name`	string	Yes
`model`	string	Yes	ID of the model to use.
`instructions`	string	Yes	System instructions for the assistant.
`tools`	array[object]	No	The tools that the assistant can use.
`toolIds`	array[string]	No
`description`	string	No
...			+12 optional params in references/api-details.md

javascript

const assistant = await client.ai.assistants.create({
  instructions: 'You are a helpful assistant.',
  model: 'openai/gpt-4o',
  name: 'my-resource',
});

console.log(assistant.id);

Primary response fields:

```
assistant.id
```
```
assistant.name
```
```
assistant.model
```
```
assistant.instructions
```
```
assistant.createdAt
```
```
assistant.description
```

创建助手是所有AI助手集成的入口。Agent需要准确的创建方法和SDK返回的顶层字段。

client.ai.assistants.create()

—

POST /ai/assistants

参数	类型	必填	描述
`name`	string	是
`model`	string	是	要使用的模型ID。
`instructions`	string	是	助手的系统指令。
`tools`	array[object]	否	助手可以使用的工具。
`toolIds`	array[string]	否
`description`	string	否
...			还有12个可选参数见references/api-details.md

javascript

const assistant = await client.ai.assistants.create({
  instructions: 'You are a helpful assistant.',
  model: 'openai/gpt-4o',
  name: 'my-resource',
});

console.log(assistant.id);

主要响应字段：

```
assistant.id
```
```
assistant.name
```
```
assistant.model
```
```
assistant.instructions
```
```
assistant.createdAt
```
```
assistant.description
```

Chat with an assistant

与助手对话

Chat is the primary runtime path. Agents need the exact assistant method and the response content field.

client.ai.assistants.chat()

—

POST /ai/assistants/{assistant_id}/chat

Parameter	Type	Required	Description
`content`	string	Yes	The message content sent by the client to the assistant
`conversationId`	string (UUID)	Yes	A unique identifier for the conversation thread, used to mai...
`assistantId`	string (UUID)	Yes
`name`	string	No	The optional display name of the user sending the message

javascript

const response = await client.ai.assistants.chat('assistant_id', {
  content: 'Tell me a joke about cats',
  conversation_id: '42b20469-1215-4a9a-8964-c36f66b406f4',
});

console.log(response.content);

Primary response fields:

```
response.content
```

对话是核心运行路径。Agent需要准确的助手调用方法和响应内容字段。

client.ai.assistants.chat()

—

POST /ai/assistants/{assistant_id}/chat

参数	类型	必填	描述
`content`	string	是	客户端发送给助手的消息内容
`conversationId`	string (UUID)	是	会话线程的唯一标识符，用于维...
`assistantId`	string (UUID)	是
`name`	string	否	发送消息的用户的可选显示名称

javascript

const response = await client.ai.assistants.chat('assistant_id', {
  content: 'Tell me a joke about cats',
  conversation_id: '42b20469-1215-4a9a-8964-c36f66b406f4',
});

console.log(response.content);

主要响应字段：

```
response.content
```

Create an assistant test

创建助手测试

Test creation is the main validation path for production assistant behavior before deployment.

client.ai.assistants.tests.create()

—

POST /ai/assistants/tests

Parameter	Type	Required	Description
`name`	string	Yes	A descriptive name for the assistant test.
`destination`	string	Yes	The target destination for the test conversation.
`instructions`	string	Yes	Detailed instructions that define the test scenario and what...
`rubric`	array[object]	Yes	Evaluation criteria used to assess the assistant's performan...
`description`	string	No	Optional detailed description of what this test evaluates an...
`telnyxConversationChannel`	object	No	The communication channel through which the test will be con...
`maxDurationSeconds`	integer	No	Maximum duration in seconds that the test conversation shoul...
...			+1 optional params in references/api-details.md

javascript

const assistantTest = await client.ai.assistants.tests.create({
  destination: '+15551234567',
  instructions:
    'Act as a frustrated customer who received a damaged product. Ask for a refund and escalate if not satisfied with the initial response.',
  name: 'Customer Support Bot Test',
  rubric: [
    { criteria: 'Assistant responds within 30 seconds', name: 'Response Time' },
    { criteria: 'Provides correct product information', name: 'Accuracy' },
  ],
});

console.log(assistantTest.test_id);

Primary response fields:

```
assistantTest.testId
```
```
assistantTest.name
```
```
assistantTest.destination
```
```
assistantTest.createdAt
```
```
assistantTest.instructions
```
```
assistantTest.description
```

创建测试是生产环境助手行为上线前的主要校验路径。

client.ai.assistants.tests.create()

—

POST /ai/assistants/tests

参数	类型	必填	描述
`name`	string	是	助手测试的描述性名称。
`destination`	string	是	测试会话的目标接收方。
`instructions`	string	是	定义测试场景和规则的详细指令...
`rubric`	array[object]	是	评估助手表现的评分标准...
`description`	string	否	可选的详细描述，说明该测试评估的内容...
`telnyxConversationChannel`	object	否	执行测试的通信渠道...
`maxDurationSeconds`	integer	否	测试会话允许的最长持续时间（秒）...
...			还有1个可选参数见references/api-details.md

javascript

const assistantTest = await client.ai.assistants.tests.create({
  destination: '+15551234567',
  instructions:
    'Act as a frustrated customer who received a damaged product. Ask for a refund and escalate if not satisfied with the initial response.',
  name: 'Customer Support Bot Test',
  rubric: [
    { criteria: 'Assistant responds within 30 seconds', name: 'Response Time' },
    { criteria: 'Provides correct product information', name: 'Accuracy' },
  ],
});

console.log(assistantTest.test_id);

主要响应字段：

```
assistantTest.testId
```
```
assistantTest.name
```
```
assistantTest.destination
```
```
assistantTest.createdAt
```
```
assistantTest.instructions
```
```
assistantTest.description
```

Important Supporting Operations

重要支持操作

Use these when the core tasks above are close to your flow, but you need a common variation or follow-up step.

当上述核心任务与你的流程接近，但你需要常用的变体操作或后续步骤时，可以使用这些接口。

Get an assistant

获取助手信息

Fetch the current state before updating, deleting, or making control-flow decisions.

client.ai.assistants.retrieve()

—

GET /ai/assistants/{assistant_id}

Parameter	Type	Required	Description
`assistantId`	string (UUID)	Yes
`callControlId`	string (UUID)	No
`fetchDynamicVariablesFromWebhook`	boolean	No
`from`	string (E.164)	No
...			+1 optional params in references/api-details.md

javascript

const assistant = await client.ai.assistants.retrieve('550e8400-e29b-41d4-a716-446655440000');

console.log(assistant.id);

Primary response fields:

```
assistant.id
```
```
assistant.name
```
```
assistant.createdAt
```
```
assistant.description
```
```
assistant.dynamicVariables
```
```
assistant.dynamicVariablesWebhookUrl
```

在更新、删除助手或做控制流决策前，先获取当前的助手状态。

client.ai.assistants.retrieve()

—

GET /ai/assistants/{assistant_id}

参数	类型	必填	描述
`assistantId`	string (UUID)	是
`callControlId`	string (UUID)	否
`fetchDynamicVariablesFromWebhook`	boolean	否
`from`	string (E.164)	否
...			还有1个可选参数见references/api-details.md

javascript

const assistant = await client.ai.assistants.retrieve('550e8400-e29b-41d4-a716-446655440000');

console.log(assistant.id);

主要响应字段：

```
assistant.id
```
```
assistant.name
```
```
assistant.createdAt
```
```
assistant.description
```
```
assistant.dynamicVariables
```
```
assistant.dynamicVariablesWebhookUrl
```

Update an assistant

更新助手

Create or provision an additional resource when the core tasks do not cover this flow.

client.ai.assistants.update()

—

POST /ai/assistants/{assistant_id}

Parameter	Type	Required	Description
`assistantId`	string (UUID)	Yes
`name`	string	No
`model`	string	No	ID of the model to use.
`instructions`	string	No	System instructions for the assistant.
...			+16 optional params in references/api-details.md

javascript

const assistant = await client.ai.assistants.update('550e8400-e29b-41d4-a716-446655440000');

console.log(assistant.id);

Primary response fields:

```
assistant.id
```
```
assistant.name
```
```
assistant.createdAt
```
```
assistant.description
```
```
assistant.dynamicVariables
```
```
assistant.dynamicVariablesWebhookUrl
```

当核心任务未覆盖该流程时，用于创建或配置额外资源。

client.ai.assistants.update()

—

POST /ai/assistants/{assistant_id}

参数	类型	必填	描述
`assistantId`	string (UUID)	是
`name`	string	否
`model`	string	否	要使用的模型ID。
`instructions`	string	否	助手的系统指令。
...			还有16个可选参数见references/api-details.md

javascript

const assistant = await client.ai.assistants.update('550e8400-e29b-41d4-a716-446655440000');

console.log(assistant.id);

主要响应字段：

```
assistant.id
```
```
assistant.name
```
```
assistant.createdAt
```
```
assistant.description
```
```
assistant.dynamicVariables
```
```
assistant.dynamicVariablesWebhookUrl
```

List assistants

列出助手

Inspect available resources or choose an existing resource before mutating it.

client.ai.assistants.list()

—

GET /ai/assistants

javascript

const assistantsList = await client.ai.assistants.list();

console.log(assistantsList.data);

Response wrapper:

items:
```
assistantsList.data
```

Primary item fields:

```
id
```
```
name
```
```
createdAt
```
```
description
```
```
dynamicVariables
```
```
dynamicVariablesWebhookUrl
```

在修改资源前，查看可用资源或选择现有资源。

client.ai.assistants.list()

—

GET /ai/assistants

javascript

const assistantsList = await client.ai.assistants.list();

console.log(assistantsList.data);

响应包装：

条目:
```
assistantsList.data
```

主要条目字段：

```
id
```
```
name
```
```
createdAt
```
```
description
```
```
dynamicVariables
```
```
dynamicVariablesWebhookUrl
```

Import assistants from external provider

从外部服务商导入助手

Import existing assistants from an external provider instead of creating from scratch.

client.ai.assistants.imports()

—

POST /ai/assistants/import

Parameter	Type	Required	Description
`provider`	enum (elevenlabs, vapi, retell)	Yes	The external provider to import assistants from.
`apiKeyRef`	string	Yes	Integration secret pointer that refers to the API key for th...
`importIds`	array[string]	No	Optional list of assistant IDs to import from the external p...

javascript

const assistantsList = await client.ai.assistants.imports({
  api_key_ref: 'api_key_ref',
  provider: 'elevenlabs',
});

console.log(assistantsList.data);

Response wrapper:

items:
```
assistantsList.data
```

Primary item fields:

```
id
```
```
name
```
```
createdAt
```
```
description
```
```
dynamicVariables
```
```
dynamicVariablesWebhookUrl
```

从外部服务商导入已有的助手，无需从零创建。

client.ai.assistants.imports()

—

POST /ai/assistants/import

参数	类型	必填	描述
`provider`	enum (elevenlabs, vapi, retell)	是	要导入助手的外部服务商。
`apiKeyRef`	string	是	指向服务商API密钥的集成密钥指针...
`importIds`	array[string]	否	可选的要从外部服务商导入的助手ID列表...

javascript

const assistantsList = await client.ai.assistants.imports({
  api_key_ref: 'api_key_ref',
  provider: 'elevenlabs',
});

console.log(assistantsList.data);

响应包装：

条目:
```
assistantsList.data
```

主要条目字段：

```
id
```
```
name
```
```
createdAt
```
```
description
```
```
dynamicVariables
```
```
dynamicVariablesWebhookUrl
```

Get All Tags

获取所有标签

Inspect available resources or choose an existing resource before mutating it.

client.ai.assistants.tags.list()

—

GET /ai/assistants/tags

javascript

const tags = await client.ai.assistants.tags.list();

console.log(tags.tags);

Primary response fields:

```
tags.tags
```

在修改资源前，查看可用资源或选择现有资源。

client.ai.assistants.tags.list()

—

GET /ai/assistants/tags

javascript

const tags = await client.ai.assistants.tags.list();

console.log(tags.tags);

主要响应字段：

```
tags.tags
```

List assistant tests with pagination

分页列出助手测试

Inspect available resources or choose an existing resource before mutating it.

client.ai.assistants.tests.list()

—

GET /ai/assistants/tests

Parameter	Type	Required	Description
`testSuite`	string	No	Filter tests by test suite name
`telnyxConversationChannel`	string	No	Filter tests by communication channel (e.g., 'web_chat', 'sm...
`destination`	string	No	Filter tests by destination (phone number, webhook URL, etc....
...			+1 optional params in references/api-details.md

javascript

// Automatically fetches more pages as needed.
for await (const assistantTest of client.ai.assistants.tests.list()) {
  console.log(assistantTest.test_id);
}

Response wrapper:

items:
```
assistantTest.data
```
pagination:
```
assistantTest.meta
```

Primary item fields:

```
name
```
```
createdAt
```
```
description
```
```
destination
```
```
instructions
```
```
maxDurationSeconds
```

在修改资源前，查看可用资源或选择现有资源。

client.ai.assistants.tests.list()

—

GET /ai/assistants/tests

参数	类型	必填	描述
`testSuite`	string	否	按测试套件名称筛选测试
`telnyxConversationChannel`	string	否	按通信渠道筛选测试（例如'web_chat'、'sm...
`destination`	string	否	按接收方筛选测试（电话号码、webhook URL等...
...			还有1个可选参数见references/api-details.md

javascript

// Automatically fetches more pages as needed.
for await (const assistantTest of client.ai.assistants.tests.list()) {
  console.log(assistantTest.test_id);
}

响应包装：

条目:
```
assistantTest.data
```
分页信息:
```
assistantTest.meta
```

主要条目字段：

```
name
```
```
createdAt
```
```
description
```
```
destination
```
```
instructions
```
```
maxDurationSeconds
```

Get all test suite names

获取所有测试套件名称

Inspect available resources or choose an existing resource before mutating it.

client.ai.assistants.tests.testSuites.list()

—

GET /ai/assistants/tests/test-suites

javascript

const testSuites = await client.ai.assistants.tests.testSuites.list();

console.log(testSuites.data);

Response wrapper:

items:
```
testSuites.data
```

Primary item fields:

```
data
```

在修改资源前，查看可用资源或选择现有资源。

client.ai.assistants.tests.testSuites.list()

—

GET /ai/assistants/tests/test-suites

javascript

const testSuites = await client.ai.assistants.tests.testSuites.list();

console.log(testSuites.data);

响应包装：

条目:
```
testSuites.data
```

主要条目字段：

```
data
```

Get test suite run history

获取测试套件运行历史

Fetch the current state before updating, deleting, or making control-flow decisions.

client.ai.assistants.tests.testSuites.runs.list()

—

GET /ai/assistants/tests/test-suites/{suite_name}/runs

Parameter	Type	Required	Description
`suiteName`	string	Yes
`testSuiteRunId`	string (UUID)	No	Filter runs by specific suite execution batch ID
`status`	string	No	Filter runs by execution status (pending, running, completed...
`page`	object	No	Consolidated page parameter (deepObject style).

javascript

// Automatically fetches more pages as needed.
for await (const testRunResponse of client.ai.assistants.tests.testSuites.runs.list('suite_name')) {
  console.log(testRunResponse.run_id);
}

Response wrapper:

items:
```
testRunResponse.data
```
pagination:
```
testRunResponse.meta
```

Primary item fields:

```
status
```
```
createdAt
```
```
updatedAt
```
```
completedAt
```
```
conversationId
```
```
conversationInsightsId
```

在更新、删除资源或做控制流决策前，先获取当前状态。

client.ai.assistants.tests.testSuites.runs.list()

—

GET /ai/assistants/tests/test-suites/{suite_name}/runs

参数	类型	必填	描述
`suiteName`	string	是
`testSuiteRunId`	string (UUID)	否	按特定套件执行批次ID筛选运行记录
`status`	string	否	按执行状态筛选运行记录（pending、running、completed...
`page`	object	否	统一分页参数（deepObject格式）。

javascript

// Automatically fetches more pages as needed.
for await (const testRunResponse of client.ai.assistants.tests.testSuites.runs.list('suite_name')) {
  console.log(testRunResponse.run_id);
}

响应包装：

条目:
```
testRunResponse.data
```
分页信息:
```
testRunResponse.meta
```

主要条目字段：

```
status
```
```
createdAt
```
```
updatedAt
```
```
completedAt
```
```
conversationId
```
```
conversationInsightsId
```

Additional Operations

额外操作

Use the core tasks above first. The operations below are indexed here with exact SDK methods and required params; use references/api-details.md for full optional params, response schemas, and lower-frequency webhook payloads. Before using any operation below, read the optional-parameters section and the response-schemas section so you do not guess missing fields.

Operation	SDK method	Endpoint	Use when	Required params
Trigger test suite execution	`client.ai.assistants.tests.testSuites.runs.trigger()`	`POST /ai/assistants/tests/test-suites/{suite_name}/runs`	Trigger a follow-up action in an existing workflow rather than creating a new top-level resource.	`suiteName`
Get assistant test by ID	`client.ai.assistants.tests.retrieve()`	`GET /ai/assistants/tests/{test_id}`	Fetch the current state before updating, deleting, or making control-flow decisions.	`testId`
Update an assistant test	`client.ai.assistants.tests.update()`	`PUT /ai/assistants/tests/{test_id}`	Modify an existing resource without recreating it.	`testId`
Delete an assistant test	`client.ai.assistants.tests.delete()`	`DELETE /ai/assistants/tests/{test_id}`	Remove, detach, or clean up an existing resource.	`testId`
Get test run history for a specific test	`client.ai.assistants.tests.runs.list()`	`GET /ai/assistants/tests/{test_id}/runs`	Fetch the current state before updating, deleting, or making control-flow decisions.	`testId`
Trigger a manual test run	`client.ai.assistants.tests.runs.trigger()`	`POST /ai/assistants/tests/{test_id}/runs`	Trigger a follow-up action in an existing workflow rather than creating a new top-level resource.	`testId`
Get specific test run details	`client.ai.assistants.tests.runs.retrieve()`	`GET /ai/assistants/tests/{test_id}/runs/{run_id}`	Fetch the current state before updating, deleting, or making control-flow decisions.	`testId` , `runId`
Delete an assistant	`client.ai.assistants.delete()`	`DELETE /ai/assistants/{assistant_id}`	Remove, detach, or clean up an existing resource.	`assistantId`
Get Canary Deploy	`client.ai.assistants.canaryDeploys.retrieve()`	`GET /ai/assistants/{assistant_id}/canary-deploys`	Fetch the current state before updating, deleting, or making control-flow decisions.	`assistantId`
Create Canary Deploy	`client.ai.assistants.canaryDeploys.create()`	`POST /ai/assistants/{assistant_id}/canary-deploys`	Create or provision an additional resource when the core tasks do not cover this flow.	`versions` , `assistantId`
Update Canary Deploy	`client.ai.assistants.canaryDeploys.update()`	`PUT /ai/assistants/{assistant_id}/canary-deploys`	Modify an existing resource without recreating it.	`versions` , `assistantId`
Delete Canary Deploy	`client.ai.assistants.canaryDeploys.delete()`	`DELETE /ai/assistants/{assistant_id}/canary-deploys`	Remove, detach, or clean up an existing resource.	`assistantId`
Assistant Sms Chat	`client.ai.assistants.sendSMS()`	`POST /ai/assistants/{assistant_id}/chat/sms`	Run assistant chat over SMS instead of direct API chat.	`from` , `to` , `assistantId`
Clone Assistant	`client.ai.assistants.clone()`	`POST /ai/assistants/{assistant_id}/clone`	Trigger a follow-up action in an existing workflow rather than creating a new top-level resource.	`assistantId`
List scheduled events	`client.ai.assistants.scheduledEvents.list()`	`GET /ai/assistants/{assistant_id}/scheduled_events`	Fetch the current state before updating, deleting, or making control-flow decisions.	`assistantId`
Create a scheduled event	`client.ai.assistants.scheduledEvents.create()`	`POST /ai/assistants/{assistant_id}/scheduled_events`	Create or provision an additional resource when the core tasks do not cover this flow.	`telnyxConversationChannel` , `telnyxEndUserTarget` , `telnyxAgentTarget` , `scheduledAtFixedDatetime` , +1 more
Get a scheduled event	`client.ai.assistants.scheduledEvents.retrieve()`	`GET /ai/assistants/{assistant_id}/scheduled_events/{event_id}`	Fetch the current state before updating, deleting, or making control-flow decisions.	`assistantId` , `eventId`
Delete a scheduled event	`client.ai.assistants.scheduledEvents.delete()`	`DELETE /ai/assistants/{assistant_id}/scheduled_events/{event_id}`	Remove, detach, or clean up an existing resource.	`assistantId` , `eventId`
Add Assistant Tag	`client.ai.assistants.tags.add()`	`POST /ai/assistants/{assistant_id}/tags`	Create or provision an additional resource when the core tasks do not cover this flow.	`tag` , `assistantId`
Remove Assistant Tag	`client.ai.assistants.tags.remove()`	`DELETE /ai/assistants/{assistant_id}/tags/{tag}`	Remove, detach, or clean up an existing resource.	`assistantId` , `tag`
Get assistant texml	`client.ai.assistants.getTexml()`	`GET /ai/assistants/{assistant_id}/texml`	Fetch the current state before updating, deleting, or making control-flow decisions.	`assistantId`
Add Assistant Tool	`client.ai.assistants.tools.add()`	`PUT /ai/assistants/{assistant_id}/tools/{tool_id}`	Modify an existing resource without recreating it.	`assistantId` , `toolId`
Remove Assistant Tool	`client.ai.assistants.tools.remove()`	`DELETE /ai/assistants/{assistant_id}/tools/{tool_id}`	Remove, detach, or clean up an existing resource.	`assistantId` , `toolId`
Test Assistant Tool	`client.ai.assistants.tools.test()`	`POST /ai/assistants/{assistant_id}/tools/{tool_id}/test`	Trigger a follow-up action in an existing workflow rather than creating a new top-level resource.	`assistantId` , `toolId`
Get all versions of an assistant	`client.ai.assistants.versions.list()`	`GET /ai/assistants/{assistant_id}/versions`	Fetch the current state before updating, deleting, or making control-flow decisions.	`assistantId`
Get a specific assistant version	`client.ai.assistants.versions.retrieve()`	`GET /ai/assistants/{assistant_id}/versions/{version_id}`	Fetch the current state before updating, deleting, or making control-flow decisions.	`assistantId` , `versionId`
Update a specific assistant version	`client.ai.assistants.versions.update()`	`POST /ai/assistants/{assistant_id}/versions/{version_id}`	Create or provision an additional resource when the core tasks do not cover this flow.	`assistantId` , `versionId`
Delete a specific assistant version	`client.ai.assistants.versions.delete()`	`DELETE /ai/assistants/{assistant_id}/versions/{version_id}`	Remove, detach, or clean up an existing resource.	`assistantId` , `versionId`
Promote an assistant version to main	`client.ai.assistants.versions.promote()`	`POST /ai/assistants/{assistant_id}/versions/{version_id}/promote`	Trigger a follow-up action in an existing workflow rather than creating a new top-level resource.	`assistantId` , `versionId`
List MCP Servers	`client.ai.mcpServers.list()`	`GET /ai/mcp_servers`	Inspect available resources or choose an existing resource before mutating it.	None
Create MCP Server	`client.ai.mcpServers.create()`	`POST /ai/mcp_servers`	Create or provision an additional resource when the core tasks do not cover this flow.	`name` , `type` , `url`
Get MCP Server	`client.ai.mcpServers.retrieve()`	`GET /ai/mcp_servers/{mcp_server_id}`	Fetch the current state before updating, deleting, or making control-flow decisions.	`mcpServerId`
Update MCP Server	`client.ai.mcpServers.update()`	`PUT /ai/mcp_servers/{mcp_server_id}`	Modify an existing resource without recreating it.	`mcpServerId`
Delete MCP Server	`client.ai.mcpServers.delete()`	`DELETE /ai/mcp_servers/{mcp_server_id}`	Remove, detach, or clean up an existing resource.	`mcpServerId`
List Tools	`client.ai.tools.list()`	`GET /ai/tools`	Inspect available resources or choose an existing resource before mutating it.	None
Create Tool	`client.ai.tools.create()`	`POST /ai/tools`	Create or provision an additional resource when the core tasks do not cover this flow.	`type` , `displayName`
Get Tool	`client.ai.tools.retrieve()`	`GET /ai/tools/{tool_id}`	Fetch the current state before updating, deleting, or making control-flow decisions.	`toolId`
Update Tool	`client.ai.tools.update()`	`PATCH /ai/tools/{tool_id}`	Modify an existing resource without recreating it.	`toolId`
Delete Tool	`client.ai.tools.delete()`	`DELETE /ai/tools/{tool_id}`	Remove, detach, or clean up an existing resource.	`toolId`

For exhaustive optional parameters, full response schemas, and complete webhook payloads, see references/api-details.md.

请优先使用上述核心任务。此处列出的操作提供了准确的SDK方法和必填参数；完整的可选参数、响应格式和低频率webhook payload请参考references/api-details.md。在使用下方任意操作前，请先阅读可选参数章节和响应格式章节，不要猜测缺失的字段。

操作	SDK方法	端点	适用场景	必填参数
触发测试套件执行	`client.ai.assistants.tests.testSuites.runs.trigger()`	`POST /ai/assistants/tests/test-suites/{suite_name}/runs`	在现有工作流中触发后续操作，而非创建新的顶层资源。	`suiteName`
根据ID获取助手测试	`client.ai.assistants.tests.retrieve()`	`GET /ai/assistants/tests/{test_id}`	在更新、删除资源或做控制流决策前，先获取当前状态。	`testId`
更新助手测试	`client.ai.assistants.tests.update()`	`PUT /ai/assistants/tests/{test_id}`	修改现有资源，无需重新创建。	`testId`
删除助手测试	`client.ai.assistants.tests.delete()`	`DELETE /ai/assistants/tests/{test_id}`	移除、解绑或清理现有资源。	`testId`
获取特定测试的运行历史	`client.ai.assistants.tests.runs.list()`	`GET /ai/assistants/tests/{test_id}/runs`	在更新、删除资源或做控制流决策前，先获取当前状态。	`testId`
触发手动测试运行	`client.ai.assistants.tests.runs.trigger()`	`POST /ai/assistants/tests/{test_id}/runs`	在现有工作流中触发后续操作，而非创建新的顶层资源。	`testId`
获取特定测试运行详情	`client.ai.assistants.tests.runs.retrieve()`	`GET /ai/assistants/tests/{test_id}/runs/{run_id}`	在更新、删除资源或做控制流决策前，先获取当前状态。	`testId` , `runId`
删除助手	`client.ai.assistants.delete()`	`DELETE /ai/assistants/{assistant_id}`	移除、解绑或清理现有资源。	`assistantId`
获取灰度发布配置	`client.ai.assistants.canaryDeploys.retrieve()`	`GET /ai/assistants/{assistant_id}/canary-deploys`	在更新、删除资源或做控制流决策前，先获取当前状态。	`assistantId`
创建灰度发布配置	`client.ai.assistants.canaryDeploys.create()`	`POST /ai/assistants/{assistant_id}/canary-deploys`	当核心任务未覆盖该流程时，用于创建或配置额外资源。	`versions` , `assistantId`
更新灰度发布配置	`client.ai.assistants.canaryDeploys.update()`	`PUT /ai/assistants/{assistant_id}/canary-deploys`	修改现有资源，无需重新创建。	`versions` , `assistantId`
删除灰度发布配置	`client.ai.assistants.canaryDeploys.delete()`	`DELETE /ai/assistants/{assistant_id}/canary-deploys`	移除、解绑或清理现有资源。	`assistantId`
助手短信对话	`client.ai.assistants.sendSMS()`	`POST /ai/assistants/{assistant_id}/chat/sms`	通过SMS运行助手对话，而非直接调用API对话。	`from` , `to` , `assistantId`
克隆助手	`client.ai.assistants.clone()`	`POST /ai/assistants/{assistant_id}/clone`	在现有工作流中触发后续操作，而非创建新的顶层资源。	`assistantId`
列出定时事件	`client.ai.assistants.scheduledEvents.list()`	`GET /ai/assistants/{assistant_id}/scheduled_events`	在更新、删除资源或做控制流决策前，先获取当前状态。	`assistantId`
创建定时事件	`client.ai.assistants.scheduledEvents.create()`	`POST /ai/assistants/{assistant_id}/scheduled_events`	当核心任务未覆盖该流程时，用于创建或配置额外资源。	`telnyxConversationChannel` , `telnyxEndUserTarget` , `telnyxAgentTarget` , `scheduledAtFixedDatetime` , +1 more
获取定时事件	`client.ai.assistants.scheduledEvents.retrieve()`	`GET /ai/assistants/{assistant_id}/scheduled_events/{event_id}`	在更新、删除资源或做控制流决策前，先获取当前状态。	`assistantId` , `eventId`
删除定时事件	`client.ai.assistants.scheduledEvents.delete()`	`DELETE /ai/assistants/{assistant_id}/scheduled_events/{event_id}`	移除、解绑或清理现有资源。	`assistantId` , `eventId`
添加助手标签	`client.ai.assistants.tags.add()`	`POST /ai/assistants/{assistant_id}/tags`	当核心任务未覆盖该流程时，用于创建或配置额外资源。	`tag` , `assistantId`
移除助手标签	`client.ai.assistants.tags.remove()`	`DELETE /ai/assistants/{assistant_id}/tags/{tag}`	移除、解绑或清理现有资源。	`assistantId` , `tag`
获取助手Texml	`client.ai.assistants.getTexml()`	`GET /ai/assistants/{assistant_id}/texml`	在更新、删除资源或做控制流决策前，先获取当前状态。	`assistantId`
添加助手工具	`client.ai.assistants.tools.add()`	`PUT /ai/assistants/{assistant_id}/tools/{tool_id}`	修改现有资源，无需重新创建。	`assistantId` , `toolId`
移除助手工具	`client.ai.assistants.tools.remove()`	`DELETE /ai/assistants/{assistant_id}/tools/{tool_id}`	移除、解绑或清理现有资源。	`assistantId` , `toolId`
测试助手工具	`client.ai.assistants.tools.test()`	`POST /ai/assistants/{assistant_id}/tools/{tool_id}/test`	在现有工作流中触发后续操作，而非创建新的顶层资源。	`assistantId` , `toolId`
获取助手所有版本	`client.ai.assistants.versions.list()`	`GET /ai/assistants/{assistant_id}/versions`	在更新、删除资源或做控制流决策前，先获取当前状态。	`assistantId`
获取特定助手版本	`client.ai.assistants.versions.retrieve()`	`GET /ai/assistants/{assistant_id}/versions/{version_id}`	在更新、删除资源或做控制流决策前，先获取当前状态。	`assistantId` , `versionId`
更新特定助手版本	`client.ai.assistants.versions.update()`	`POST /ai/assistants/{assistant_id}/versions/{version_id}`	当核心任务未覆盖该流程时，用于创建或配置额外资源。	`assistantId` , `versionId`
删除特定助手版本	`client.ai.assistants.versions.delete()`	`DELETE /ai/assistants/{assistant_id}/versions/{version_id}`	移除、解绑或清理现有资源。	`assistantId` , `versionId`
将助手版本升级为正式版	`client.ai.assistants.versions.promote()`	`POST /ai/assistants/{assistant_id}/versions/{version_id}/promote`	在现有工作流中触发后续操作，而非创建新的顶层资源。	`assistantId` , `versionId`
列出MCP服务器	`client.ai.mcpServers.list()`	`GET /ai/mcp_servers`	在修改资源前，查看可用资源或选择现有资源。	无
创建MCP服务器	`client.ai.mcpServers.create()`	`POST /ai/mcp_servers`	当核心任务未覆盖该流程时，用于创建或配置额外资源。	`name` , `type` , `url`
获取MCP服务器	`client.ai.mcpServers.retrieve()`	`GET /ai/mcp_servers/{mcp_server_id}`	在更新、删除资源或做控制流决策前，先获取当前状态。	`mcpServerId`
更新MCP服务器	`client.ai.mcpServers.update()`	`PUT /ai/mcp_servers/{mcp_server_id}`	修改现有资源，无需重新创建。	`mcpServerId`
删除MCP服务器	`client.ai.mcpServers.delete()`	`DELETE /ai/mcp_servers/{mcp_server_id}`	移除、解绑或清理现有资源。	`mcpServerId`
列出工具	`client.ai.tools.list()`	`GET /ai/tools`	在修改资源前，查看可用资源或选择现有资源。	无
创建工具	`client.ai.tools.create()`	`POST /ai/tools`	当核心任务未覆盖该流程时，用于创建或配置额外资源。	`type` , `displayName`
获取工具	`client.ai.tools.retrieve()`	`GET /ai/tools/{tool_id}`	在更新、删除资源或做控制流决策前，先获取当前状态。	`toolId`
更新工具	`client.ai.tools.update()`	`PATCH /ai/tools/{tool_id}`	修改现有资源，无需重新创建。	`toolId`
删除工具	`client.ai.tools.delete()`	`DELETE /ai/tools/{tool_id}`	移除、解绑或清理现有资源。	`toolId`

如需完整的可选参数、全量响应格式和所有webhook payload，请查看references/api-details.md。