faqs.md

FAQ：User Questions Index (English)

This page lists the most common questions and points you to the exact documentation page to read next.

Common questions

1. I am an orchestration/Agent developer. How do I map my workflow into ExecGo TaskGraph?

   • See: Mapping：DAG -> TaskGraph

2. What does depends_on mean, and why doesn't downstream automatically get upstream outputs?

   • See: Mapping：DAG -> TaskGraph

3. Why do downstream tasks become skipped after a failure?

   • See: Failure semantics：failed vs skipped

4. How do I get the final result after submitting? Is it synchronous or asynchronous?

   • See: Polling & idempotency：stable submit & read results
   • Also: GET /tasks/{id}

5. Why do I get 400 Bad Request? What does TaskGraph.Validate() mean?

   • See: Task DSL Reference (Index)

6. How should I set retry and timeout?

   • See: Task DSL Reference (Index)
   • Failure/retry semantics: failed vs skipped

7. What does result / error look like? How should I parse it?

   • See: API Reference (Index)
   • Multi-language clients: integration examples

8. How do I deploy ExecGo with Docker Compose?

   • See: Docker Compose deploy example

9. How do I deploy ExecGo to Kubernetes (Deployment/Service/PVC)?

   • See: Kubernetes deploy example

10. Is it safe to set replicas > 1 on Kubernetes?

• See: Replica safety notes

11. How do I call ExecGo from Go?

• See: Go (HTTP) integration example

12. How do I call ExecGo from Java?

• See: Java (HTTP) integration example

13. How do I call ExecGo from Python?

• See: Python (HTTP) integration example

14. How do I call ExecGo from Node.js + TypeScript?

• See: Node.js + TypeScript (HTTP) integration example

15. Is the shell executor safe? How do I avoid arbitrary command execution risks?

• See: Executors & Parameters (Index)
• More detail: Shell 执行器参数

16. Where is task state stored? How is persistence/recovery handled?

• See: Data persistence strategy

17. How do I extend executors or implement a custom executor?

• See: Executors & Parameters (Index)

18. I have idempotency / duplicate submission problems. What should I do?

• See: Polling & idempotency