Lattice.Hub
GitHub

Lattice Hub Docs
HTTP OpenAPIAI Registry

A2A Registry

A2A Agent / Skill registry.

A2A Agent / Skill registry.

Default Base URL: http://127.0.0.1:8090. Management APIs require Authorization (token from login).

A2A Registry

A2A Agent / Skill registry; control plane does not proxy the data plane.

GET/ai/a2a/v1/agentsAuth required

List A2A agents

List agents from the registry.

Parameters

  • Authorizationheader · stringrequired

    Token from login.

  • namequery · stringoptional

    按名称过滤。

  • namespacequery · stringoptional

    命名空间。

  • businessquery · stringoptional

    业务。

  • departmentquery · stringoptional

    部门。

  • protocol_bindingquery · stringoptional

    协议绑定。

  • skill_tagquery · stringoptional

    技能标签。

  • backend_typequery · stringoptional

    后端类型。

  • backend_service_namespacequery · stringoptional

    后端服务命名空间。

  • backend_service_namequery · stringoptional

    后端服务名。

  • streamingquery · booloptional

    是否流式。

  • push_notificationsquery · booloptional

    是否推送通知。

  • offsetquery · uint32optional

    分页偏移。

  • limitquery · uint32optional

    分页大小。

Request
curl -sS 'http://127.0.0.1:8090/ai/a2a/v1/agents' \
  -H "Authorization: $TOKEN"
Response example
{
  "code": 200000,
  "info": "execute success",
  "agents": [{ "name": "support-agent" }]
}
POST/ai/a2a/v1/agentsAuth required

Create A2A agents

Create agents; body fields follow runtime.

Parameters

  • Authorizationheader · stringrequired

    Token from login.

  • (body)body · A2AAgent[]required

    Request body is a JSON array of A2AAgent: [{...}, ...]. Fields below are the full per-item schema (including nested).

  • idbody · stringoptional

    Agent ID。

  • namebody · stringrequired

    Agent 名称。

  • namespacebody · stringrequired

    命名空间。

  • visibilitybody · stringoptional

    可见性。

  • descriptionbody · stringoptional

    描述。

  • versionbody · stringoptional

    Agent 版本。

  • protocol_versionbody · stringoptional

    协议版本。

  • provider_organizationbody · stringoptional

    提供方组织。

  • provider_urlbody · stringoptional

    提供方 URL。

  • documentation_urlbody · stringoptional

    文档 URL。

  • icon_urlbody · stringoptional

    图标 URL。

  • businessbody · stringoptional

    业务。

  • departmentbody · stringoptional

    部门。

  • backend_typebody · stringoptional

    后端类型：service / address。

  • backend_service_namespacebody · stringoptional

    backend_type=service 时的服务命名空间。

  • backend_service_namebody · stringoptional

    backend_type=service 时的服务名。

  • backend_addressbody · stringoptional

    backend_type=address 时的地址。

  • preferred_interface_urlbody · stringoptional

    首选接口 URL。

  • preferred_protocol_bindingbody · stringoptional

    首选协议绑定。

  • preferred_protocol_versionbody · stringoptional

    首选协议版本。

  • streamingbody · booloptional

    是否支持流式。

  • push_notificationsbody · booloptional

    是否支持推送通知。

  • extended_agent_cardbody · booloptional

    是否扩展 Agent Card。

  • raw_card_jsonbody · stringoptional

    原始 Agent Card JSON。

  • source_typebody · stringoptional

    来源类型。

  • source_urlbody · stringoptional

    来源 URL。

  • metadatabody · map<string,string>optional

    元数据。

  • interfacesbody · A2AAgentInterface[]optional

    接口列表。

    • idbody · stringoptional

      接口 ID。

    • agent_idbody · stringoptional

      所属 Agent ID。

    • urlbody · stringoptional

      接口 URL。

    • protocol_bindingbody · stringoptional

      协议绑定。

    • protocol_versionbody · stringoptional

      协议版本。

  • skillsbody · A2AAgentSkill[]optional

    技能列表。

    • idbody · stringoptional

      记录 ID。

    • agent_idbody · stringoptional

      所属 Agent ID。

    • skill_idbody · stringoptional

      技能 ID。

    • namebody · stringoptional

      技能名称。

    • descriptionbody · stringoptional

      描述。

    • tagsbody · string[]optional

      标签。

    • examplesbody · string[]optional

      示例。

    • input_modesbody · string[]optional

      输入模式。

    • output_modesbody · string[]optional

      输出模式。

    • security_requirements_jsonbody · stringoptional

      安全要求 JSON。

Response fields

  • codebody · uint32required

    Business code; success is usually 200000.

  • infobody · stringoptional

    Info message.

  • a2AAgentbody · A2AAgentoptional

    A2AAgent entity fields (batch APIs nest under responses[]).

    • idbody · stringoptional

      Agent ID。

    • namebody · stringoptional

      Agent 名称。

    • namespacebody · stringoptional

      命名空间。

    • visibilitybody · stringoptional

      可见性。

    • descriptionbody · stringoptional

      描述。

    • versionbody · stringoptional

      Agent 版本。

    • protocol_versionbody · stringoptional

      协议版本。

    • provider_organizationbody · stringoptional

      提供方组织。

    • provider_urlbody · stringoptional

      提供方 URL。

    • documentation_urlbody · stringoptional

      文档 URL。

    • icon_urlbody · stringoptional

      图标 URL。

    • businessbody · stringoptional

      业务。

    • departmentbody · stringoptional

      部门。

    • backend_typebody · stringoptional

      后端类型：service / address。

    • backend_service_namespacebody · stringoptional

      backend_type=service 时的服务命名空间。

    • backend_service_namebody · stringoptional

      backend_type=service 时的服务名。

    • backend_addressbody · stringoptional

      backend_type=address 时的地址。

    • preferred_interface_urlbody · stringoptional

      首选接口 URL。

    • preferred_protocol_bindingbody · stringoptional

      首选协议绑定。

    • preferred_protocol_versionbody · stringoptional

      首选协议版本。

    • streamingbody · booloptional

      是否支持流式。

    • push_notificationsbody · booloptional

      是否支持推送通知。

    • extended_agent_cardbody · booloptional

      是否扩展 Agent Card。

    • raw_card_jsonbody · stringoptional

      原始 Agent Card JSON。

    • source_typebody · stringoptional

      来源类型。

    • source_urlbody · stringoptional

      来源 URL。

    • metadatabody · map<string,string>optional

      元数据。

    • interfacesbody · A2AAgentInterface[]optional

      接口列表。

      • idbody · stringoptional

        接口 ID。

      • agent_idbody · stringoptional

        所属 Agent ID。

      • urlbody · stringoptional

        接口 URL。

      • protocol_bindingbody · stringoptional

        协议绑定。

      • protocol_versionbody · stringoptional

        协议版本。

    • skillsbody · A2AAgentSkill[]optional

      技能列表。

      • idbody · stringoptional

        记录 ID。

      • agent_idbody · stringoptional

        所属 Agent ID。

      • skill_idbody · stringoptional

        技能 ID。

      • namebody · stringoptional

        技能名称。

      • descriptionbody · stringoptional

        描述。

      • tagsbody · string[]optional

        标签。

      • examplesbody · string[]optional

        示例。

      • input_modesbody · string[]optional

        输入模式。

      • output_modesbody · string[]optional

        输出模式。

      • security_requirements_jsonbody · stringoptional

        安全要求 JSON。

Request
curl -sS -X POST 'http://127.0.0.1:8090/ai/a2a/v1/agents' \
  -H "Authorization: $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '[{"name":"support-agent"}]'
Response example
{
  "code": 200000,
  "info": "execute success",
  "amount": 1
}
GET/ai/a2a/v1/agent/skillsAuth required

List agent skills

List agent skills.

Parameters

  • Authorizationheader · stringrequired

    Token from login.

  • agent_idquery · stringoptional

    Agent ID.

Request
curl -sS 'http://127.0.0.1:8090/ai/a2a/v1/agent/skills?agent_id=<id>' \
  -H "Authorization: $TOKEN"
Response example
{
  "code": 200000,
  "info": "execute success",
  "amount": 1
}
GET/ai/a2a/v1/agents/{id}/cardAuth required

Get Agent Card

Read Agent Card metadata.

Parameters

  • Authorizationheader · stringrequired

    Token from login.

  • idpath · stringrequired

    Agent ID.

Request
curl -sS 'http://127.0.0.1:8090/ai/a2a/v1/agents/<id>/card' \
  -H "Authorization: $TOKEN"
Response example
{
  "code": 200000,
  "info": "execute success",
  "card": { "name": "support-agent", "url": "https://..." }
}
PUT/ai/a2a/v1/agentsAuth required

Update A2A agents

Update A2A agents.

Parameters

  • Authorizationheader · stringrequired

    Token from login.

  • (body)body · A2AAgent[]required

    JSON array of A2AAgent; fields below are per-item.

  • idbody · stringoptional

    Agent ID。

  • namebody · stringoptional

    名称。

  • namespacebody · stringoptional

    命名空间。

  • descriptionbody · stringoptional

    描述。

  • backend_typebody · stringoptional

    后端类型。

  • backend_addressbody · stringoptional

    后端地址。

  • backend_service_namespacebody · stringoptional

    后端服务命名空间。

  • backend_service_namebody · stringoptional

    后端服务名。

  • raw_card_jsonbody · stringoptional

    原始 Card JSON。

  • metadatabody · map<string,string>optional

    元数据。

Response fields

  • codebody · uint32required

    Business code.

  • infobody · stringoptional

    Info.

  • A2AAgentbody · A2AAgentoptional

    Entity fields.

    • idbody · stringoptional

      Agent ID。

    • namebody · stringoptional

      名称。

    • namespacebody · stringoptional

      命名空间。

    • descriptionbody · stringoptional

      描述。

    • backend_typebody · stringoptional

      后端类型。

    • backend_addressbody · stringoptional

      后端地址。

    • backend_service_namespacebody · stringoptional

      后端服务命名空间。

    • backend_service_namebody · stringoptional

      后端服务名。

    • raw_card_jsonbody · stringoptional

      原始 Card JSON。

    • metadatabody · map<string,string>optional

      元数据。

Request
curl -sS -X PUT 'http://127.0.0.1:8090/ai/a2a/v1/agents' \
  -H "Authorization: $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '[]'
Response example
{
  "code": 200000,
  "info": "execute success"
}
POST/ai/a2a/v1/agents/deleteAuth required

Delete A2A agents

Delete A2A agents.

Parameters

  • Authorizationheader · stringrequired

    Token from login.

  • agent_idsbody · string[]optional

    Agent ID 列表。

Response fields

  • codebody · uint32required

    Business code.

  • infobody · stringoptional

    Info.

  • A2AAgentDeleteRequestbody · A2AAgentDeleteRequestoptional

    Entity fields.

    • agent_idsbody · string[]optional

      Agent ID 列表。

Request
curl -sS -X POST 'http://127.0.0.1:8090/ai/a2a/v1/agents/delete' \
  -H "Authorization: $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '[]'
Response example
{
  "code": 200000,
  "info": "execute success"
}

MCP Registry

MCP Server / Tool registry.

Client APIs

Discover, Register, Heartbeat, and client config pull.

On this page

GET List A2A agentsPOST Create A2A agentsGET List agent skillsGET Get Agent CardPUT Update A2A agentsPOST Delete A2A agents