Hydracept
Execution control plane for agents: capabilities, durable jobs, budgets, receipts, and BYOK.
我該用這個嗎
品質與安全性
發現項目（12）
- LOWTool 'hydracept_status' description lacks action verb在 hydracept_status 中
- LOWTool 'hydracept_quote_capability' description lacks action verb在 hydracept_quote_capability 中
- LOWTool 'estimate_capability' description lacks action verb在 estimate_capability 中
- LOWTool 'hydracept_manifest_create' description lacks action verb在 hydracept_manifest_create 中
- LOWTool 'hydracept_clear_adapter_default' description lacks action verb在 hydracept_clear_adapter_default 中
- LOWTool 'hydracept_project_request_operation' name length outside 3-30 range在 hydracept_project_request_operation 中
- LOWTool 'hydracept_project_get_operation' name length outside 3-30 range在 hydracept_project_get_operation 中
- LOWTool 'hydracept_prepare_adapter_selection' name length outside 3-30 range在 hydracept_prepare_adapter_selection 中
- LOWTool 'hydracept_promote_adapter_alias' name length outside 3-30 range在 hydracept_promote_adapter_alias 中
- LOWTool 'hydracept_clear_adapter_default' name length outside 3-30 range在 hydracept_clear_adapter_default 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"hydracept": {
"command": "uvx",
"args": [
"hydracept"
]
}
}
}可執行的套件
0.4.4stdio遠端端點
https://api.hydracept.com/mcpstreamable-http它能做什麼
工具清單
工具（38）
⚪hydracept_status(refresh)
Session diagnostics for the authenticated API key.
輸入結構描述
{
"type": "object",
"properties": {
"refresh": {
"default": false,
"title": "Refresh",
"type": "boolean"
}
},
"title": "hydracept_statusArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_statusDictOutput"
}🟢hydracept_capabilities(key, query)
List, find, or describe capabilities. Includes one-shot readiness facts. Text job_async descriptors may include features.deferredProcessing (50% off standard token rates).
輸入結構描述
{
"type": "object",
"properties": {
"key": {
"default": "",
"title": "Key",
"type": "string"
},
"query": {
"default": "",
"title": "Query",
"type": "string"
}
},
"title": "hydracept_capabilitiesArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_capabilitiesDictOutput"
}⚪resolve_capability(intent, requirements)
Determine whether Hydracept already provides a suitable capability. Does not spend money.
輸入結構描述
{
"type": "object",
"properties": {
"intent": {
"title": "Intent",
"type": "string"
},
"requirements": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Requirements"
}
},
"required": [
"intent"
],
"title": "resolve_capabilityArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "resolve_capabilityDictOutput"
}🟡hydracept_quote_capability(capability_key, body, input)
POST /v1/capabilities/{key}/quote. Does not reserve or charge funds. 'input' is an alias for 'body'.
輸入結構描述
{
"type": "object",
"properties": {
"capability_key": {
"title": "Capability Key",
"type": "string"
},
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
},
"input": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Input"
}
},
"required": [
"capability_key"
],
"title": "hydracept_quote_capabilityArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_quote_capabilityDictOutput"
}⚪estimate_capability(capability_key, body, input)
HTTP alias of hydracept_quote_capability. Same 0.3 retail quote. 'input' is an alias for 'body'.
輸入結構描述
{
"type": "object",
"properties": {
"capability_key": {
"title": "Capability Key",
"type": "string"
},
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
},
"input": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Input"
}
},
"required": [
"capability_key"
],
"title": "estimate_capabilityArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "estimate_capabilityDictOutput"
}⚪hydracept_invoke(capability_key, body, input)
Invoke a synchronous capability (read-only domain/DNS and text). 'input' is an alias for 'body'.
輸入結構描述
{
"type": "object",
"properties": {
"capability_key": {
"title": "Capability Key",
"type": "string"
},
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
},
"input": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Input"
}
},
"required": [
"capability_key"
],
"title": "hydracept_invokeArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_invokeDictOutput"
}⚪hydracept_run(capability_key, body, wait, timeout, max_cost, ...)
hydracept.run-result.v1 over hosted HTTP. Artifact persist requires stdio MCP in a checkout. 'input' is an alias for 'body'.
輸入結構描述
{
"type": "object",
"properties": {
"capability_key": {
"title": "Capability Key",
"type": "string"
},
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
},
"wait": {
"default": true,
"title": "Wait",
"type": "boolean"
},
"timeout": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Timeout"
},
"max_cost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Max Cost"
},
"idempotency_key": {
"default": "",
"title": "Idempotency Key",
"type": "string"
},
"input": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Input"
}
},
"required": [
"capability_key"
],
"title": "hydracept_runArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_runDictOutput"
}🟡request_capability_quote(body)
Create a capability REQUEST. Commission quotes are human-paid and must not be used as execution.quoteId.
輸入結構描述
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "request_capability_quoteArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "request_capability_quoteDictOutput"
}🟢get_capability_request_quote(request_id)
Read the human-paid commission quote for a capability request. Never an execution.quoteId.
輸入結構描述
{
"type": "object",
"properties": {
"request_id": {
"title": "Request Id",
"type": "string"
}
},
"required": [
"request_id"
],
"title": "get_capability_request_quoteArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "get_capability_request_quoteDictOutput"
}🟡hydracept_submit_job(capability_key, body, idempotency_key, input)
Submit a capability job. Omit quoteId; the API seals pricing at admission. Eligible durable text jobs use deferred processing at 50% of standard token rates. Returns nextAction. 'input' is an alias for 'body'.
輸入結構描述
{
"type": "object",
"properties": {
"capability_key": {
"title": "Capability Key",
"type": "string"
},
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
},
"idempotency_key": {
"default": "",
"title": "Idempotency Key",
"type": "string"
},
"input": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Input"
}
},
"required": [
"capability_key"
],
"title": "hydracept_submit_jobArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_submit_jobDictOutput"
}🟢hydracept_job_status(job_id)
GET /v1/jobs/{jobId} once. If nextAction is poll, wait pollAfterSeconds and call again.
輸入結構描述
{
"type": "object",
"properties": {
"job_id": {
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "hydracept_job_statusArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_job_statusDictOutput"
}🟢hydracept_get_receipt(job_id)
Fetch sealed receipt summary for a job.
輸入結構描述
{
"type": "object",
"properties": {
"job_id": {
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "hydracept_get_receiptArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_get_receiptDictOutput"
}🟡hydracept_download_artifact(job_id, artifact_id)
Return artifact download metadata and content hash (hosted MCP does not write local files).
輸入結構描述
{
"type": "object",
"properties": {
"job_id": {
"title": "Job Id",
"type": "string"
},
"artifact_id": {
"title": "Artifact Id",
"type": "string"
}
},
"required": [
"job_id",
"artifact_id"
],
"title": "hydracept_download_artifactArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_download_artifactDictOutput"
}⚪hydracept_smoke(capability, prompt, poll_seconds, output_path)
Explicit managed-trial smoke. Same contract as stdio: generation, pricing, SHA-256, PNG alpha.
輸入結構描述
{
"type": "object",
"properties": {
"capability": {
"default": "image.generate.v1",
"title": "Capability",
"type": "string"
},
"prompt": {
"default": "flat 2D game icon of a slime, no plate, no ground, no shadow, centered, simple silhouette",
"title": "Prompt",
"type": "string"
},
"poll_seconds": {
"default": 90,
"title": "Poll Seconds",
"type": "integer"
},
"output_path": {
"default": "",
"title": "Output Path",
"type": "string"
}
},
"title": "hydracept_smokeArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_smokeDictOutput"
}🟡hydracept_pinned_run(body)
POST /v1/inference/pinned — exact pin, scientific receipt. Standard processing by default. Opt in with processing=deferred on eligible OpenAI Responses pins (50% Flex). One logical model execution, no truncation rewrite, no Flex→Standard fallback. Pre-inference capacity 429s may retry.
輸入結構描述
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_pinned_runArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_runDictOutput"
}🟡hydracept_pinned_bulk(body)
POST /v1/inference/pinned/bulk — concurrent pinned items, one logical execution each.
輸入結構描述
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_pinned_bulkArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_bulkDictOutput"
}🟢hydracept_pinned_get(receipt_id)
GET /v1/inference/pinned/{receipt_id}.
輸入結構描述
{
"type": "object",
"properties": {
"receipt_id": {
"title": "Receipt Id",
"type": "string"
}
},
"required": [
"receipt_id"
],
"title": "hydracept_pinned_getArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_getDictOutput"
}🟢hydracept_pinned_bulk_get(bulk_id)
GET /v1/inference/pinned/bulk/{bulk_id} once. If nextAction is poll, wait pollAfterSeconds and call again.
輸入結構描述
{
"type": "object",
"properties": {
"bulk_id": {
"title": "Bulk Id",
"type": "string"
}
},
"required": [
"bulk_id"
],
"title": "hydracept_pinned_bulk_getArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_bulk_getDictOutput"
}🟡hydracept_manifest_create(body)
POST /v1/provenance/manifests.
輸入結構描述
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_manifest_createArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_manifest_createDictOutput"
}🟡hydracept_manifest_verify(manifest_id)
POST /v1/provenance/manifests/{manifest_id}/verify.
輸入結構描述
{
"type": "object",
"properties": {
"manifest_id": {
"title": "Manifest Id",
"type": "string"
}
},
"required": [
"manifest_id"
],
"title": "hydracept_manifest_verifyArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_manifest_verifyDictOutput"
}🟢hydracept_lockfile_emit(receipt_id)
GET /v1/provenance/lockfile?receipt_id=.
輸入結構描述
{
"type": "object",
"properties": {
"receipt_id": {
"title": "Receipt Id",
"type": "string"
}
},
"required": [
"receipt_id"
],
"title": "hydracept_lockfile_emitArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_lockfile_emitDictOutput"
}🟡hydracept_verify_lockfile(body)
POST /v1/provenance/lockfile/verify.
輸入結構描述
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_verify_lockfileArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_verify_lockfileDictOutput"
}🟢hydracept_jobs_find(intent, capability_key, limit, project_id)
Find a prior job in the workspace-bound project when you do not have its id. intent is recent, failed, or reusable. This list never includes prompt text. To read the prompt that was executed, call hydracept_job_inspect and read executedPrompt (requestSnapshot.input.prompt). Bind the project that owns the job before searching.
輸入結構描述
{
"type": "object",
"properties": {
"intent": {
"default": "recent",
"title": "Intent",
"type": "string"
},
"capability_key": {
"default": "",
"title": "Capability Key",
"type": "string"
},
"limit": {
"default": 10,
"title": "Limit",
"type": "integer"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
}
},
"title": "hydracept_jobs_findArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_jobs_findDictOutput"
}🟢hydracept_job_inspect(job_id)
Read one prior job, including the prompt that was executed. executedPrompt is that prompt, also stored at requestSnapshot.input.prompt. Text jobs return it when a prompt record was kept and no input payload was stored. Also returns error, diagnostics, receipt summary, and a reuse candidate. Pass job_id from hydracept_jobs_find or an earlier run.
輸入結構描述
{
"type": "object",
"properties": {
"job_id": {
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "hydracept_job_inspectArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_job_inspectDictOutput"
}🟡hydracept_project_request_operation(command, action_key, project_id, input, context)
POST a project operation. Hosted MCP does not run the customer repo; a local watcher must execute it.
輸入結構描述
{
"type": "object",
"properties": {
"command": {
"title": "Command",
"type": "string"
},
"action_key": {
"default": "",
"title": "Action Key",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"input": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Input"
},
"context": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Context"
}
},
"required": [
"command"
],
"title": "hydracept_project_request_operationArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_project_request_operationDictOutput"
}🟢hydracept_project_get_operation(operation_id, project_id)
Poll a project operation. Execution happens in the game checkout, not on this host.
輸入結構描述
{
"type": "object",
"properties": {
"operation_id": {
"title": "Operation Id",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
}
},
"required": [
"operation_id"
],
"title": "hydracept_project_get_operationArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_project_get_operationDictOutput"
}🟢hydracept_model_adapters(project_id, environment)
List the bound project's registered model adapters, semantic aliases, image-generation default, and static routing readiness. To use one LoRA, call hydracept_use_lora with its alias or name. To suggest a new public LoRA, call hydracept_suggest_lora with a Hugging Face link. Do not assemble adapter ids, weight filenames, or base-model families. Omitted project/environment arguments inherit the authenticated workspace binding. A registered adapter is not necessarily executable; require routingReadiness.routeCompatible before selecting it for generation. credentialAvailability=not_checked means credentials/capacity are still quote-time concerns. The project default is not applied unless the caller sends input.adapters. Trigger words are stored and are not added to the prompt.
輸入結構描述
{
"type": "object",
"properties": {
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"title": "hydracept_model_adaptersArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_model_adaptersDictOutput"
}🟡hydracept_prepare_adapter_selection(adapters)
Normalize several LoRA selections into the exact image.generate.v1 input.adapters contract. For one named LoRA, call hydracept_use_lora instead. This does not submit or spend money. Select only route-compatible entries.
輸入結構描述
{
"type": "object",
"properties": {
"adapters": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Adapters"
}
},
"title": "hydracept_prepare_adapter_selectionArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_prepare_adapter_selectionDictOutput"
}🟡hydracept_create_adapter_alias(alias, adapter_id, weight, project_id, environment)
Create a stable semantic project alias for a registered adapter. Omitted project/environment arguments inherit the authenticated workspace binding. Catalog aliases may reference registrations that are not yet executable. Does not generate or spend money.
輸入結構描述
{
"type": "object",
"properties": {
"alias": {
"title": "Alias",
"type": "string"
},
"adapter_id": {
"title": "Adapter Id",
"type": "string"
},
"weight": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Weight"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"alias",
"adapter_id"
],
"title": "hydracept_create_adapter_aliasArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_create_adapter_aliasDictOutput"
}⚪hydracept_promote_adapter_alias(alias, adapter_id, weight, project_id, environment)
Explicitly move a semantic alias to a new registered adapter/weight by creating a new immutable alias version. Omitted project/environment arguments inherit the authenticated workspace binding. Existing recipe bindings do not move. An alias serving as an active generation default must remain route-compatible unless the default is cleared first.
輸入結構描述
{
"type": "object",
"properties": {
"alias": {
"title": "Alias",
"type": "string"
},
"adapter_id": {
"title": "Adapter Id",
"type": "string"
},
"weight": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Weight"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"alias",
"adapter_id"
],
"title": "hydracept_promote_adapter_aliasArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_promote_adapter_aliasDictOutput"
}⚪hydracept_bind_adapter_alias(alias, version_id, project_id, environment)
Resolve a project alias to an immutable alias-version binding for persistence in a project recipe. Omitted project/environment arguments inherit the authenticated workspace binding. Omit version_id to pin the current version. Recipe pinning is allowed for catalog-only adapters; generation still requires a compatible route.
輸入結構描述
{
"type": "object",
"properties": {
"alias": {
"title": "Alias",
"type": "string"
},
"version_id": {
"default": "",
"title": "Version Id",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"alias"
],
"title": "hydracept_bind_adapter_aliasArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_bind_adapter_aliasDictOutput"
}🟡hydracept_set_adapter_default(alias, capability_key, project_id, environment)
Set a route-compatible semantic alias preselected for future image.generate.v1 work. Omitted project/environment arguments inherit the authenticated workspace binding. The default is not silently injected by the API; agents still send the resolved adapters[] selection.
輸入結構描述
{
"type": "object",
"properties": {
"alias": {
"title": "Alias",
"type": "string"
},
"capability_key": {
"default": "image.generate.v1",
"title": "Capability Key",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"alias"
],
"title": "hydracept_set_adapter_defaultArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_set_adapter_defaultDictOutput"
}🔴hydracept_clear_adapter_default(capability_key, project_id, environment)
Clear the project/environment image adapter default. Omitted project/environment arguments inherit the authenticated workspace binding. This does not alter the alias or its immutable history; clearing an environment override may reveal an inherited project-wide default.
輸入結構描述
{
"type": "object",
"properties": {
"capability_key": {
"default": "image.generate.v1",
"title": "Capability Key",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"title": "hydracept_clear_adapter_defaultArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_clear_adapter_defaultDictOutput"
}🟢hydracept_suggest_lora(query, project_id, environment)
Suggest a LoRA without registering it or spending money. query can be a project alias, a registered LoRA name, an adapter id, or a public Hugging Face link. Show the user the say field. If intent is use, pass inputPatch.adapters on image.generate.v1. If intent is suggest, wait for the user to agree, then call hydracept_use_lora with accept.arguments. If intent is choose, ask the question in say, then call hydracept_use_lora with file_path or base_model_family. Do not invent repository paths, commits, weight filenames, or base-model families.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"query"
],
"title": "hydracept_suggest_loraArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_suggest_loraDictOutput"
}🟡hydracept_use_lora(query, file_path, base_model_family, refresh, project_id, ...)
Use one LoRA on image generation, or add an unambiguous public Hugging Face LoRA and then use it. Does not generate an image or spend money. Pass a project alias, registered name, adapter id, or the same query hydracept_suggest_lora returned. Pass file_path only after a suggestion says to choose a weights file. Pass base_model_family only after a suggestion says the base model is missing. Pass refresh=true only when the suggestion says a newer commit is available. When inputPatch is present, pass inputPatch.adapters on image.generate.v1. Do not fill adapter ids, file paths, or base-model families yourself.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"file_path": {
"default": "",
"title": "File Path",
"type": "string"
},
"base_model_family": {
"default": "",
"title": "Base Model Family",
"type": "string"
},
"refresh": {
"default": false,
"title": "Refresh",
"type": "boolean"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"query"
],
"title": "hydracept_use_loraArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_use_loraDictOutput"
}🟢hydracept_register_model_adapter(display_name, source_kind, source_ref, base_model_family, source_revision, ...)
Register a reusable project LoRA without generating or spending money. Prefer hydracept_suggest_lora and hydracept_use_lora for a project name or a public Hugging Face link. Use this tool for provider_ref or hydracept_artifact sources, or when the caller already has every source field. source_kind must be provider_ref, huggingface, or hydracept_artifact. source_ref is namespace/repository; source_file_path may identify an explicit public .safetensors file. If file path is omitted the repository is cataloged but remains non-executable. When a file path is supplied, Hydracept validates it and freezes the Hub commit. For hydracept_artifact, source_ref is a project artifactId and Hydracept binds its immutable content hash. For provider_ref, source_provider is required. Omitted project/environment arguments inherit the authenticated workspace binding. Inspect sourceHealth and routingReadiness.routeCompatible in the result before quoting generation.
輸入結構描述
{
"type": "object",
"properties": {
"display_name": {
"title": "Display Name",
"type": "string"
},
"source_kind": {
"title": "Source Kind",
"type": "string"
},
"source_ref": {
"title": "Source Ref",
"type": "string"
},
"base_model_family": {
"default": "flux",
"title": "Base Model Family",
"type": "string"
},
"source_revision": {
"default": "",
"title": "Source Revision",
"type": "string"
},
"source_file_path": {
"default": "",
"title": "Source File Path",
"type": "string"
},
"source_provider": {
"default": "",
"title": "Source Provider",
"type": "string"
},
"recommended_weight": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Recommended Weight"
},
"trigger_words": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Trigger Words"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"display_name",
"source_kind",
"source_ref"
],
"title": "hydracept_register_model_adapterArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_register_model_adapterDictOutput"
}🟡hydracept_preview_lora_source(query, project_id, environment)
Low-level lookup for a public Hugging Face LoRA link. Prefer hydracept_suggest_lora, which also matches project aliases and returns a generation patch or a confirmation. Returns the pinned commit, weight files, detected base-model family, suggested name, strength, and trigger words. Does not register an adapter, download weight tensors, or spend money. A detected family with executable=false can be saved but current image routes cannot run it.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"query"
],
"title": "hydracept_preview_lora_sourceArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_preview_lora_sourceDictOutput"
}🟢hydracept_revalidate_model_adapter(adapter_id)
Re-check the frozen source identity for a registered adapter without generating or spending money. For Hugging Face this checks the already-pinned commit and file; it never advances a branch or tag. For Hydracept artifacts it rechecks immutable content and safetensors structure. Provider-native refs are opaque and remain declared. Use this when sourceHealth is stale, unavailable, or invalid.
輸入結構描述
{
"type": "object",
"properties": {
"adapter_id": {
"title": "Adapter Id",
"type": "string"
}
},
"required": [
"adapter_id"
],
"title": "hydracept_revalidate_model_adapterArguments"
}輸出結構描述
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_revalidate_model_adapterDictOutput"
}社群
證據