What is the volcengine-ai-entry-ark skill?

It routes generic ARK model requests to the correct task-specific skill and provides a minimal runnable starting point for ARK invocations.

What inputs do I need to start an ARK call?

ARK_API_KEY, the model endpoint ID (ep-xxxx), the task type (chat, summarization, coding, translation), and optional generation parameters like temperature, max_tokens, and top_p.

How do I troubleshoot ARK errors?

Check 401 for ARK_API_KEY and key scope, 404 for region/endpoint issues, 429 for rate limits with backoff, and 5xx errors with retries and logs.

Volcengine Ai Entry Ark

Scanned

@cinience

npx machina-cli add skill @cinience/volcengine-ai-entry-ark --openclaw

Files (1)

SKILL.md

1.2 KB

volcengine-ai-entry-ark

Route generic ARK model requests to the right task-specific skill and provide a minimal runnable starting point.

Inputs to Collect

ARK_API_KEY
Model endpoint ID (for example: ep-xxxx)
Task type (chat, summarization, coding, translation)
Optional generation params (temperature, max_tokens, top_p)

Minimal request template

curl https://ark.cn-beijing.volces.com/api/v3/chat/completions \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ep-xxxx",
    "messages": [
      {"role":"system","content":"You are a helpful assistant."},
      {"role":"user","content":"Hello"}
    ],
    "temperature": 0.2
  }'

Troubleshooting Checklist

401: verify ARK_API_KEY and key scope
404: verify endpoint region/domain and endpoint ID
429: reduce request rate and add retries with backoff
5xx: retry with jitter and keep request logs for support

References

references/sources.md

Source

git clone https://clawhub.ai/cinience/volcengine-ai-entry-arkView on GitHub

Overview

Route generic ARK requests to the right task-specific skill and provide a minimal runnable starting point. It helps users start ARK invocations, configure the endpoint, and troubleshoot authentication and routing quickly.

How This Skill Works

The skill collects ARK_API_KEY, Model endpoint ID (ep-xxxx), Task type, and optional generation params. It uses these inputs to guide the routing flow and present a runnable starting template (curl) to invoke the ARK endpoint and feed results into the appropriate task handler.

When to Use It

User asks to start with an ARK model invocation
You need a ready-to-run ARK request template
You must configure the model endpoint ID and region for ARK
You want to route a request to a specific task type (chat, summarization, coding, translation)
Authentication or endpoint troubleshooting for ARK (401/404/429/5xx)

Quick Start

Step 1: Collect ARK_API_KEY, endpoint ID (ep-xxxx), and task type from the user
Step 2: Choose optional generation params (temperature, max_tokens, top_p) and prepare the messages
Step 3: Run the Minimal request template (curl) against the ARK endpoint and review the response

Best Practices

Store ARK_API_KEY securely and ensure correct key scope
Verify endpoint region/domain and the endpoint ID before requests
Use the provided minimal request template (curl) as a baseline
Specify the correct task type (chat, summarization, coding, translation) in calls
Enable retries with backoff and maintain logs for support

Example Use Cases

Route a chat request to ARK using ep-xxxx with a system and user message
Run a summarization task by setting task type to summarization and using the template
Execute a coding task by routing to the appropriate ARK endpoint
Perform a translation task by targeting the ARK endpoint with translation messages
Troubleshoot 401/404 by verifying ARK_API_KEY, scope, endpoint region, and endpoint ID

Frequently Asked Questions

Add this skill to your agents