ecosystem.agents
Connecta qualsevol agent. Governa'ls tots.
Tant li fa amb quin framework estigui construït, qui el mantingui o on s'executi: si emet telemetria, entra. Tres camins d'entrada, una sola taula de traces i el mateix govern per a tots.
agent.origin
Tres procedències, un únic registre
Un parc d'agents real mai no és homogeni. El que importa no és d'on ve cadascun, sinó que tots es vegin al mateix lloc i sota les mateixes regles.
Els agents que ja tens
Construïts amb el framework que sigui, a la teva infraestructura o a la d'un tercer. Es registren amb el seu nom de servei, reben la seva clau i comencen a emetre. No cal reescriure'ls.
Els que construeixes amb AKP
AKP és el kernel amb què Social Labs implanta agents a mida per a grans clients. Porta de sèrie els connectors de política, traces i telemetria cap a Regentic.AI: s'activen apuntant-los a la teva instància, sense cap integració a escriure.
Els de la mateixa plataforma
Regentic.AI executa els seus propis agents per analitzar, avaluar i redactar. Estan donats d'alta al mateix registre i emeten a la mateixa taula, marcats com a agents de plataforma.
ingest.plans
Tres plans d'integració
L'elecció és de transport, no de funcionalitat: els tres escriuen a la mateixa taula de traces i es veuen idèntics al producte. Tria el que et generi menys fricció.
OpenTelemetry natiu
Si els teus agents ja estan instrumentats amb OpenTelemetry, no hi ha integració a escriure: s'apunta l'exportador a la teva instància i llestos.
- endpoint
https://<la-teva-instancia>/v1/traces- autenticació
Authorization: Bearer agv_…
- Ja tens traçat amb OpenTelemetry o MLflow Tracing
- Vols el detall complet de spans sense adaptar formats
- Prefereixes passar per un Collector propi
# point your existing OpenTelemetry exporter at Regentic.AI
export OTEL_EXPORTER_OTLP_ENDPOINT="https://<your-instance>"
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer agv_..."
export OTEL_SERVICE_NAME="customer-support-bot"API REST
Un POST amb el mateix model de dades en JSON. És la via quan no pots muntar OpenTelemetry o quan la xarxa t'ho posa difícil.
- endpoint
POST https://<la-teva-instancia>/api/v1/otel-traces- autenticació
X-Agent-Key: agv_…
- No hi ha suport d'OTLP al teu entorn
- Prefereixes controlar tu l'enviament i els reintents
- Vols començar avui amb una crida HTTP
curl -X POST https://<your-instance>/api/v1/otel-traces \
-H "X-Agent-Key: agv_..." \
-H "Content-Type: application/json" \
-d '{
"trace_id": "3f9a...",
"spans": [{
"span_id": "a1b2...",
"name": "agent-run",
"attributes": {
"gen_ai.request.model": "gpt-4o-mini",
"gen_ai.usage.input_tokens": 142,
"gen_ai.usage.output_tokens": 387
}
}]
}'
# 202 Accepted -> {"accepted": 1, "trace_ids": ["3f9a..."]}Model Context Protocol
L'agent consumeix la governança com a eines MCP: consulta la política abans d'actuar i reporta el resultat després, tot dins de la mateixa traça.
- endpoint
https://<la-teva-instancia>/mcp- autenticació
Authorization: Bearer agv_…
- El teu agent ja parla MCP
- Vols que la governança sigui una eina més de l'agent
- T'interessa correlacionar decisió i resultat a la mateixa traça
{
"mcpServers": {
"regentic": {
"url": "https://<your-instance>/mcp",
"headers": { "Authorization": "Bearer agv_..." }
}
}
}El que arriba per qualsevol dels tres camins aterra a la mateixa taula i alimenta exactament els mateixos mòduls. Canviar de pla més endavant no t'obliga a refer res del que ja tens.
agent.identity
Cada traça pertany a algú, i es pot demostrar
En un sistema de govern, la telemetria que es pot falsificar no val res. La identitat de l'agent s'ancora a la seva clau, no al que el mateix agent declari.
- Cada agent té la seva clau amb prefix propi i el seu nom de servei únic
- El nom de servei que vingui a l'enviament se sobreescriu amb el de l'agent autenticat; el declarat es conserva a part com a dada forense
- En llegir, un agent només veu la seva pròpia telemetria: no pot consultar la d'un altre
- Les claus dels agents de la plataforma no serveixen per ingerir, així que ningú no pot emetre fent-se passar per ells
- Les claus es poden rotar sense donar de baixa l'agent ni perdre'n l'històric
# what the agent claims in its payload
resource.service.name = "some-other-agent"
# what Regentic.AI actually stores
service_name = "customer-support-bot" # from the API key
client.reported_service_name = "some-other-agent" # kept as forensic dataEl nom de servei és la identitat canònica de l'agent a tot el sistema: és el que relaciona una traça solta amb la seva fitxa al registre i amb el seu perfil de compliment.
mcp.loop
El bucle complet: consultar, actuar, reportar
Amb MCP l'agent pregunta abans d'actuar i reporta després. Totes dues crides pengen de la mateixa traça, de manera que la decisió i el seu resultat queden units i es poden auditar plegats.
Les sis eines
- check_policy
- report_result
- report_trace
Els seus noms provenen d'una guia d'integració signada i no es poden canviar.
- get_stats
- query_traces
- get_trace
Amplien el contracte i estan sempre acotades a l'agent que autentica: inclouen comprovació de propietat, així que demanar una traça aliena retorna «no trobada».
# 1 — ask before acting; returns the ids of the span it just wrote
policy = check_policy("query_knowledge_base", {"kb": "moves-iii"})
# -> { "allowed": true, "policy_id": "OBS-DEFAULT", "mode": "observation", ... }
# 2 — the agent does its work
answer = agent.run(question)
# 3 — report back, hanging off the very same trace
report_result(
action="query_knowledge_base",
result={"status": "ok", "tokens": 529},
trace_id=policy["trace_id"],
parent_span_id=policy["span_id"],
)Què fa avui check_policy, exactament
Opera en mode observació: instrumenta la consulta i retorna sempre permès, amb la política OBS-DEFAULT. No intercepta ni impedeix cap acció. El que aporta és el registre auditable que en aquell punt de l'execució es va consultar la política — no un control d'admissió. Si el teu requisit és bloquejar en temps real, avui no ho cobrim i preferim dir-t'ho ara.
agent.origin=platform
La plataforma es governa a si mateixa
Els agents que Regentic.AI executa per dins són al mateix registre que els teus, amb la seva classificació de risc declarada, el seu mecanisme de supervisió i la seva telemetria a la mateixa taula. És la prova més barata que el model funciona: ens l'apliquem primer a nosaltres.
regentic-analystExpert en Dades
L'agent conversacional del xat. Consulta la telemetria en només lectura i retorna respostes amb els seus gràfics i els seus enllaços verificats.
conversationalrisc limitatregentic-judgeAvaluador de Telemetria
Puntua les execucions registrades en les cinc dimensions de qualitat i deixa el raonament com a evidència.
monitoringrisc mínimregentic-reporterRedactor d'Informes
Redacta la narrativa dels informes sobre xifres ja calculades. Emet la seva pròpia traça, amb el seu model i el seu consum.
automationrisc mínim
faq.integration
Preguntes freqüents
Quins frameworks d'agents doneu suport?
La pregunta correcta és quins formats de telemetria entenem, i aquí la resposta és àmplia: a més de les convencions semàntiques d'OpenTelemetry per a GenAI, es normalitzen els formats de MLflow, OpenInference i els objectes d'ús genèrics. Si el teu framework emet tokens i model d'alguna d'aquestes maneres, els llegim sense que els hagis d'adaptar.
He de triar un pla per sempre?
No. Els tres escriuen a la mateixa taula i produeixen exactament el mateix resultat al producte. Pots començar per REST perquè és el més ràpid i passar a OpenTelemetry quan tinguis el Collector muntat, sense perdre res del que ja has ingerit.
Un agent pot veure la telemetria d'un altre?
No. Amb clau d'agent, les consultes queden forçades al seu propi nom de servei, i demanar una traça que no li pertany retorna «no trobada». L'aïllament no depèn que l'agent es comporti bé.
Què passa si un agent declara un nom de servei que no és el seu?
Que no li serveix de res. El nom canònic de l'agent autenticat sobreescriu el que vingui a l'enviament, i el declarat es desa a part precisament per poder investigar-ho. La identitat s'ancora a la clau.
Regentic.AI pot impedir que un agent executi una acció?
No. La consulta de política es registra però sempre permet: és observació, no control d'admissió. El que obtens és l'evidència que la decisió es va prendre i amb quin resultat, no la capacitat de vetar-la.
Quanta feina és connectar el primer agent?
Registrar l'agent, copiar-ne la clau i apuntar l'exportador o fer un POST. El que sol portar més temps no és la integració, sinó posar-se d'acord internament sobre quins agents existeixen — que és justament el problema que resol el registre.
Comença per un agent
No cal un programa de governança per començar. Cal un agent emetent traces i algú mirant-se-les.