Back to Details

telnyx-missions-go

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->
<!-- 自动从 Telnyx OpenAPI 规范生成，请勿编辑。 -->

Telnyx Missions - Go

Telnyx Missions - Go

Installation

安装

bash
go get github.com/team-telnyx/telnyx-go
bash
go get github.com/team-telnyx/telnyx-go

Setup

环境配置

go
import (
  "context"
  "fmt"
  "os"

  "github.com/team-telnyx/telnyx-go"
  "github.com/team-telnyx/telnyx-go/option"
)

client := telnyx.NewClient(
  option.WithAPIKey(os.Getenv("TELNYX_API_KEY")),
)
All examples below assume 
client
is already initialized as shown above.
go
import (
  "context"
  "fmt"
  "os"

  "github.com/team-telnyx/telnyx-go"
  "github.com/team-telnyx/telnyx-go/option"
)

client := telnyx.NewClient(
  option.WithAPIKey(os.Getenv("TELNYX_API_KEY")),
)
以下所有示例均默认
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:
go
import "errors"

result, err := client.Messages.Send(ctx, params)
if err != nil {
  var apiErr *telnyx.Error
  if errors.As(err, &apiErr) {
    switch apiErr.StatusCode {
    case 422:
      fmt.Println("Validation error — check required fields and formats")
    case 429:
      // Rate limited — wait and retry with exponential backoff
      fmt.Println("Rate limited, retrying...")
    default:
      fmt.Printf("API error %d: %s\n", apiErr.StatusCode, apiErr.Error())
    }
  } else {
    fmt.Println("Network error — check connectivity and retry")
  }
}
Common error codes: 
401
invalid API key, 
403
insufficient permissions, 
404
resource not found, 
422
validation error (check field formats), 
429
rate limited (retry with exponential backoff).
所有API调用都可能遇到网络错误、速率限制(429)、校验错误(422)或身份认证错误(401)。在生产代码中请务必做好错误处理：
go
import "errors"

result, err := client.Messages.Send(ctx, params)
if err != nil {
  var apiErr *telnyx.Error
  if errors.As(err, &apiErr) {
    switch apiErr.StatusCode {
    case 422:
      fmt.Println("Validation error — check required fields and formats")
    case 429:
      // Rate limited — wait and retry with exponential backoff
      fmt.Println("Rate limited, retrying...")
    default:
      fmt.Printf("API error %d: %s\n", apiErr.StatusCode, apiErr.Error())
    }
  } else {
    fmt.Println("Network error — check connectivity and retry")
  }
}
常见错误码：
401
API密钥无效，
403
权限不足，
404
资源不存在，
422
校验错误（请检查字段格式），
429
触发速率限制（请使用指数退避策略重试）。

Important Notes

重要说明

  • Pagination: Use 
    ListAutoPaging()
    for automatic iteration: 
    iter := client.Resource.ListAutoPaging(ctx, params); for iter.Next() { item := iter.Current() }
    .
  • 分页： 使用
    ListAutoPaging()
    可实现自动迭代：
    iter := client.Resource.ListAutoPaging(ctx, params); for iter.Next() { item := iter.Current() }
    .

List missions

列出Missions

List all missions for the organization
GET /ai/missions
go
	page, err := client.AI.Missions.List(context.Background(), telnyx.AIMissionListParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
Returns: 
created_at
(date-time), 
description
(string), 
execution_mode
(enum: external, managed), 
instructions
(string), 
metadata
(object), 
mission_id
(uuid), 
model
(string), 
name
(string), 
updated_at
(date-time)
列出当前组织下的所有missions
GET /ai/missions
go
	page, err := client.AI.Missions.List(context.Background(), telnyx.AIMissionListParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
返回值：
created_at
（日期时间）、
description
（字符串）、
execution_mode
（枚举值：external, managed）、
instructions
（字符串）、
metadata
（对象）、
mission_id
（UUID）、
model
（字符串）、
name
（字符串）、
updated_at
（日期时间）

Create mission

创建Mission

Create a new mission definition
POST /ai/missions
— Required: 
name
Optional: 
description
(string), 
execution_mode
(enum: external, managed), 
instructions
(string), 
metadata
(object), 
model
(string)
go
	mission, err := client.AI.Missions.New(context.Background(), telnyx.AIMissionNewParams{
		Name: "my-resource",
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", mission.Data)
Returns: 
created_at
(date-time), 
description
(string), 
execution_mode
(enum: external, managed), 
instructions
(string), 
metadata
(object), 
mission_id
(uuid), 
model
(string), 
name
(string), 
updated_at
(date-time)
创建新的mission定义
POST /ai/missions
— 必填参数：
name
可选参数：
description
（字符串）、
execution_mode
（枚举值：external, managed）、
instructions
（字符串）、
metadata
（对象）、
model
（字符串）
go
	mission, err := client.AI.Missions.New(context.Background(), telnyx.AIMissionNewParams{
		Name: "my-resource",
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", mission.Data)
返回值：
created_at
（日期时间）、
description
（字符串）、
execution_mode
（枚举值：external, managed）、
instructions
（字符串）、
metadata
（对象）、
mission_id
（UUID）、
model
（字符串）、
name
（字符串）、
updated_at
（日期时间）

List recent events

列出最近事件

List recent events across all missions
GET /ai/missions/events
go
	page, err := client.AI.Missions.ListEvents(context.Background(), telnyx.AIMissionListEventsParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
Returns: 
agent_id
(string), 
event_id
(string), 
idempotency_key
(string), 
payload
(object), 
run_id
(string), 
step_id
(string), 
summary
(string), 
timestamp
(date-time), 
type
(enum: status_change, step_started, step_completed, step_failed, tool_call, tool_result, message, error, custom)
列出所有mission的最近事件
GET /ai/missions/events
go
	page, err := client.AI.Missions.ListEvents(context.Background(), telnyx.AIMissionListEventsParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
返回值：
agent_id
（字符串）、
event_id
（字符串）、
idempotency_key
（字符串）、
payload
（对象）、
run_id
（字符串）、
step_id
（字符串）、
summary
（字符串）、
timestamp
（日期时间）、
type
（枚举值：status_change, step_started, step_completed, step_failed, tool_call, tool_result, message, error, custom）

List recent runs

列出最近运行记录

List recent runs across all missions
GET /ai/missions/runs
go
	page, err := client.AI.Missions.Runs.ListRuns(context.Background(), telnyx.AIMissionRunListRunsParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
Returns: 
error
(string), 
finished_at
(date-time), 
input
(object), 
metadata
(object), 
mission_id
(uuid), 
result_payload
(object), 
result_summary
(string), 
run_id
(uuid), 
started_at
(date-time), 
status
(enum: pending, running, paused, succeeded, failed, cancelled), 
updated_at
(date-time)
列出所有mission的最近运行记录
GET /ai/missions/runs
go
	page, err := client.AI.Missions.Runs.ListRuns(context.Background(), telnyx.AIMissionRunListRunsParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
返回值：
error
（字符串）、
finished_at
（日期时间）、
input
（对象）、
metadata
（对象）、
mission_id
（UUID）、
result_payload
（对象）、
result_summary
（字符串）、
run_id
（UUID）、
started_at
（日期时间）、
status
（枚举值：pending, running, paused, succeeded, failed, cancelled）、
updated_at
（日期时间）

Get mission

获取Mission详情

Get a mission by ID (includes tools, knowledge_bases, mcp_servers)
GET /ai/missions/{mission_id}
go
	mission, err := client.AI.Missions.Get(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", mission.Data)
Returns: 
created_at
(date-time), 
description
(string), 
execution_mode
(enum: external, managed), 
instructions
(string), 
metadata
(object), 
mission_id
(uuid), 
model
(string), 
name
(string), 
updated_at
(date-time)
通过ID获取mission详情（包含工具、知识库、mcp_servers信息）
GET /ai/missions/{mission_id}
go
	mission, err := client.AI.Missions.Get(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", mission.Data)
返回值：
created_at
（日期时间）、
description
（字符串）、
execution_mode
（枚举值：external, managed）、
instructions
（字符串）、
metadata
（对象）、
mission_id
（UUID）、
model
（字符串）、
name
（字符串）、
updated_at
（日期时间）

Update mission

更新Mission

Update a mission definition
PUT /ai/missions/{mission_id}
Optional: 
description
(string), 
execution_mode
(enum: external, managed), 
instructions
(string), 
metadata
(object), 
model
(string), 
name
(string)
go
	response, err := client.AI.Missions.UpdateMission(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionUpdateMissionParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
created_at
(date-time), 
description
(string), 
execution_mode
(enum: external, managed), 
instructions
(string), 
metadata
(object), 
mission_id
(uuid), 
model
(string), 
name
(string), 
updated_at
(date-time)
更新mission定义
PUT /ai/missions/{mission_id}
可选参数：
description
（字符串）、
execution_mode
（枚举值：external, managed）、
instructions
（字符串）、
metadata
（对象）、
model
（字符串）、
name
（字符串）
go
	response, err := client.AI.Missions.UpdateMission(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionUpdateMissionParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回值：
created_at
（日期时间）、
description
（字符串）、
execution_mode
（枚举值：external, managed）、
instructions
（字符串）、
metadata
（对象）、
mission_id
（UUID）、
model
（字符串）、
name
（字符串）、
updated_at
（日期时间）

Delete mission

删除Mission

Delete a mission
DELETE /ai/missions/{mission_id}
go
	err := client.AI.Missions.DeleteMission(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
	if err != nil {
		log.Fatal(err)
	}
删除指定mission
DELETE /ai/missions/{mission_id}
go
	err := client.AI.Missions.DeleteMission(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
	if err != nil {
		log.Fatal(err)
	}

Clone mission

克隆Mission

Clone an existing mission
POST /ai/missions/{mission_id}/clone
go
	response, err := client.AI.Missions.CloneMission(context.Background(), "mission_id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)
克隆已有的mission
POST /ai/missions/{mission_id}/clone
go
	response, err := client.AI.Missions.CloneMission(context.Background(), "mission_id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)

List knowledge bases

列出知识库

List all knowledge bases for a mission
GET /ai/missions/{mission_id}/knowledge-bases
go
	response, err := client.AI.Missions.KnowledgeBases.ListKnowledgeBases(context.Background(), "mission_id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)
列出指定mission的所有知识库
GET /ai/missions/{mission_id}/knowledge-bases
go
	response, err := client.AI.Missions.KnowledgeBases.ListKnowledgeBases(context.Background(), "mission_id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)

Create knowledge base

创建知识库

Create a new knowledge base for a mission
POST /ai/missions/{mission_id}/knowledge-bases
go
	response, err := client.AI.Missions.KnowledgeBases.NewKnowledgeBase(context.Background(), "mission_id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)
为指定mission创建新的知识库
POST /ai/missions/{mission_id}/knowledge-bases
go
	response, err := client.AI.Missions.KnowledgeBases.NewKnowledgeBase(context.Background(), "mission_id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)

Get knowledge base

获取知识库详情

Get a specific knowledge base by ID
GET /ai/missions/{mission_id}/knowledge-bases/{knowledge_base_id}
go
	response, err := client.AI.Missions.KnowledgeBases.GetKnowledgeBase(
		context.Background(),
		"knowledge_base_id",
		telnyx.AIMissionKnowledgeBaseGetKnowledgeBaseParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)
通过ID获取指定知识库的详情
GET /ai/missions/{mission_id}/knowledge-bases/{knowledge_base_id}
go
	response, err := client.AI.Missions.KnowledgeBases.GetKnowledgeBase(
		context.Background(),
		"knowledge_base_id",
		telnyx.AIMissionKnowledgeBaseGetKnowledgeBaseParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)

Update knowledge base

更新知识库

Update a knowledge base definition
PUT /ai/missions/{mission_id}/knowledge-bases/{knowledge_base_id}
go
	response, err := client.AI.Missions.KnowledgeBases.UpdateKnowledgeBase(
		context.Background(),
		"knowledge_base_id",
		telnyx.AIMissionKnowledgeBaseUpdateKnowledgeBaseParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)
更新知识库定义
PUT /ai/missions/{mission_id}/knowledge-bases/{knowledge_base_id}
go
	response, err := client.AI.Missions.KnowledgeBases.UpdateKnowledgeBase(
		context.Background(),
		"knowledge_base_id",
		telnyx.AIMissionKnowledgeBaseUpdateKnowledgeBaseParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)

Delete knowledge base

删除知识库

Delete a knowledge base from a mission
DELETE /ai/missions/{mission_id}/knowledge-bases/{knowledge_base_id}
go
	err := client.AI.Missions.KnowledgeBases.DeleteKnowledgeBase(
		context.Background(),
		"knowledge_base_id",
		telnyx.AIMissionKnowledgeBaseDeleteKnowledgeBaseParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
从mission中删除指定知识库
DELETE /ai/missions/{mission_id}/knowledge-bases/{knowledge_base_id}
go
	err := client.AI.Missions.KnowledgeBases.DeleteKnowledgeBase(
		context.Background(),
		"knowledge_base_id",
		telnyx.AIMissionKnowledgeBaseDeleteKnowledgeBaseParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}

List MCP servers

列出MCP服务器

List all MCP servers for a mission
GET /ai/missions/{mission_id}/mcp-servers
go
	response, err := client.AI.Missions.McpServers.ListMcpServers(context.Background(), "mission_id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)
列出指定mission的所有MCP服务器
GET /ai/missions/{mission_id}/mcp-servers
go
	response, err := client.AI.Missions.McpServers.ListMcpServers(context.Background(), "mission_id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)

Create MCP server

创建MCP服务器

Create a new MCP server for a mission
POST /ai/missions/{mission_id}/mcp-servers
go
	response, err := client.AI.Missions.McpServers.NewMcpServer(context.Background(), "mission_id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)
为指定mission创建新的MCP服务器
POST /ai/missions/{mission_id}/mcp-servers
go
	response, err := client.AI.Missions.McpServers.NewMcpServer(context.Background(), "mission_id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)

Get MCP server

获取MCP服务器详情

Get a specific MCP server by ID
GET /ai/missions/{mission_id}/mcp-servers/{mcp_server_id}
go
	response, err := client.AI.Missions.McpServers.GetMcpServer(
		context.Background(),
		"mcp_server_id",
		telnyx.AIMissionMcpServerGetMcpServerParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)
通过ID获取指定MCP服务器的详情
GET /ai/missions/{mission_id}/mcp-servers/{mcp_server_id}
go
	response, err := client.AI.Missions.McpServers.GetMcpServer(
		context.Background(),
		"mcp_server_id",
		telnyx.AIMissionMcpServerGetMcpServerParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)

Update MCP server

更新MCP服务器

Update an MCP server definition
PUT /ai/missions/{mission_id}/mcp-servers/{mcp_server_id}
go
	response, err := client.AI.Missions.McpServers.UpdateMcpServer(
		context.Background(),
		"mcp_server_id",
		telnyx.AIMissionMcpServerUpdateMcpServerParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)
更新MCP服务器定义
PUT /ai/missions/{mission_id}/mcp-servers/{mcp_server_id}
go
	response, err := client.AI.Missions.McpServers.UpdateMcpServer(
		context.Background(),
		"mcp_server_id",
		telnyx.AIMissionMcpServerUpdateMcpServerParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)

Delete MCP server

删除MCP服务器

Delete an MCP server from a mission
DELETE /ai/missions/{mission_id}/mcp-servers/{mcp_server_id}
go
	err := client.AI.Missions.McpServers.DeleteMcpServer(
		context.Background(),
		"mcp_server_id",
		telnyx.AIMissionMcpServerDeleteMcpServerParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
从mission中删除指定MCP服务器
DELETE /ai/missions/{mission_id}/mcp-servers/{mcp_server_id}
go
	err := client.AI.Missions.McpServers.DeleteMcpServer(
		context.Background(),
		"mcp_server_id",
		telnyx.AIMissionMcpServerDeleteMcpServerParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}

List runs for mission

列出指定Mission的运行记录

List all runs for a specific mission
GET /ai/missions/{mission_id}/runs
go
	page, err := client.AI.Missions.Runs.List(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunListParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
Returns: 
error
(string), 
finished_at
(date-time), 
input
(object), 
metadata
(object), 
mission_id
(uuid), 
result_payload
(object), 
result_summary
(string), 
run_id
(uuid), 
started_at
(date-time), 
status
(enum: pending, running, paused, succeeded, failed, cancelled), 
updated_at
(date-time)
列出指定mission的所有运行记录
GET /ai/missions/{mission_id}/runs
go
	page, err := client.AI.Missions.Runs.List(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunListParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
返回值：
error
（字符串）、
finished_at
（日期时间）、
input
（对象）、
metadata
（对象）、
mission_id
（UUID）、
result_payload
（对象）、
result_summary
（字符串）、
run_id
（UUID）、
started_at
（日期时间）、
status
（枚举值：pending, running, paused, succeeded, failed, cancelled）、
updated_at
（日期时间）

Start a run

启动一次运行

Start a new run for a mission
POST /ai/missions/{mission_id}/runs
Optional: 
input
(object), 
metadata
(object)
go
	run, err := client.AI.Missions.Runs.New(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunNewParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", run.Data)
Returns: 
error
(string), 
finished_at
(date-time), 
input
(object), 
metadata
(object), 
mission_id
(uuid), 
result_payload
(object), 
result_summary
(string), 
run_id
(uuid), 
started_at
(date-time), 
status
(enum: pending, running, paused, succeeded, failed, cancelled), 
updated_at
(date-time)
为mission启动新的运行任务
POST /ai/missions/{mission_id}/runs
可选参数：
input
（对象）、
metadata
（对象）
go
	run, err := client.AI.Missions.Runs.New(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunNewParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", run.Data)
返回值：
error
（字符串）、
finished_at
（日期时间）、
input
（对象）、
metadata
（对象）、
mission_id
（UUID）、
result_payload
（对象）、
result_summary
（字符串）、
run_id
（UUID）、
started_at
（日期时间）、
status
（枚举值：pending, running, paused, succeeded, failed, cancelled）、
updated_at
（日期时间）

Get run details

获取运行详情

Get details of a specific run
GET /ai/missions/{mission_id}/runs/{run_id}
go
	run, err := client.AI.Missions.Runs.Get(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunGetParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", run.Data)
Returns: 
error
(string), 
finished_at
(date-time), 
input
(object), 
metadata
(object), 
mission_id
(uuid), 
result_payload
(object), 
result_summary
(string), 
run_id
(uuid), 
started_at
(date-time), 
status
(enum: pending, running, paused, succeeded, failed, cancelled), 
updated_at
(date-time)
获取指定运行任务的详情
GET /ai/missions/{mission_id}/runs/{run_id}
go
	run, err := client.AI.Missions.Runs.Get(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunGetParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", run.Data)
返回值：
error
（字符串）、
finished_at
（日期时间）、
input
（对象）、
metadata
（对象）、
mission_id
（UUID）、
result_payload
（对象）、
result_summary
（字符串）、
run_id
（UUID）、
started_at
（日期时间）、
status
（枚举值：pending, running, paused, succeeded, failed, cancelled）、
updated_at
（日期时间）

Update run

更新运行记录

Update run status and/or result
PATCH /ai/missions/{mission_id}/runs/{run_id}
Optional: 
error
(string), 
metadata
(object), 
result_payload
(object), 
result_summary
(string), 
status
(enum: pending, running, paused, succeeded, failed, cancelled)
go
	run, err := client.AI.Missions.Runs.Update(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunUpdateParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", run.Data)
Returns: 
error
(string), 
finished_at
(date-time), 
input
(object), 
metadata
(object), 
mission_id
(uuid), 
result_payload
(object), 
result_summary
(string), 
run_id
(uuid), 
started_at
(date-time), 
status
(enum: pending, running, paused, succeeded, failed, cancelled), 
updated_at
(date-time)
更新运行的状态和/或结果
PATCH /ai/missions/{mission_id}/runs/{run_id}
可选参数：
error
（字符串）、
metadata
（对象）、
result_payload
（对象）、
result_summary
（字符串）、
status
（枚举值：pending, running, paused, succeeded, failed, cancelled）
go
	run, err := client.AI.Missions.Runs.Update(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunUpdateParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", run.Data)
返回值：
error
（字符串）、
finished_at
（日期时间）、
input
（对象）、
metadata
（对象）、
mission_id
（UUID）、
result_payload
（对象）、
result_summary
（字符串）、
run_id
（UUID）、
started_at
（日期时间）、
status
（枚举值：pending, running, paused, succeeded, failed, cancelled）、
updated_at
（日期时间）

Cancel run

取消运行

Cancel a running or paused run
POST /ai/missions/{mission_id}/runs/{run_id}/cancel
go
	response, err := client.AI.Missions.Runs.CancelRun(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunCancelRunParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
error
(string), 
finished_at
(date-time), 
input
(object), 
metadata
(object), 
mission_id
(uuid), 
result_payload
(object), 
result_summary
(string), 
run_id
(uuid), 
started_at
(date-time), 
status
(enum: pending, running, paused, succeeded, failed, cancelled), 
updated_at
(date-time)
取消处于运行中或暂停状态的任务
POST /ai/missions/{mission_id}/runs/{run_id}/cancel
go
	response, err := client.AI.Missions.Runs.CancelRun(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunCancelRunParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回值：
error
（字符串）、
finished_at
（日期时间）、
input
（对象）、
metadata
（对象）、
mission_id
（UUID）、
result_payload
（对象）、
result_summary
（字符串）、
run_id
（UUID）、
started_at
（日期时间）、
status
（枚举值：pending, running, paused, succeeded, failed, cancelled）、
updated_at
（日期时间）

List events

列出事件

List events for a run (paginated)
GET /ai/missions/{mission_id}/runs/{run_id}/events
go
	page, err := client.AI.Missions.Runs.Events.List(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunEventListParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
Returns: 
agent_id
(string), 
event_id
(string), 
idempotency_key
(string), 
payload
(object), 
run_id
(string), 
step_id
(string), 
summary
(string), 
timestamp
(date-time), 
type
(enum: status_change, step_started, step_completed, step_failed, tool_call, tool_result, message, error, custom)
列出指定运行的事件（支持分页）
GET /ai/missions/{mission_id}/runs/{run_id}/events
go
	page, err := client.AI.Missions.Runs.Events.List(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunEventListParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)
返回值：
agent_id
（字符串）、
event_id
（字符串）、
idempotency_key
（字符串）、
payload
（对象）、
run_id
（字符串）、
step_id
（字符串）、
summary
（字符串）、
timestamp
（日期时间）、
type
（枚举值：status_change, step_started, step_completed, step_failed, tool_call, tool_result, message, error, custom）

Log event

记录事件

Log an event for a run
POST /ai/missions/{mission_id}/runs/{run_id}/events
— Required: 
type
, 
summary
Optional: 
agent_id
(string), 
idempotency_key
(string), 
payload
(object), 
step_id
(string)
go
	response, err := client.AI.Missions.Runs.Events.Log(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunEventLogParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			Summary: "Brief task summary",
			Type:      telnyx.AIMissionRunEventLogParamsTypeStatusChange,
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
agent_id
(string), 
event_id
(string), 
idempotency_key
(string), 
payload
(object), 
run_id
(string), 
step_id
(string), 
summary
(string), 
timestamp
(date-time), 
type
(enum: status_change, step_started, step_completed, step_failed, tool_call, tool_result, message, error, custom)
为指定运行记录一条事件
POST /ai/missions/{mission_id}/runs/{run_id}/events
— 必填参数：
type
、
summary
可选参数：
agent_id
（字符串）、
idempotency_key
（字符串）、
payload
（对象）、
step_id
（字符串）
go
	response, err := client.AI.Missions.Runs.Events.Log(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunEventLogParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			Summary: "Brief task summary",
			Type:      telnyx.AIMissionRunEventLogParamsTypeStatusChange,
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回值：
agent_id
（字符串）、
event_id
（字符串）、
idempotency_key
（字符串）、
payload
（对象）、
run_id
（字符串）、
step_id
（字符串）、
summary
（字符串）、
timestamp
（日期时间）、
type
（枚举值：status_change, step_started, step_completed, step_failed, tool_call, tool_result, message, error, custom）

Get event details

获取事件详情

Get details of a specific event
GET /ai/missions/{mission_id}/runs/{run_id}/events/{event_id}
go
	response, err := client.AI.Missions.Runs.Events.GetEventDetails(
		context.Background(),
		"event_id",
		telnyx.AIMissionRunEventGetEventDetailsParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			RunID:     "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
agent_id
(string), 
event_id
(string), 
idempotency_key
(string), 
payload
(object), 
run_id
(string), 
step_id
(string), 
summary
(string), 
timestamp
(date-time), 
type
(enum: status_change, step_started, step_completed, step_failed, tool_call, tool_result, message, error, custom)
获取指定事件的详情
GET /ai/missions/{mission_id}/runs/{run_id}/events/{event_id}
go
	response, err := client.AI.Missions.Runs.Events.GetEventDetails(
		context.Background(),
		"event_id",
		telnyx.AIMissionRunEventGetEventDetailsParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			RunID:     "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回值：
agent_id
（字符串）、
event_id
（字符串）、
idempotency_key
（字符串）、
payload
（对象）、
run_id
（字符串）、
step_id
（字符串）、
summary
（字符串）、
timestamp
（日期时间）、
type
（枚举值：status_change, step_started, step_completed, step_failed, tool_call, tool_result, message, error, custom）

Pause run

暂停运行

Pause a running run
POST /ai/missions/{mission_id}/runs/{run_id}/pause
go
	response, err := client.AI.Missions.Runs.PauseRun(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunPauseRunParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
error
(string), 
finished_at
(date-time), 
input
(object), 
metadata
(object), 
mission_id
(uuid), 
result_payload
(object), 
result_summary
(string), 
run_id
(uuid), 
started_at
(date-time), 
status
(enum: pending, running, paused, succeeded, failed, cancelled), 
updated_at
(date-time)
暂停处于运行中的任务
POST /ai/missions/{mission_id}/runs/{run_id}/pause
go
	response, err := client.AI.Missions.Runs.PauseRun(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunPauseRunParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回值：
error
（字符串）、
finished_at
（日期时间）、
input
（对象）、
metadata
（对象）、
mission_id
（UUID）、
result_payload
（对象）、
result_summary
（字符串）、
run_id
（UUID）、
started_at
（日期时间）、
status
（枚举值：pending, running, paused, succeeded, failed, cancelled）、
updated_at
（日期时间）

Get plan

获取运行计划

Get the plan (all steps) for a run
GET /ai/missions/{mission_id}/runs/{run_id}/plan
go
	plan, err := client.AI.Missions.Runs.Plan.Get(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunPlanGetParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", plan.Data)
Returns: 
completed_at
(date-time), 
description
(string), 
metadata
(object), 
parent_step_id
(string), 
run_id
(uuid), 
sequence
(integer), 
started_at
(date-time), 
status
(enum: pending, in_progress, completed, skipped, failed), 
step_id
(string)
获取指定运行的完整计划（包含所有步骤）
GET /ai/missions/{mission_id}/runs/{run_id}/plan
go
	plan, err := client.AI.Missions.Runs.Plan.Get(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunPlanGetParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", plan.Data)
返回值：
completed_at
（日期时间）、
description
（字符串）、
metadata
（对象）、
parent_step_id
（字符串）、
run_id
（UUID）、
sequence
（整数）、
started_at
（日期时间）、
status
（枚举值：pending, in_progress, completed, skipped, failed）、
step_id
（字符串）

Create initial plan

创建初始运行计划

Create the initial plan for a run
POST /ai/missions/{mission_id}/runs/{run_id}/plan
— Required: 
steps
go
	plan, err := client.AI.Missions.Runs.Plan.New(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunPlanNewParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			Steps: []telnyx.AIMissionRunPlanNewParamsStep{{
				Description: "description",
				Sequence:    0,
				StepID: "550e8400-e29b-41d4-a716-446655440000",
			}},
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", plan.Data)
Returns: 
completed_at
(date-time), 
description
(string), 
metadata
(object), 
parent_step_id
(string), 
run_id
(uuid), 
sequence
(integer), 
started_at
(date-time), 
status
(enum: pending, in_progress, completed, skipped, failed), 
step_id
(string)
为指定运行创建初始计划
POST /ai/missions/{mission_id}/runs/{run_id}/plan
— 必填参数：
steps
go
	plan, err := client.AI.Missions.Runs.Plan.New(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunPlanNewParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			Steps: []telnyx.AIMissionRunPlanNewParamsStep{{
				Description: "description",
				Sequence:    0,
				StepID: "550e8400-e29b-41d4-a716-446655440000",
			}},
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", plan.Data)
返回值：
completed_at
（日期时间）、
description
（字符串）、
metadata
（对象）、
parent_step_id
（字符串）、
run_id
（UUID）、
sequence
（整数）、
started_at
（日期时间）、
status
（枚举值：pending, in_progress, completed, skipped, failed）、
step_id
（字符串）

Add step(s) to plan

向计划中添加步骤

Add one or more steps to an existing plan
POST /ai/missions/{mission_id}/runs/{run_id}/plan/steps
— Required: 
steps
go
	response, err := client.AI.Missions.Runs.Plan.AddStepsToPlan(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunPlanAddStepsToPlanParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			Steps: []telnyx.AIMissionRunPlanAddStepsToPlanParamsStep{{
				Description: "description",
				Sequence:    0,
				StepID: "550e8400-e29b-41d4-a716-446655440000",
			}},
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
completed_at
(date-time), 
description
(string), 
metadata
(object), 
parent_step_id
(string), 
run_id
(uuid), 
sequence
(integer), 
started_at
(date-time), 
status
(enum: pending, in_progress, completed, skipped, failed), 
step_id
(string)
向已有运行计划中添加一个或多个步骤
POST /ai/missions/{mission_id}/runs/{run_id}/plan/steps
— 必填参数：
steps
go
	response, err := client.AI.Missions.Runs.Plan.AddStepsToPlan(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunPlanAddStepsToPlanParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			Steps: []telnyx.AIMissionRunPlanAddStepsToPlanParamsStep{{
				Description: "description",
				Sequence:    0,
				StepID: "550e8400-e29b-41d4-a716-446655440000",
			}},
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回值：
completed_at
（日期时间）、
description
（字符串）、
metadata
（对象）、
parent_step_id
（字符串）、
run_id
（UUID）、
sequence
（整数）、
started_at
（日期时间）、
status
（枚举值：pending, in_progress, completed, skipped, failed）、
step_id
（字符串）

Get step details

获取步骤详情

Get details of a specific plan step
GET /ai/missions/{mission_id}/runs/{run_id}/plan/steps/{step_id}
go
	response, err := client.AI.Missions.Runs.Plan.GetStepDetails(
		context.Background(),
		"step_id",
		telnyx.AIMissionRunPlanGetStepDetailsParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			RunID:     "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
completed_at
(date-time), 
description
(string), 
metadata
(object), 
parent_step_id
(string), 
run_id
(uuid), 
sequence
(integer), 
started_at
(date-time), 
status
(enum: pending, in_progress, completed, skipped, failed), 
step_id
(string)
获取指定计划步骤的详情
GET /ai/missions/{mission_id}/runs/{run_id}/plan/steps/{step_id}
go
	response, err := client.AI.Missions.Runs.Plan.GetStepDetails(
		context.Background(),
		"step_id",
		telnyx.AIMissionRunPlanGetStepDetailsParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			RunID:     "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回值：
completed_at
（日期时间）、
description
（字符串）、
metadata
（对象）、
parent_step_id
（字符串）、
run_id
（UUID）、
sequence
（整数）、
started_at
（日期时间）、
status
（枚举值：pending, in_progress, completed, skipped, failed）、
step_id
（字符串）

Update step status

更新步骤状态

Update the status of a plan step
PATCH /ai/missions/{mission_id}/runs/{run_id}/plan/steps/{step_id}
Optional: 
metadata
(object), 
status
(enum: pending, in_progress, completed, skipped, failed)
go
	response, err := client.AI.Missions.Runs.Plan.UpdateStep(
		context.Background(),
		"step_id",
		telnyx.AIMissionRunPlanUpdateStepParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			RunID:     "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
completed_at
(date-time), 
description
(string), 
metadata
(object), 
parent_step_id
(string), 
run_id
(uuid), 
sequence
(integer), 
started_at
(date-time), 
status
(enum: pending, in_progress, completed, skipped, failed), 
step_id
(string)
更新计划步骤的状态
PATCH /ai/missions/{mission_id}/runs/{run_id}/plan/steps/{step_id}
可选参数：
metadata
（对象）、
status
（枚举值：pending, in_progress, completed, skipped, failed）
go
	response, err := client.AI.Missions.Runs.Plan.UpdateStep(
		context.Background(),
		"step_id",
		telnyx.AIMissionRunPlanUpdateStepParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			RunID:     "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回值：
completed_at
（日期时间）、
description
（字符串）、
metadata
（对象）、
parent_step_id
（字符串）、
run_id
（UUID）、
sequence
（整数）、
started_at
（日期时间）、
status
（枚举值：pending, in_progress, completed, skipped, failed）、
step_id
（字符串）

Resume run

恢复运行

Resume a paused run
POST /ai/missions/{mission_id}/runs/{run_id}/resume
go
	response, err := client.AI.Missions.Runs.ResumeRun(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunResumeRunParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
error
(string), 
finished_at
(date-time), 
input
(object), 
metadata
(object), 
mission_id
(uuid), 
result_payload
(object), 
result_summary
(string), 
run_id
(uuid), 
started_at
(date-time), 
status
(enum: pending, running, paused, succeeded, failed, cancelled), 
updated_at
(date-time)
恢复处于暂停状态的任务
POST /ai/missions/{mission_id}/runs/{run_id}/resume
go
	response, err := client.AI.Missions.Runs.ResumeRun(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunResumeRunParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回值：
error
（字符串）、
finished_at
（日期时间）、
input
（对象）、
metadata
（对象）、
mission_id
（UUID）、
result_payload
（对象）、
result_summary
（字符串）、
run_id
（UUID）、
started_at
（日期时间）、
status
（枚举值：pending, running, paused, succeeded, failed, cancelled）、
updated_at
（日期时间）

List linked Telnyx agents

列出关联的Telnyx Agent

List all Telnyx agents linked to a run
GET /ai/missions/{mission_id}/runs/{run_id}/telnyx-agents
go
	telnyxAgents, err := client.AI.Missions.Runs.TelnyxAgents.List(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunTelnyxAgentListParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", telnyxAgents.Data)
Returns: 
created_at
(date-time), 
run_id
(string), 
telnyx_agent_id
(string)
列出关联到指定运行的所有Telnyx Agent
GET /ai/missions/{mission_id}/runs/{run_id}/telnyx-agents
go
	telnyxAgents, err := client.AI.Missions.Runs.TelnyxAgents.List(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunTelnyxAgentListParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", telnyxAgents.Data)
返回值：
created_at
（日期时间）、
run_id
（字符串）、
telnyx_agent_id
（字符串）

Link Telnyx agent to run

将Telnyx Agent关联到运行记录

Link a Telnyx AI agent (voice/messaging) to a run
POST /ai/missions/{mission_id}/runs/{run_id}/telnyx-agents
— Required: 
telnyx_agent_id
go
	response, err := client.AI.Missions.Runs.TelnyxAgents.Link(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunTelnyxAgentLinkParams{
			MissionID:     "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			TelnyxAgentID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
Returns: 
created_at
(date-time), 
run_id
(string), 
telnyx_agent_id
(string)
将Telnyx AI Agent（语音/消息类）关联到指定运行
POST /ai/missions/{mission_id}/runs/{run_id}/telnyx-agents
— 必填参数：
telnyx_agent_id
go
	response, err := client.AI.Missions.Runs.TelnyxAgents.Link(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.AIMissionRunTelnyxAgentLinkParams{
			MissionID:     "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			TelnyxAgentID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response.Data)
返回值：
created_at
（日期时间）、
run_id
（字符串）、
telnyx_agent_id
（字符串）

Unlink Telnyx agent

解绑Telnyx Agent

Unlink a Telnyx agent from a run
DELETE /ai/missions/{mission_id}/runs/{run_id}/telnyx-agents/{telnyx_agent_id}
go
	err := client.AI.Missions.Runs.TelnyxAgents.Unlink(
		context.Background(),
		"telnyx_agent_id",
		telnyx.AIMissionRunTelnyxAgentUnlinkParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			RunID:     "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
将指定Telnyx Agent从运行记录中解绑
DELETE /ai/missions/{mission_id}/runs/{run_id}/telnyx-agents/{telnyx_agent_id}
go
	err := client.AI.Missions.Runs.TelnyxAgents.Unlink(
		context.Background(),
		"telnyx_agent_id",
		telnyx.AIMissionRunTelnyxAgentUnlinkParams{
			MissionID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
			RunID:     "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		},
	)
	if err != nil {
		log.Fatal(err)
	}

List tools

列出工具

List all tools for a mission
GET /ai/missions/{mission_id}/tools
go
	response, err := client.AI.Missions.Tools.ListTools(context.Background(), "mission_id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)
列出指定mission的所有工具
GET /ai/missions/{mission_id}/tools
go
	response, err := client.AI.Missions.Tools.ListTools(context.Background(), "mission_id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)

Create tool

创建工具

Create a new tool for a mission
POST /ai/missions/{mission_id}/tools
go
	response, err := client.AI.Missions.Tools.NewTool(context.Background(), "mission_id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)
为指定mission创建新的工具
POST /ai/missions/{mission_id}/tools
go
	response, err := client.AI.Missions.Tools.NewTool(context.Background(), "mission_id")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)

Get tool

获取工具详情

Get a specific tool by ID
GET /ai/missions/{mission_id}/tools/{tool_id}
go
	response, err := client.AI.Missions.Tools.GetTool(
		context.Background(),
		"tool_id",
		telnyx.AIMissionToolGetToolParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)
通过ID获取指定工具的详情
GET /ai/missions/{mission_id}/tools/{tool_id}
go
	response, err := client.AI.Missions.Tools.GetTool(
		context.Background(),
		"tool_id",
		telnyx.AIMissionToolGetToolParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)

Update tool

更新工具

Update a tool definition
PUT /ai/missions/{mission_id}/tools/{tool_id}
go
	response, err := client.AI.Missions.Tools.UpdateTool(
		context.Background(),
		"tool_id",
		telnyx.AIMissionToolUpdateToolParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)
更新工具定义
PUT /ai/missions/{mission_id}/tools/{tool_id}
go
	response, err := client.AI.Missions.Tools.UpdateTool(
		context.Background(),
		"tool_id",
		telnyx.AIMissionToolUpdateToolParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", response)

Delete tool

删除工具

Delete a tool from a mission
DELETE /ai/missions/{mission_id}/tools/{tool_id}
go
	err := client.AI.Missions.Tools.DeleteTool(
		context.Background(),
		"tool_id",
		telnyx.AIMissionToolDeleteToolParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
从mission中删除指定工具
DELETE /ai/missions/{mission_id}/tools/{tool_id}
go
	err := client.AI.Missions.Tools.DeleteTool(
		context.Background(),
		"tool_id",
		telnyx.AIMissionToolDeleteToolParams{
			MissionID: "550e8400-e29b-41d4-a716-446655440000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}