MABILIS NA SIMULA PARA SA DEVELOPER

API at integrasyon sa paggamit ng AI

Magsimula sa isang proyekto at isang event. Magdagdag ng visibility kung saan tumatakbo na ang workflow.

ISANG PROYEKTO. READ-ONLY NA KONTEKSTO.

Dalhin ang iyong mga signal sa usapan.

Binabasa ng dalawang koneksyon ang sinusubaybayang usage, kalagayan ng automation, at panloob na tantiya ng singil sa kliyente. Gumawa muna ng nakalaang project read key. Hindi kailangan ang mga API key ng provider.

Lokal na Codex plugin

I-download ang lokal na plugin

Kasama sa download ang INSTALL.md. Pagkatapos i-extract, patakbuhin ang npm ci --prefix server mula sa folder na iyon. Ginagamit ng halimbawa sa ibaba ang buong application source layout.

Gamitin ang kasamang plugin/ source package. I-install ang server dependencies nito, saka irehistro ang package gamit ang suportadong local plugin workflow ng iyong Codex host.

npm ci --prefix plugin/server

# In your MCP host's secure environment:
TRACEWELL_URL=https://tracewell.bhsoftwareproductions.com
TRACEWELL_READ_KEY=YOUR_PROJECT_READ_KEY

Idinedeklara ng package ang lokal na stdio server sa plugin/mcp.json. Kasama ang detalye ng setup sa docs/PLUGIN.md. Hindi nangangahulugang naka-install na ang plugin sa host mo dahil available ang source.

ChatGPT o katugmang MCP host

Magdagdag ng custom MCP connection gamit ang hosted endpoint at OAuth authentication. Suriin ang consent page ng Tracewell at pahintulutan doon ang nakalaang project read key; huwag mag-paste ng secret ng provider o read key sa chat.

Naka-host na MCP endpointhttps://tracewell.bhsoftwareproductions.com/mcp

Dapat suportado ng host, account, at administrator ang custom MCP connection. Dapat i-configure ng may-ari ang hosted OAuth origin at persistence. Hindi pinatutunayan ng pahinang ito ang naka-install na koneksyon.

Buksan ang opisyal na ChatGPT setup guide

Ang metadata lang na ipinapadala mo.

JavaScript SDK · Python SDK

Hindi natutuklasan ng mga tool na ito ang provider account, chat subscription, o bawat usapan. Para ikonekta ang ibang proyekto, gumamit ng hiwalay na nakalaang read key at koneksyon.

Gumawa ng project read key

Gumawa ng proyekto

Buksan ang workspace, piliin ang Mga kliyente at proyekto, at bigyan ng pangalan at buwanang USD budget ang trabaho. Gamitin lamang ang real workspace mode kapag naka-configure ang authentication at API.

Buksan ang mga proyekto →

Mag-isyu ng scoped key

Gumawa ng ingest key para sa proyekto. Kopyahin nang isang beses ang secret at itago sa server. Huwag ilagay sa browser code o ipadala ang credentials ng provider sa Tracewell.

Ipadala ang usage metadata

curl https://YOUR_HOST/api/v1/usage \
  -H 'Authorization: Bearer YOUR_PROJECT_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"eventId":"unique-event-id","provider":"custom",
       "model":"my-model","costUsd":0.042}'

Gumamit ng matatag at natatanging eventId para ligtas na umulit. Magbigay ng costUsd o parehong inputRatePerMillion at outputRatePerMillion kasama ang bilang ng token. Kung walang tahasang presyo, nananatiling hindi alam ang gastos. Sinusuportahan ang anumang pangalan ng provider o model.

Iulat ang mga resulta

POST /api/v1/runs
{
  "eventId": "unique-run-id",
  "automationId": "YOUR_AUTOMATION_ID",
  "status": "success",
  "recordsProcessed": 12,
  "durationMs": 3400
}

Gumawa muna ng automation. Sinusuri ang nawawalang run pagkalipas ng inaasahang pagitan at limang minuto. Nagdudulot ng in-app alert ang bigo o kulang na resulta. Nagbibigay-impormasyon ang mga alerto; hindi nila pinatitigil ang upstream workload.

Dalhin ang konteksto sa Codex

Gamitin ang nakakahong connection quickstart sa itaas para sa lokal na Codex plugin o hosted OAuth MCP endpoint. Nagbibigay ang dalawa ng project summary, usage, resulta ng automation, at panloob na tantiya ng singil sa kliyente sa pamamagitan ng nakalaang project read access. Tahasan ang host setup at authorization.

Binabasa lamang nito ang mga event na nilagyan mo ng pagsubaybay. Hindi nito natutuklasan ang chat subscription, sinusuri ang bawat Codex o ChatGPT conversation, o hinuhulaan ang gastos mula sa account billing. Para sukatin ang API call, ipadala ang metadata sa ingest endpoint. Ihiwalay ang secret ng provider sa Tracewell key.

Gumawa ng read-only project key →

Panatilihing maliit ang payload

Mga nakadokumentong metadata field lang ang tinatanggap. Tinatanggihan ang prompt, completion, secret ng provider, at arbitraryong field. Hanggang 16 KB ang JSON request. Naka-scope ang event ID ayon sa proyekto at uri ng event.