Volcengine Ark Web Search

Overview

Use this skill when the task needs up-to-date public web information and the runtime should go through Volcengine ARK Responses API instead of the model's built-in browsing. The bundled script wraps ARK responses with the web_search tool, defaults to Chinese-friendly output, and is suitable for repeatable automation or local agent workflows.

Default markdown output is stabilized into three sections:

• - title
• summary
• sources

When to Use

• - The user asks for today's news, recent updates, current public coverage, or live fact checks.
• You want fresh web results but must route them through Volcengine ARK with ARK_API_KEY.
• You need a reusable local command that can be shared in scripts, cron jobs, or other skills.
• The answer should prefer Chinese output, explicit dates, and source links.
• You need to compare or verify public web information before answering.

When Not to Use

• - ARK_API_KEY is missing.
• The task is static and does not need current web information.
• You need browser automation, authenticated sessions, or site-specific interaction rather than search.
• A different provider is mandatory.

Quick Start

1. 1. Confirm ARK_API_KEY is set.
2. Run the bundled script.
3. Summarize the returned answer with explicit dates and source links.

Basic usage:

CODEBLOCK0

Chinese query:

CODEBLOCK1

Custom model:

CODEBLOCK2

Structured JSON output:

CODEBLOCK3

Longer timeout with quick retries:

CODEBLOCK4

Dry run without network:

CODEBLOCK5

Core Workflow

1. 1. Rewrite the user request into a direct search question when needed. Prefer explicit entities, topics, and time windows.
2. Use the default system prompt unless the task requires raw passthrough behavior.
3. Run scripts/ark_web_search.py.
4. If the script returns enough signal, summarize in Chinese unless the user asked for another language.
5. For relative-time prompts such as "today" or "recently", write absolute dates in the final answer.

Output Requirements

• - Prefer concise summaries with links.
• Default markdown output should be stable and easy to scan: title, summary, then sources.
• Preserve uncertainty when the search result is thin or conflicting.
• If sources are present, include them.
• Convert relative date language into explicit dates whenever possible.
• If the API result is insufficient, say so instead of inventing facts.

Files

• - scripts/ark_web_search.py: ARK Responses API runner with web_search, dry-run support, streaming support, and source extraction.
• INLINECODE8: Notes on request shape, model drift, tool naming drift, and maintenance references.

Maintenance Notes

• - Prefer overriding the model with --model or ARK_MODEL. ARK model availability changes over time.
• INLINECODE11 is per attempt. Use --retries for quick retry behavior on transient failures.
• Some ARK environments reject search_context_size with HTTP 400. This script now retries automatically without that field if the server reports it as unsupported.
• The default system prompt asks the model to return summary body only. Title and source sections are added by the script to keep output stable.
• The Volcengine docs have shown both web_search and web_search_preview historically. This skill defaults to web_search and should only change if official docs for the target environment require it.
• If response parsing breaks after an upstream API change, update the normalization logic in scripts/ark_web_search.py and keep references/ark-responses-api.md in sync.