bytefaas

Query ByteFaaS service details, cluster deployments, and code revisions by PSM or region.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill bytefaas-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bytefaas
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/bytefaas
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill bytefaas-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Locating FaaS service configurations, deployment clusters, and running code versions across ByteDance's multi-region ByteFaaS platform requires navigating many regions and APIs manually. This Skill provides a single query interface to look up services, clusters, and revisions by PSM, service ID, or region. ## Core Features & Use Cases - Service Lookup: Retrieve service details by PSM and environment, or search and filter service lists by name, owner, or subscription type. - Cluster & Revision Inspection: List deployment clusters per region or service, fetch code revision details, and check the currently online revision per cluster. - Multi-Region Routing: Route queries through the correct VRegion (China, Singapore, US-TTP, EU-TTP, BOE, and more) with guidance on mapping business region names to query parameters. - Use Case: When debugging a FaaS deployment issue, ask which clusters a function is deployed to in USTTP and what code version is currently serving traffic, and get structured JSON answers immediately. ## Quick Start Ask the agent to look up the ByteFaaS service details for a given PSM in the prod environment, for example by saying "query the ByteFaaS service tiktok.example.faas in prod".

Frequently Asked Questions about bytefaas

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I look up a ByteFaaS service by PSM?

Use the get_service action with the psm and env parameters, for example action get_service with psm and env set to prod. This is more reliable than list_services when you already know the PSM and environment.

How to check which clusters a FaaS function is deployed to?

Use list_clusters with the psm and a real cluster region such as us-ttp or cn-north, or use list_clusters_by_service with a service_id for paginated results. Do not pass region group names like usttp or euttp as the region value.

What is the difference between vregion and region in ByteFaaS queries?

vregion is the authentication and API routing region such as US-TTP or Singapore-Central, while region is the actual cluster region like us-ttp2 or us-east-red used in cluster and online revision queries. Passing a region group name as region returns no data.

Why does searching ByteFaaS services by owner return wrong results?

The search_type parameter takes priority over owner: passing search_type own, admin, or subscribe filters by the caller's identity and ignores the owner field. To query another person's services, pass only owner or combine it with search_type all.

How do I check the current online version of a FaaS function?

Use the get_online_revision action with service_id, region, and cluster parameters. It returns the code revision ID, traffic value, and images currently serving in that cluster.

What should I do when a ByteFaaS query returns no results in one region?

A network timeout does not mean the service does not exist; only a successful empty response means no match in that VRegion. Report the miss to the user and suggest alternative VRegions, waiting for confirmation before retrying.