К содержанию
TelegaFirst

Для AI-агентов: markdown этой страницы — /docs/api-op-getagentconfig.mdиндекс документации — /llms.txt

getAgentConfig

Обновлено

GET /api/v1/tools/agents

Read the tenant AI agent configuration

Авторизация и права

Scopes: ALL. Auth alternatives: OR; scopes внутри альтернативы: ALL.

ПолеЗначение
security.0.hubApiKey[]
security.1.hubBearer[]
securitySchemes.hubApiKey.in"header"
securitySchemes.hubApiKey.name"X-Api-Key"
securitySchemes.hubApiKey.type"apiKey"
securitySchemes.hubBearer.scheme"bearer"
securitySchemes.hubBearer.type"http"
x-required-scopes["agents:read"]

Параметры запроса

ПолеЗначение
Параметры[]

Тело запроса

ПолеЗначение
Тело запросаnull

Ответы

ПолеЗначение
200.content.application/json.schemaAgentConfig
200.description"Merged Manager/Qualifier and Coach configuration. No internal row IDs."
200.headers.X-Bot-Username.schema200.headers.X-Bot-Username.schema
200.headers.X-Client-Slug.schema200.headers.X-Client-Slug.schema
200.headers.X-RateLimit-Limit.schema200.headers.X-RateLimit-Limit.schema
200.headers.X-RateLimit-Remaining.schema200.headers.X-RateLimit-Remaining.schema
200.headers.X-RateLimit-Reset.schema200.headers.X-RateLimit-Reset.schema

Ошибки

ПолеЗначение
401.content.application/problem+json.schemaProblemDetails
401.description"Missing, invalid, revoked or expired API credential. Surface-session JWTs are not accepted."
401.x-error-codes["INVALID_API_KEY"]
403.content.application/problem+json.schemaProblemDetails
403.description"Missing effective scope, forbidden publishable key, inaccessible tenant or no active bot."
403.x-error-codes["INSUFFICIENT_SCOPE","PUBLISHABLE_KEY_NOT_ALLOWED","FORBIDDEN","NO_ACTIVE_BOT"]
413.content.application/problem+json.schemaProblemDetails
413.description"Per-tool payload size or item-count limit exceeded before validation."
413.x-error-codes["PAYLOAD_TOO_LARGE","ITEM_COUNT_EXCEEDED"]
429.content.application/problem+json.schemaProblemDetails
429.description"Per-tool rate limit exceeded or unavailable; fail closed."
429.headers.Retry-After.requiredfalse
429.headers.Retry-After.schema429.headers.Retry-After.schema
429.x-error-codes["RATE_LIMIT_EXCEEDED","RATE_LIMIT_UNAVAILABLE"]
500.content.application/problem+json.schemaProblemDetails
500.description"Unexpected internal failure."
500.x-error-codes["INTERNAL_ERROR"]

Дополнительные условия

ПолеЗначение
description"Tenant singleton configuration. This controls persona and prompts; it never authorizes internal Qualifier, Manager or Coach agents to mutate orders or money. Those agents advise and hand off; scoped tenant-agent money commands belong to the separate Hub money operations. No pagination, ETag or If-Match."
operationId"getAgentConfig"
summary"Read the tenant AI agent configuration"
tags["agents"]
x-idempotency.kind"none"
x-pagination.kind"none"