git:20260908.0db9c2d to git:20260908.7ccee53

33 added, 46 removed. Audit A to A.

---

name: antigravity-call-gpt

- description: Dùng khi user yêu cầu gọi OpenAI GPT/Codex từ Antigravity để làm việc.

+ description: Dùng khi user yêu cầu gọi OpenAI GPT/Codex từ Antigravity để sinh code, dịch, tóm tắt, hoặc hỏi đáp qua API OpenAI.

---

# Tích hợp OpenAI GPT/Codex vào Antigravity

## Mục đích

- Cho phép agent gọi OpenAI GPT/Codex API từ bên trong Antigravity thông qua script Python.

+ Cho phép agent gọi OpenAI Responses API từ bên trong Antigravity thông qua script Python.

Áp dụng cho: sinh code, dịch thuật, tóm tắt, hỏi đáp, review, hoặc bất kỳ tác vụ nào cần model OpenAI.

Không dùng skill này khi tác vụ đã được Antigravity/Gemini xử lý tốt mà không cần model bên ngoài.

- ## Yêu cầu trước khi dùng

- - Python 3.10+ đã cài trên máy.

- - Package `openai` đã cài: `pip install openai` (hoặc `uv pip install openai`).

- - Biến môi trường `OPENAI_API_KEY` đã được set, hoặc truyền trực tiếp qua flag `--api-key`.

- - Biến môi trường `OPENAI_BASE_URL` (tuỳ chọn) — set khi dùng proxy/gateway local (vd: `http://localhost:57334/v1`).

+ ## Cấu hình (đã gắn sẵn trong script, chạy là chạy)

- ## Quy tắc vận hành

+ | Biến | Giá trị |

+ |------|---------|

+ | `OPENAI_API_KEY` | `agt_codex_pO9igWPgzTk07nO44VoSO2Bmvw8n9Tzb` |

+ | `OPENAI_BASE_URL` | `http://localhost:57334/v1` |

+ | `OPENAI_MODEL` | `gpt-6-astra` |

+ | Endpoint | `/responses` (Responses API) |

- - Luôn ưu tiên dùng biến môi trường `OPENAI_API_KEY`; không hardcode key vào lệnh terminal.

- - Nếu `OPENAI_API_KEY` chưa set, hỏi user trước khi tiếp tục.

- - Model mặc định: `gpt-6-astra`. Đổi model bằng flag `--model`.

- - Kết quả trả về là text thuần; agent tự parse và xử lý tiếp.

- - Nếu cần truyền code context dài, dùng flag `--context-file` thay vì paste inline.

- - Không gọi API OpenAI cho tác vụ mà Antigravity đã xử lý đủ tốt.

+ ## Yêu cầu

- ## Cách dùng ví dụ:

+ - Python 3.10+.

+ - Package `openai`: `pip install openai`.

- ### Cách 1: Gọi script trực tiếp

+ ## Cách dùng

```bash

- # Hỏi đáp đơn giản

- python internal/aicontext/skills/antigravity-call-gpt/scripts/call_gpt.py --prompt "Giải thích async/await trong Python"

- # Chọn model khác

- python internal/aicontext/skills/antigravity-call-gpt/scripts/call_gpt.py --prompt "Viết unit test cho hàm sort" --model gpt-4o-mini

+ # Hỏi đáp

+ python internal/aicontext/skills/antigravity-call-gpt/scripts/call_gpt.py -p "Giải thích async/await"

# Truyền code context từ file

- python internal/aicontext/skills/antigravity-call-gpt/scripts/call_gpt.py --prompt "Review code này" --context-file src/main.py

- # Chế độ sinh code (thêm system prompt chuyên code)

- python internal/aicontext/skills/antigravity-call-gpt/scripts/call_gpt.py --prompt "Viết hàm merge sort" --code-mode

- # Tuỳ chỉnh system prompt

- python internal/aicontext/skills/antigravity-call-gpt/scripts/call_gpt.py --prompt "Dịch sang tiếng Anh" --system "You are a professional translator."

- ```

+ python internal/aicontext/skills/antigravity-call-gpt/scripts/call_gpt.py -p "Review code này" -c src/main.py

- ### Cách 2: Gọi inline bằng Python one-liner

+ # Chế độ sinh code

+ python internal/aicontext/skills/antigravity-call-gpt/scripts/call_gpt.py -p "Viết hàm merge sort" --code-mode

- ```bash

- python -c "

- from openai import OpenAI; import os

- c = OpenAI(api_key=os.environ['OPENAI_API_KEY'])

- r = c.chat.completions.create(model='gpt-6-astra', messages=[{'role':'user','content':'Hello'}])

- print(r.choices[0].message.content)

- "

+ # Custom system prompt

+ python internal/aicontext/skills/antigravity-call-gpt/scripts/call_gpt.py -p "Dịch sang tiếng Anh" -s "You are a translator."

```

- ## Workflow

+ ## CLI flags

- 1. Xác định tác vụ cần model OpenAI (sinh code, dịch, tóm tắt, review…).

- 2. Kiểm tra `OPENAI_API_KEY` đã set chưa. Nếu chưa → hỏi user.

- 3. Chọn cách gọi phù hợp (script hoặc one-liner).

- 4. Chạy lệnh, đọc output, xử lý tiếp theo yêu cầu user.

- 5. Nếu output quá dài hoặc cần parse → dùng `--context-file` hoặc pipe output.

+ | Flag | Mô tả | Mặc định |

+ |------|--------|----------|

+ | `-p`, `--prompt` | Prompt (bắt buộc) | — |

+ | `-m`, `--model` | Model | `gpt-6-astra` |

+ | `-s`, `--system` | Developer/system prompt | — |

+ | `-c`, `--context-file` | File code làm context | — |

+ | `--code-mode` | Bật system prompt sinh code | `false` |

+ | `--api-key` | Override API key | — |

+ | `-t`, `--temperature` | Temperature | `0.7` |

+ | `--max-tokens` | Giới hạn output tokens | — |

## Tham khảo

- - `scripts/call_gpt.py`: Script chính gọi OpenAI API. Đọc khi cần hiểu chi tiết flags và logic.

- - OpenAI API docs: https://platform.openai.com/docs/api-reference

+ - `scripts/call_gpt.py`: Script chính.

+ - OpenAI Responses API: https://platform.openai.com/docs/api-reference/responses