Doubao Assistant Free

SKILL.md

---
slug: doubao-assistant-free
name: doubao-assistant-free
version: 1.0.0
displayName: 豆包助手(免费版)
summary: 基于豆包大模型的中文对话助手，支持联网搜索与基础问答能力。
license: Proprietary
edition: free
description: 豆包助手免费版是一个基于豆包大模型 API 的中文对话辅助工具，帮助开发者以零成本接入具备联网搜索能力的 AI 对话服务。核心能力：提供对话补全接口调用模板、联网搜索开关配置、基础错误处理与重试策略、会话管理指南。Use
  when 需要AI模型调用、智能对话、Agent编排、LLM应用时使用。不适用于需要100%确定性的关键决策。
tags:
- AI对话
- 集成工具
- API接入
- 免费版
tools:
- - read
- exec
homepage: https://skillhub.cn
pricing_tier: L3
pricing_model: per_use
suggested_price: 29.9
tools: ["read", "write", "exec"]
tags: "工具,效率,自动化"
---
# 豆包助手（免费版）

## 概述

豆包大模型提供中文优化的对话能力，并内置联网搜索功能，适合需要实时信息的问答场景。本助手将 API 调用流程整理为结构化指南，帮助你在数分钟内完成首次对话调用。

免费版覆盖**日常使用最高频的四大场景**：基础对话、联网搜索、错误处理、会话管理。

## 核心能力

### 能力一：对话补全接口

通过对话补全端点发送请求，获取 AI 回复。

## 输入格式
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 豆包助手(免费版)处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |

```bash
# 对话补全请求
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-pro",
    "messages": [
      {"role": "user", "content": "今天北京天气怎么样？"}
    ]
  }' \
  "https://api.example.com/v1/chat/completions"
```

**输入**: 用户提供能力一：对话补全接口所需的指令和必要参数。
**处理**: 解析能力一：对话补全接口的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回能力一：对话补全接口的响应数据,包含状态码、结果和日志。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

### 能力二：联网搜索

豆包支持联网搜索能力，可在对话中获取实时信息。

| 模式 | 说明 | 适用场景 |
|:-----|:-----|:-----|
| 默认模式 | 基于模型知识回答 | 知识类问题 |
| 联网搜索 | 搜索后综合回答 | 时效性问题 |

**输入**: 用户提供能力二：联网搜索所需的指令和必要参数。
**处理**: 解析能力二：联网搜索的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回能力二：联网搜索的响应数据,包含状态码、结果和日志。

### 能力三：多轮对话管理

通过维护消息历史实现多轮上下文对话。

```javascript
// 多轮对话历史管理
const conversationHistory = [
  { role: 'system', content: '你是一个友好的中文助手' },
  { role: 'user', content: '什么是机器学习？' },
  { role: 'assistant', content: '机器学习是人工智能的一个分支...' },
  { role: 'user', content: '它和深度学习有什么区别？' }
  // 模型能基于上文理解"它"指代机器学习
];
```

**输入**: 用户提供能力三：多轮对话管理所需的指令和必要参数。
**处理**: 解析能力三：多轮对话管理的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回能力三：多轮对话管理的响应数据,包含状态码、结果和日志。
**能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：基于豆包大模型的、中文对话助手、支持联网搜索与基、础问答能力、豆包助手免费版是、一个基于豆包大模、API、的中文对话辅助工、帮助开发者以零成、本接入具备联网搜、索能力的、对话服务、核心能力、提供对话补全接口、调用模板、联网搜索开关配置、基础错误处理与重、试策略、会话管理指南、Use、when、模型调用、智能对话、Agent、LLM、应用时使用、不适用于需要、确定性的关键决策等。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

## 错误处理

| 错误类型 | 状态码 | 处理策略 |
|---:|---:|---:|
| 凭据无效 | 401 | 检查会话凭据是否过期 |
| 请求格式错误 | 400 | 检查 JSON 结构与字段 |
| 服务不可用 | 503 | 等待后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令 |
| 超时 | - | 设置 30-60 秒超时，超时执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令 |

**输入**: 用户提供错误处理所需的指令和必要参数。
**处理**: 解析错误处理的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回错误处理的响应数据,包含状态码、结果和日志。

## 使用场景

### 常见问题

用户询问"今天有什么新闻"、"某股票现在价格多少"等需要实时信息的问题，启用联网搜索获取最新答案。

### 场景二：个人知识助手

将豆包接入个人笔记或工具，实现自然语言问答与内容总结。

### 场景三：学习 API 调用

初学者通过本助手的模板与示例，快速理解对话补全 API 的请求结构与响应格式。

## 快速开始

### 第一步：配置凭据

```bash
# 设置环境变量（切勿硬编码）
export DOUBAO_SESSIONID=your_session_id
```

### 第二步：发送首次对话

```bash
# 使用 curl 快速测试
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-pro",
    "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}]
  }' \
  "https://api.example.com/v1/chat/completions"
```

### 第三步：使用脚本模板

```javascript
// chat.js - 最小可用脚本
const sessionId = process.env.DOUBAO_SESSIONID;
// ...
async function chat(message) {
  const resp = await fetch('https://api.example.com/v1/chat/completions', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      model: 'doubao-pro',
      messages: [{ role: 'user', content: message }]
    })
  });
// ...
  if (!resp.ok) {
    throw new Error(`API错误: ${resp.status}`);
  }
// ...
  const data = await resp.json();
  return data.choices[0].message.content;
}
// ...
// 命令行调用
chat(process.argv[2]).then(console.log).catch(console.error);
```

#
## 示例

### 会话配置

```javascript
// 对话配置选项
const config = {
  model: 'doubao-pro',           // 模型选择
  temperature: 0.7,              // 创造性 0-1
  max_tokens: 2000,              // 最大输出长度
  top_p: 0.9,                    // 核采样
  stream: false                  // 免费版不使用流式
};
```

### 系统提示词示例

```javascript
// 不同场景的系统提示词
const systemPrompts = {
  assistant: '你是一个专业的中文助手，回答简洁准确',
  translator: '你是一个翻译专家，将输入翻译为指定语言',
  summarizer: '你是一个内容总结助手，将长文浓缩为要点'
};
```

## 最佳实践

### 实践一：凭据通过环境变量管理

永远不要将 Session ID 写入代码或提交到版本库，统一通过环境变量注入。

### 实践二：联网搜索按需开启

知识类问题不需要联网搜索（更快更稳定），时效性问题才开启联网搜索。

### 实践三：控制上下文长度

多轮对话的历史消息会消耗 Token，超出窗口后截断早期消息或做摘要压缩。建议保留最近 5-10 轮对话。

### 实践四：错误分类处理

凭据过期时提示用户重新获取；服务不可用时重试 2-3 次；格式错误时检查并修正请求体。

### 实践五：合理设置 temperature

问答场景用低 temperature（0.3-0.5）保证准确性；创作场景用高 temperature（0.7-0.9）增加多样性。

## 常见问题(补充)

### Q1：凭据从哪里获取？

通过豆包平台获取会话凭据。凭据有时效性，过期后需重新获取。

### Q2：联网搜索结果准确吗？

联网搜索基于网络内容综合回答，可能受信息源质量影响。重要信息建议交叉验证原始来源。

### Q3：中文效果好不好？

豆包对中文理解优秀，特别适合中文问答、写作与翻译场景。

### Q4：出现 503 服务不可用怎么办？

服务端临时不可用，等待 30-60 秒后重试。持续不可用可能是服务维护中，建议关注官方公告。

### Q5：多轮对话上下文丢失？

检查是否正确维护了消息历史数组，每轮对话后追加 user 与 assistant 的消息。上下文超限时截断早期消息。

## 依赖说明

### 运行环境
- **Agent 平台**: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
- **操作系统**: Windows / macOS / Linux
- **运行时**: Node.js 18+ 或 Python 3.8+ 或任意支持 HTTP 的环境

### 依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:---:|:---:|:---:|:---:|
| LLM API | API | 必需 | 由Agent平台内置LLM提供 |
| 豆包会话凭据 | 凭据 | 必需 | 豆包平台获取 |
| Node.js / Python | 运行时 | 可选 | 官方网站下载 |
| curl | 工具 | 可选 | 系统自带或安装 |

### API Key 配置
- **豆包会话凭据**: 通过环境变量 `DOUBAO_SESSIONID` 注入
- **禁止**: 在代码、脚本、SKILL.md 中硬编码凭据
- **推荐**: 使用 `.env` 文件管理密钥并加入 `.gitignore`

### 可用性分类
- **分类**: MD+EXEC（纯Markdown指令，核心功能需要exec执行HTTP请求）
- **说明**: 基于Markdown的AI Skill，通过自然语言指令驱动Agent调用豆包 API 完成对话任务

## 已知限制

本免费体验版限制以下高级功能：
- 流式响应（SSE）处理（仅专业版提供）
- 函数调用 / 工具调用能力（仅专业版提供）
- 知识库集成与检索增强（仅专业版提供）
- 批量请求与并发管理（仅专业版提供）
- 自定义系统提示词模板库（仅专业版提供）
- 用量统计与会话分析面板（仅专业版提供）

解锁全部功能请使用专业版：doubao-assistant-pro
- 当前为免费版本,如需完整功能请升级到付费版获取全部能力

## 输出格式
```json
{
  "success": true,
  "data": {
    "result": "豆包助手(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "doubao assistant"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}
```