---
title: "Sine Agents：模型与会话"
description: "在组织工作空间中创建 Agent、选择可用模型、运行会话、关联 Box 资源，并检查执行结果与模型调用费用。"
image: "https://docs.sinecloud.dev/opengraph.png"
---

> 完整文档索引： https://docs.sinecloud.dev/zh-CN/llms.txt

# Sine Agents：模型与会话

Sine Agents 提供 Agent 配置与会话工作台。一个 Agents 工作空间可以包含多个 Agent 和会话。可以在控制台直接使用组织级资源，无需先创建项目、Box 或 API 密钥。

## 创建并运行 Agent

1. 登录 [Console](https://sinecloud.dev/zh-CN/dashboard)，选择组织并打开 **Agents**。
2. 首次没有工作空间时，由所有者或管理员准备资源。默认可选择“直接属于组织”；准备资源只建立工作空间，不执行任务或增加余额。
3. 在 **Agents** 页创建 Agent，填写配置，从实际模型目录中选择模型并保存。
4. 打开 **会话**，选择 Agent 并明确提交消息。选择“创建并试用”只进入会话表单，不自动发送请求。
5. 查看最新执行轮次和对应的完整回复，必要时打开 **模型调用与费用**。

标题旁的项目范围切换器用于选择组织级或项目工作空间；组织切换器位于左上角。没有服务的范围会显示准备入口，不会自动改用其他项目。

## 选择适合任务的模型

在已接入 Gateway 的环境中，Agent 使用组织模型目录中的路由。可按名称或路由 ID 搜索。沿用登录会话或已有的 Agents 授权 API 密钥即可，不需要额外创建带 Gateway 授权的 API 密钥。

- **平台托管模型**：需要可用路由、适用预算及组织余额，按 Gateway 发布的价格计费。
- **自有密钥模型**：使用组织在 Gateway 保存的供应商连接，供应商费用由该账户承担。
- **工具、多 Agent 或托管执行环境**：必须选择已确认支持工具调用的路由。纯文本、无工具且环境为 `none` 的会话可以使用工具能力未知的文本路由。

Agents 当前需要文本流式响应；不支持此能力或暂不支持流式的固定请求价模型会显示不可用原因。模型列表为空时，检查组织和实例权限，再到 [Gateway](/zh-CN/products/gateway/) 检查连接、路由状态和密钥路由限制。

旧 Agent 和会话不会因为改名或编辑指令就迁移模型。需要切换模型时，明确选择可用模型并保存，再创建新会话；每次执行仍重新检查路由权限和能力限制。

## 理解状态和费用

会话显示“空闲”不代表上一次执行成功。应查看最新轮次、回复和错误信息。一轮任务中，模型请求工具、读取结果后继续回答，可能产生多次模型调用。

经 Gateway 的模型调用只使用一份 Gateway 计费来源，Agents 不重复扣取同一模型费用。自有密钥调用的 Cloud 服务费当前为零，供应商费用仍需查看供应商账单。调用列表不是整个会话或组织的费用合计；未知用量不等于零。

运行中关闭页面或断开实时订阅不会自动取消任务。需要停止时使用会话取消操作；结果不确定时先检查原会话与调用记录，保留请求 ID 和调用 ID，避免重复发送相同任务。

## 文件、Box 与程序接入

原 Agents 工作区文件仍在实例的 **文件** 页，不会自动迁入 Box。Agent 可以显式关联同组织、同项目范围的 [Box](/zh-CN/products/box/)；这是可选组合，两边都必须通过各自的权限与运行检查。

程序接入使用 **API** 页中的真实实例地址和已选 Agent 示例。创建 [API 密钥](/zh-CN/api-keys/) 时选择 Agents 与所需功能，项目范围应与资源一致。不要用随意编造的 Agent ID 或另一组织的资源地址。

## 常见阻断

- **余额不足**：检查[组织账务](/zh-CN/billing/)；成员应联系所有者或管理员。
- **输入过大**：缩短指令、历史或工具定义，或选择容量更高的路由后创建新会话。
- **工具能力不支持**：选择已确认支持工具调用的模型。
- **路由、平台配置或运行服务不可用**：保留错误中的请求标识并联系管理员。

来源: https://docs.sinecloud.dev/zh-CN/products/agents/index.mdx