Skip to content

build_rest_asgi

autogen.beta.a2a.transports.rest.build_rest_asgi #

build_rest_asgi(*, agent_executor, agent_card, extended_agent_card=None, card_modifier=None, extended_card_modifier=None, task_store=None, push_config_store=None, push_sender=None, path_prefix='', card_url=DEFAULT_AGENT_CARD_PATH, legacy_card_url=LEGACY_AGENT_CARD_PATH)

Starlette ASGI app exposing REST dispatch + agent-card discovery.

Card routes MUST precede REST routes: the REST router includes a Mount(path='/{tenant}', ...) catch-all that swallows any /<segment>/... path (including /.well-known/agent-card.json).

Source code in autogen/beta/a2a/transports/rest.py 
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
def build_rest_asgi(
    *,
    agent_executor: AgentExecutor,
    agent_card: AgentCard,
    extended_agent_card: AgentCard | None = None,
    card_modifier: CardModifier | None = None,
    extended_card_modifier: ExtendedCardModifier | None = None,
    task_store: TaskStore | None = None,
    push_config_store: PushNotificationConfigStore | None = None,
    push_sender: PushNotificationSender | None = None,
    path_prefix: str = "",
    card_url: str = DEFAULT_AGENT_CARD_PATH,
    legacy_card_url: str | None = LEGACY_AGENT_CARD_PATH,
) -> Starlette:
    """Starlette ASGI app exposing REST dispatch + agent-card discovery.

    Card routes MUST precede REST routes: the REST router includes a
    ``Mount(path='/{tenant}', ...)`` catch-all that swallows any
    ``/<segment>/...`` path (including ``/.well-known/agent-card.json``).
    """
    agent_card = clone_card_with_capabilities(
        agent_card,
        extended=extended_agent_card is not None,
        push=push_config_store is not None,
    )
    handler = build_default_handler(
        agent_executor=agent_executor,
        agent_card=agent_card,
        extended_agent_card=extended_agent_card,
        extended_card_modifier=extended_card_modifier,
        task_store=task_store,
        push_config_store=push_config_store,
        push_sender=push_sender,
    )
    routes: list[BaseRoute] = build_card_routes_with_legacy(
        agent_card,
        card_modifier=card_modifier,
        card_url=card_url,
        legacy_card_url=legacy_card_url,
    )
    routes.extend(create_rest_routes(handler, path_prefix=path_prefix))
    return Starlette(routes=routes)