	In Browser
	StumbleUpon
	del.icio.us
	Google
	Google Buzz
	reddit
	LinkedIn

	Facebook
	Twitter
	Linkedin
	E-Mail

Generative AI > Google Gemini API > ADK with Google Docs - Document Generation

ADK with Google Docs - Document Generation

Author: Venkata Sudhakar

ADK agents can generate professional documents by writing directly to Google Docs - creating purchase orders, incident reports, and meeting minutes from structured data without any manual formatting. ShopMax India uses a Docs-connected agent to draft monthly vendor performance reports and store them in a shared Drive folder for review.

The Docs API uses batchUpdate requests to insert text, apply paragraph styles, and build tables. The simplest approach is to create a new document, insert content using insertText requests, and then share the document link with the requester. For recurring document formats, a template document with named placeholders can be copied and filled using replaceAllText.

The below example shows an ADK agent that creates a vendor performance report as a Google Doc.

from google.adk.agents import LlmAgent
from google.adk.tools import FunctionTool
from google.adk.sessions import InMemorySessionService
from google.adk.runners import Runner
from google.oauth2 import service_account
from googleapiclient.discovery import build

SCOPES = [
    "https://www.googleapis.com/auth/documents",
    "https://www.googleapis.com/auth/drive.file",
]
TEMPLATE_DOC_ID = "1abc123XYZtemplate"  # copy this template per report

def get_services():
    creds = service_account.Credentials.from_service_account_file(
        "/secrets/sa-key.json", scopes=SCOPES
    )
    docs = build("docs", "v1", credentials=creds)
    drive = build("drive", "v3", credentials=creds)
    return docs, drive

def create_vendor_report(vendor_name: str, month: str,
                          on_time_pct: float, defect_pct: float,
                          total_orders: int, notes: str) -> dict:
    """Create a vendor performance report Google Doc from template."""
    docs, drive = get_services()
    # Copy template
    copy = drive.files().copy(
        fileId=TEMPLATE_DOC_ID,
        body={"name": f"Vendor Report - {vendor_name} - {month}"}
    ).execute()
    doc_id = copy["id"]
    # Replace placeholders
    replacements = [
        ("{{VENDOR}}", vendor_name),
        ("{{MONTH}}", month),
        ("{{ON_TIME}}", f"{on_time_pct:.1f}%"),
        ("{{DEFECT}}", f"{defect_pct:.1f}%"),
        ("{{ORDERS}}", str(total_orders)),
        ("{{NOTES}}", notes),
    ]
    requests = [
        {"replaceAllText": {
            "containsText": {"text": old, "matchCase": True},
            "replaceText": new,
        }} for old, new in replacements
    ]
    docs.documents().batchUpdate(documentId=doc_id, body={"requests": requests}).execute()
    # Share with ShopMax procurement team
    drive.permissions().create(
        fileId=doc_id,
        body={"type": "user", "role": "reader", "emailAddress": "procurement@shopmax.in"}
    ).execute()
    link = f"https://docs.google.com/document/d/{doc_id}/edit"
    return {"status": "created", "doc_id": doc_id, "link": link}

agent = LlmAgent(
    name="shopmax_docs_agent",
    model="gemini-2.0-flash",
    instruction="You are a ShopMax procurement agent. Generate vendor performance reports as Google Docs when given vendor data.",
    tools=[FunctionTool(create_vendor_report)],
)

session_service = InMemorySessionService()
runner = Runner(agent=agent, session_service=session_service)
events = list(runner.run(
    user_id="procurement", session_id="sess_docs_001",
    new_message={"role": "user", "parts": [{
        "text": "Create a March 2026 vendor report for Samsung India: 94% on-time, 1.2% defect rate, 340 orders. Note: improved packaging quality."
    }]},
))
print(next(e.content.parts[0].text for e in events if e.is_final_response()))

It gives the following output,

Vendor Performance Report created successfully.

  Vendor   : Samsung India
  Month    : March 2026
  On-Time  : 94.0%
  Defect   : 1.2%
  Orders   : 340
  Notes    : Improved packaging quality

Document shared with [email protected]
Link: https://docs.google.com/document/d/1XYZabc.../edit

For bulk report generation, use a ParallelAgent to create reports for all vendors simultaneously. Store document IDs in Firestore keyed by vendor and month to avoid duplicates. Add a second ADK agent step that reads the completed doc and sends a summary email via Gmail to the category manager using the template replace pattern demonstrated here.

Send your comments, suggestions or queries regarding this site to [email protected].