File attachments

The current Narada SDK uploads file attachments automatically when you pass a file-like object to Agent.run(attachment=...) or input_variables={...}. You do not need to call a separate public upload_file() method.

Attachments are useful for document analysis, data extraction, and workflows where the agent needs to process file content.

Method Signature

async def run(
    self,
    prompt: str,
    *,
    attachment: File | IO[Any] | None = None,
    ...
) -> AgentResponse

Parameters

attachment

File | IO[Any] | None

default:"None"

A file-like object opened in binary read mode, or a File object returned by a lower-level upload flow.

with open("/path/to/document.pdf", "rb") as f:
    response = await agent.run(
        prompt="Summarize the attached document.",
        attachment=f,
    )

Return Value

Agent.run() returns an AgentResponse. For text responses, read response.text. For structured output, read response.structured_output.

Example

import asyncio

from narada import Agent, AgentKind, BrowserEnvironment

async def main():
    env = BrowserEnvironment()
    agent = Agent(environment=env, kind=AgentKind.CORE_AGENT)

    try:
        with open("/path/to/report.pdf", "rb") as f:
            response = await agent.run(
                prompt="Summarize the key points from the attached report.",
                attachment=f,
            )

        print(f"Summary: {response.text}")
    finally:
        await env.close()

if __name__ == "__main__":
    asyncio.run(main())

You can also pass file-like objects inside input_variables; the SDK uploads them before dispatching the request.

closeGracefully close the current browser environment

​Method Signature

​Parameters

​Return Value

​Example

Method Signature

Parameters

Return Value

Example