এজেন্ট আইডেন্টিটি ও Auth Manager-এর সাহায্যে ব্যবহারকারীর হয়ে কাজ করে এমন AI এজেন্ট তৈরি করা

১. ভূমিকা

বিস্তৃত অনুমতি সহ নিজস্ব ক্রেডেনশিয়াল থাকা এজেন্ট প্রত্যেকের ডেটা দেখতে পায়। এই কোডল্যাবে আপনি এমন একটি এজেন্ট তৈরি করবেন যা সাইন-ইন করা ব্যবহারকারীর নিজস্ব ক্রেডেনশিয়াল সহ থার্ড-পার্টি API কল করে, যাতে এটি ঠিক সেই ব্যক্তির মতো দেখতে পায় এবং তার বেশি কিছু নয়।

আপনি এটি Google Agent Development Kit (ADK) এবং Gemini Enterprise-এর মাধ্যমে তৈরি করবেন।

বিশেষ করে, আপনি শিখবেন কীভাবে একটি ডুয়াল-আইডেন্টিটি আর্কিটেকচার ডিজাইন করতে হয় যেখানে:

  1. এজেন্ট নিজের হয়ে কাজ করে (এজেন্ট আইডেন্টিটি): SPIFFE-ব্যাকড এজেন্ট আইডেন্টিটি ব্যবহার করে, এজেন্ট Auth Manager-কে ইনভোক করে, টেলিমেট্রি স্টোর করে এবং Google Cloud API-কে কল করে।
  2. এজেন্ট ব্যবহারকারীর হয়ে কাজ করে (ব্যবহারকারী-প্রতিনিধি পরিচয়): GitHub-এর মতো এক্সটার্নাল রিসোর্স অ্যাক্সেস করতে, এজেন্ট ব্যবহারকারীর ক্রেডেনশিয়াল ব্যবহার করে নিরাপদে টুল কোয়েরি করার জন্য ৩-লেগড OAuth (3LO) সম্মতি ফ্লো ট্রিগার করে।

ডুয়াল আইডেন্টিটি আর্কিটেকচার

এটি করার জন্য, আপনি শিখবেন কীভাবে:

  1. GitHub-এর মডেল কন্টেক্সট প্রোটোকল (MCP) সার্ভারের সাথে কানেক্ট করে এমন ADK এজেন্ট তৈরি করা।
  2. Google Cloud Auth Manager ব্যবহার করে এজেন্টের টুল স্ট্যাটিক GitHub PAT (ব্যক্তিগত অ্যাক্সেস টোকেন) থেকে 3-লেগড OAuth (3LO) ফ্লোতে আপডেট করুন।
  3. এজেন্ট রানটাইমে এজেন্টকে নিরাপদে ডিপ্লয় করুন এবং এজেন্ট আইডেন্টিটি প্রোভিশন করুন।
  4. ব্যবহারকারীর হয়ে টোকেন ভল্টে এজেন্টের পরিচয় অ্যাক্সেস করার সুবিধা দিতে IAM ভূমিকা কনফিগার করুন।
  5. Google Cloud-এ Auth Manager-এর জন্য এন্ড-টু-এন্ড 3LO ফ্লো সম্পর্কে জানুন।

পূর্বশর্ত

শুরু করার আগে, আপনার কাছে এগুলি আছে কিনা তা ভালোভাবে দেখে নিন:

  • বিলিং চালু করা আছে এমন একটি Google Cloud প্রোজেক্ট।
  • আপনার লোকাল মেশিনে প্রোজেক্টের জন্য Google Cloud SDK (gcloud CLI) ইনস্টল ও যাচাই করা হয়েছে। ভার্সন 586.0.0 বা তার পরবর্তী ভার্সন প্রয়োজন — gcloud components update রান করুন।
  • লোকাল ডিভাইসে Python 3.10 থেকে 3.13 ইনস্টল করা আছে।
  • uv প্যাকেজ ম্যানেজার ইনস্টল করা হয়েছে (pip install uv)।
  • OAuth অ্যাপ্লিকেশন রেজিস্টার করতে এবং টোকেন তৈরি করতে একটি GitHub অ্যাকাউন্ট। আপনার GitHub অ্যাকাউন্ট না থাকলে, আপনি থ্রি-লেগড OAuth 2.0 সাপোর্ট করে এমন যেকোনও থার্ড-পার্টি MCP সার্ভার ব্যবহার করতে পারেন।

২. প্রোজেক্ট সেট-আপ

১. Google Cloud-এ যাচাইকরণ করুন

এই ল্যাব চলাকালীন আপনার এনভায়রনমেন্টে Agent Runtime-এ ডিপ্লয়, Agent Identity-র ব্যবস্থা এবং Auth Manager কনফিগার করার জন্য প্রয়োজনীয় অনুমতি আছে কিনা তা নিশ্চিত করতে আপনার লোকাল কমান্ড লাইন থেকে Google Cloud-এ যাচাইকরণ করুন।

আপনার Google Cloud অ্যাকাউন্টে সাইন-ইন করতে, আপনার অ্যাক্টিভ প্রোজেক্ট সেট করতে (YOUR_PROJECT_ID-এর জায়গায় আপনার Google Cloud প্রোজেক্ট আইডি লিখুন) এবং অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল (ADC) কনফিগার করতে নিম্নলিখিত কমান্ড রান করুন:

gcloud auth login
gcloud config set project YOUR_PROJECT_ID
gcloud auth application-default login

২. প্রয়োজনীয় Google Cloud পরিষেবা চালু করুন

এই ল্যাব রান করতে আপনার Google Cloud প্রোজেক্টে প্রয়োজনীয় API চালু করুন। আপনার টার্মিনালে নিম্নলিখিত কমান্ড রান করুন:

gcloud services enable \
    agentidentity.googleapis.com \
    agentregistry.googleapis.com \
    aiplatform.googleapis.com \
    apphub.googleapis.com

এই কমান্ডটি কার্যকর করতে এক মিনিট সময় লাগতে পারে; একবার শেষ হয়ে গেলে, এটি API অ্যাক্টিভ আছে কিনা তা কনফার্ম করে কমান্ড প্রম্পটে ফিরে আসবে।

৩. এজেন্ট CLI ইনস্টল করে প্রোজেক্ট সেট-আপ করুন

agents-cli হল কমান্ড-লাইন টুল যা Gemini Enterprise-এ ADK এজেন্ট স্ক্যাফোল্ড, ম্যানেজ, টেস্ট ও ডিপ্লয় করতে ব্যবহার করা হয়। এটি লোকালি ইনস্টল করুন:

uvx google-agents-cli setup

আপনার ইনস্টলেশন যাচাই করুন:

agents-cli --help

CLI-এর সহায়তা মেনুতে উপলভ্য কমান্ড (যেমন deploy, run ও status) দেখতে পাবেন।

প্রাথমিক প্রোজেক্ট স্ক্যাফোল্ডিং জেনারেট করুন। আপনি একটি লোকাল প্রোটোটাইপ দিয়ে শুরু করবেন এবং পরে এজেন্ট রানটাইম ডিপ্লয়মেন্টের জন্য এটি উন্নত করবেন:

agents-cli create secure-agent-demo --prototype --yes

এটি secure-agent-demo ডিরেক্টরি তৈরি করে যাতে আপনার ফাউন্ডেশনাল এজেন্ট কোড, ডিপেন্ডেন্সি ও টেস্ট ফাইল থাকে।

৪. প্রয়োজনীয় ADK এক্সট্রা যোগ করুন

তৈরি করা pyproject.toml-এ বাদ যাওয়া দুটি অতিরিক্ত আইটেম যোগ করুন: GitHub টুলসেটের জন্য mcp এবং ল্যাবে পরে ব্যবহার করা Auth Manager-এর জন্য agent-identity। secure-agent-demo/pyproject.toml খুলুন এবং সম্পূর্ণ পরিবর্তন করুন

google-adk

ডিপেনডেন্সি লাইন এর সাথে:

"google-adk[agent-identity,gcp,mcp,otel-gcp]>=2.5.0,<3.0.0",

তারপর ইনস্টল করুন:

cd secure-agent-demo
agents-cli install

৩. এজেন্ট তৈরি ও পরীক্ষা করুন

১. এজেন্ট তৈরি করুন

আপনার প্রোজেক্টের মধ্যে, secure-agent-demo/app/agent.py-এ কোডটি পরিবর্তন করে নিম্নলিখিত কোডটি লিখুন:

# app/agent.py

from google.adk.agents import Agent
from google.adk.apps import App
from google.adk.models import Gemini
from google.genai import types

from app.tools import github_toolset

import os
import google.auth

_, project_id = google.auth.default()
os.environ["GOOGLE_CLOUD_PROJECT"] = project_id
os.environ["GOOGLE_CLOUD_LOCATION"] = "global"
os.environ["GOOGLE_GENAI_USE_VERTEXAI"] = "True"

INSTRUCTION = """You are the DevOps Assistant. You help developers list and triage their GitHub issues and pull requests.
Your capabilities: You have a GitHub MCP toolset that you can use to perform actions that the user requests.

Rules:
- NEVER write, update, or delete. You are only allowed read access.
- Act on behalf of the signed-in user.
- If a tool returns an authentication or authorization error, guide the user to sign in.
- NEVER fabricate information. Only report real issues returned by tools.
"""

root_agent = Agent(
    name="root_agent",
    model=Gemini(
        model="gemini-3.8-flash",
        retry_options=types.HttpRetryOptions(attempts=3),
    ),
    instruction=INSTRUCTION,
    tools=[github_toolset()],
)

app = App(
    root_agent=root_agent,
    name="app",
)

এই ফাইল এজেন্টের তিনটি মূল উপাদানকে সংজ্ঞায়িত করে:

  • সিস্টেম নির্দেশাবলী (INSTRUCTION): এটি পারসোনা সেট করে, GitHub ট্রায়াজে অ্যাসিস্ট্যান্টের স্কোপ নির্ধারণ করে এবং কঠোর নিরাপত্তা সংক্রান্ত নিয়ম (যেমন, শুধু পড়ার অ্যাক্সেস এবং কোনও সমস্যা হলে ব্যবহারকারীকে যাচাইকরণের জন্য নির্দেশ দেওয়া) প্রয়োগ করে।
  • এজেন্ট কনফিগারেশন (root_agent): gemini-3.8-flash মডেল ব্যবহার করে ADK Agent ইনস্ট্যান্টিয়েট করে, HTTP রিট্রাই লজিক কনফিগার করে এবং এজেন্টকে GitHub টুলসেট দিয়ে সজ্জিত করে।
  • অ্যাপ র‍্যাপার (app): রুট এজেন্টকে ADK App কন্টেনারে এনক্যাপসুলেট করে, যাতে এটি এজেন্ট রানটাইমে ডিপ্লয় করা যায়।

২. GitHub MCP টুল যোগ করুন

এজেন্টটি মডেল কন্টেক্সট প্রোটোকল (MCP) ব্যবহার করে GitHub-এর সাথে কানেক্ট করে। MCP গেটওয়ে কানেকশন প্যারামিটার রেজিস্টার করতে secure-agent-demo/app/tools.py-এ নতুন ফাইল তৈরি করুন। নিম্নলিখিত কোড কপি-পেস্ট করুন:

# app/tools.py

from __future__ import annotations
import os
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

GITHUB_MCP_URL = "https://api.githubcopilot.com/mcp/"
GITHUB_TOKEN = os.environ.get("GITHUB_TOKEN", "")

def github_toolset() -> McpToolset:
    """Returns the McpToolset connecting to the public GitHub Copilot MCP gateway."""
    return McpToolset(
        connection_params=StreamableHTTPConnectionParams(
            url=GITHUB_MCP_URL,
            headers={
                "Authorization": f"Bearer {GITHUB_TOKEN}",
                "X-MCP-Toolsets": "all",
                "X-MCP-Readonly": "true",
            },
        )
    )

এই ফাংশনটি এমন একটি টুল তৈরি করে যা GitHub-এর MCP সার্ভারকে কল করে:

  • MCP টুলসেট (McpToolset): কল করা যায় এমন এজেন্ট টুল হিসেবে GitHub-এর ক্ষমতা ডাইনামিকভাবে খুঁজে বের করে এবং রেজিস্টার করে।
  • কানেকশন প্যারামিটার (StreamableHTTPConnectionParams): টুলসেটকে GitHub-এর পাবলিক MCP গেটওয়ের দিকে নির্দেশ করে।
  • অনুমোদন হেডার: বিয়ারার টোকেন হিসেবে GITHUB_TOKEN ইনজেক্ট করে এবং ট্রান্সপোর্ট লেয়ারে সরাসরি কেবল পঠনযোগ্য মোড (X-MCP-Readonly: true) এনফোর্স করে।

৩. GitHub PAT (ব্যক্তিগত অ্যাক্সেস টোকেন) ব্যবহার করে লোকাল ডিভাইসে পরীক্ষা করা

স্ট্যাটিক ক্রেডেনশিয়াল সহ স্থানীয়ভাবে এজেন্ট চালাতে:

  1. GitHub-এর ব্যক্তিগত অ্যাক্সেস টোকেন পৃষ্ঠা থেকে ফাইন-গ্রেনড ব্যক্তিগত অ্যাক্সেস টোকেন তৈরি করুন:
    • নতুন টোকেন জেনারেট করুন বিকল্পে ক্লিক করে আপনার টোকেনের নাম দিন।
    • রিপোজিটরি অ্যাক্সেস বিকল্পের অধীনে, সব রিপোজিটরি বেছে নিন (অথবা আপনি যে নির্দিষ্ট রিপোজিটরি টেস্ট করতে চান সেটি বেছে নিন)।
    • অনুমতি > রিপোজিটরি বিকল্পের অধীনে, +অনুমতি যোগ করুন বিকল্পে ক্লিক করুন এবং কন্টেন্ট, সমস্যা ও পুল রিকোয়েস্ট বিকল্প শুধু-পড়ার জন্য হিসেবে সেট করুন (মেটাডেটা অটোমেটিক শুধু-পড়ার জন্য হিসেবে সেট হয়ে যায়)।
    • টোকেন জেনারেট করুন বিকল্পে ক্লিক করে জেনারেট করা টোকেন ভ্যালু কপি করুন। (বিকল্প হিসেবে, আপনি ব্যক্তিগত অ্যাক্সেস টোকেন (ক্লাসিক) ব্যবহার করলে, repo স্কোপ বেছে নিন।)
  2. আপনার এনভায়রনমেন্টে এটি সেট করুন:
    export GITHUB_TOKEN="your_github_pat_here"
    
  3. secure-agent-demo ফোল্ডারে নেভিগেট করুন (আপনি যদি আগে থেকেই সেখানে না থাকেন) এবং লোকাল প্লেগ্রাউন্ড শুরু করুন:
    cd secure-agent-demo
    agents-cli playground
    
  4. প্লেগ্রাউন্ড ইন্টারফেস খুলে ড্রপ-ডাউন থেকে app ফোল্ডার বেছে নিন। চ্যাটবক্সে, "Get the last 2 GitHub issues reported against my name" বা "List my 3 most recently updated repositories"-এর মতো টার্গেট করা প্রম্পট ব্যবহার করে দেখুন এবং এজেন্ট GitHub MCP টুলসেট কল করে আপনার GitHub ডেটা ফিরিয়ে দিচ্ছে কিনা তা যাচাই করুন। এজেন্ট আপনার হয়ে অ্যাকশন নিতে আপনার PAT টোকেন ব্যবহার করছে কিনা তা পরীক্ষা করতে, আপনার ব্যক্তিগত রিপোজিটরি বা কন্ট্রিবিউশন সম্পর্কে জিজ্ঞাসা করে দেখুন।

৪. Auth Manager কনফিগার করুন

প্রোটোটাইপিংয়ের জন্য স্ট্যাটিক ক্রেডেনশিয়াল (যেমন PAT) হার্ডকোড করা সুবিধাজনক হলেও, এটি প্রোডাকশন অ্যাপ্লিকেশনকে ক্রেডেনশিয়াল ফাঁস, ম্যানুয়াল টোকেন রিফ্রেশ ডাউনটাইম এবং ক্লাউড-নেটিভ অ্যাক্সেস কন্ট্রোলের অভাবের মতো ঝুঁকির মুখে ফেলে।

এই সমস্যার সমাধান করতে, Google Cloud এজেন্ট আইডেন্টিটি অথ ম্যানেজার প্রদান করে। এজেন্ট আইডেন্টিটি অথ ম্যানেজার হল একটি ক্রেডেনশিয়াল ভল্ট যা ক্রেডেনশিয়াল সুরক্ষিত রাখতে সাহায্য করার জন্য ডিজাইন করা হয়েছে। এটি এজেন্টদের API কী বা OAuth ক্লায়েন্ট আইডি এবং গোপনীয়তা ব্যবহার করে বা ব্যবহারকারীর পক্ষ থেকে OAuth ডেলিগেশনের মাধ্যমে এন্ড-ইউজার অ্যাক্সেস টোকেন ব্যবহার করে যাচাই করতে দেয়।

Auth Manager-এর মধ্যে, আপনি যাচাইকরণ প্রদানকারী কনফিগার করেন যা নির্দিষ্ট থার্ড-পার্টি অ্যাপ্লিকেশনের জন্য যাচাইকরণের ধরন এবং ক্রেডেনশিয়াল নির্ধারণ করে। প্রমাণীকরণ প্রদানকারী আঞ্চলিক এবং অঞ্চলটি অবশ্যই সেই অঞ্চলের সাথে মিলতে হবে যেখানে আপনি এজেন্ট স্থাপন করেছেন। এন্ড-টু-এন্ড Auth Manager ওয়ার্কফ্লো এইভাবে কাজ করে:

Auth Manager ওয়ার্কফ্লো

  1. ডায়নামিক কনসেন্ট ইন্টারসেপশন: এজেন্ট যখন কোনও ব্যবহারকারীর হয়ে টুল এক্সিকিউট করার চেষ্টা করে, তখন ADK, Auth Manager-এ কোনও বৈধ ক্রেডেনশিয়াল আছে কিনা তা চেক করে। কোনওটিই না থাকলে, Auth ম্যানেজার ৩-লেগড OAuth (3LO) সম্মতি ফ্লো শুরু করার জন্য একটি অনুমোদন URL রিটার্ন করে।
  2. নিরাপদ ভল্ট স্টোরেজ: ব্যবহারকারী অ্যাপ্লিকেশনটিকে অনুমোদন করলে, Auth Manager অটোমেটিক OAuth কলব্যাক ইন্টারসেপ্ট করে এবং এর ফলে পাওয়া ব্যবহারকারীর অ্যাক্সেস ও রিফ্রেশ টোকেন একটি নিরাপদ, Google-পরিচালিত ক্রেডেনশিয়াল ভল্টে স্টোর করে।
  3. অটোমেটেড টোকেন লাইফসাইকেল: Auth Manager ব্যাকগ্রাউন্ডে টোকেনের মেয়াদ শেষ হওয়া এবং রোটেশন সম্পূর্ণভাবে ম্যানেজ করে, যার ফলে ম্যানুয়ালি টোকেন রিফ্রেশ লজিক বা ডাউনটাইমের প্রয়োজন হয় না।
  4. সিক্রেট-ফ্রি টুল এক্সিকিউশন: পরবর্তী অ্যাকশনের জন্য, এজেন্ট (তার SPIFFE এজেন্ট আইডেন্টিটির মাধ্যমে যাচাইকরণ করে) রানটাইমে Auth Manager থেকে ব্যবহারকারীর ডেলিগেট করা অ্যাক্সেস টোকেন ডাইনামিকভাবে অনুরোধ করে, যার ফলে ক্লায়েন্ট ও এজেন্ট কোড সম্পূর্ণভাবে সিক্রেট-ফ্রি থাকে।

ধাপ ক: যাচাইকরণ পরিষেবা প্রদানকারী হিসেবে GitHub কনফিগার করুন

আপনার Google Cloud প্রোজেক্টে GitHub অথেন্টিকেশন প্রোভাইডার তৈরি করতে নিম্নলিখিত gcloud কমান্ড রান করুন। আপনি পরে ক্লায়েন্ট আইডি ও সিক্রেট প্রদান করবেন: GitHub এই প্রোভাইডারের কলব্যাক URL না জানা পর্যন্ত এগুলি ইস্যু করবে না।

gcloud agent-identity auth-providers create github-oauth-provider \
    --project="YOUR_PROJECT_ID" \
    --location="us-central1" \
    --three-legged-oauth-authorization-url="https://github.com/login/oauth/authorize" \
    --three-legged-oauth-token-url="https://github.com/login/oauth/access_token"

জেনারেট করা OAuth রিডাইরেক্ট URL ফিরিয়ে আনতে, পরিষেবা প্রদানকারীর বিবরণ দিন:

gcloud agent-identity auth-providers describe github-oauth-provider \
    --project="YOUR_PROJECT_ID" \
    --location="us-central1"

ফিল্ডটি হল redirectUrl, authProviderTypeParams.threeLeggedOauth-এর অধীনে নেস্ট করা। সরাসরি এটি পড়তে:

gcloud agent-identity auth-providers describe github-oauth-provider \
    --project="YOUR_PROJECT_ID" --location="us-central1" \
    --format="value(authProviderTypeParams.threeLeggedOauth.redirectUrl)"

এটি https://agentidentitycredentials.googleapis.com/v1/projects/YOUR_PROJECT_ID/locations/us-central1/authProviders/github-oauth-provider/oauthcallback-এর মতো দেখতে।

ধাপ খ: GitHub-এ OAuth অ্যাপ রেজিস্টার করা

  1. GitHub ডেভেলপার সেটিংস পৃষ্ঠায় যান, বাঁদিকের সাইডবারে OAuth অ্যাপ বেছে নিন এবং নতুন OAuth অ্যাপ (অথবা আগে কোনও অ্যাপ তৈরি না করে থাকলে নতুন অ্যাপ্লিকেশন রেজিস্টার করুন) বিকল্পে ক্লিক করুন।
  2. OAuth অ্যাপ্লিকেশন ফর্মের ফিল্ডগুলি পূরণ করুন:
    • অ্যাপ্লিকেশনের নাম: আপনার অ্যাপ্লিকেশনের নাম লিখুন (যেমন, secure-agent-demo)।
    • হোমপেজ URL: আপনার ফ্রন্টএন্ড অ্যাপ্লিকেশনের URL লিখুন (লোকাল প্রোটোটাইপিংয়ের জন্য http://localhost:8501; প্রোডাকশনে আপনার ডিপ্লয় করা URL-এ এটি আপডেট করতে পারবেন)।
    • অ্যাপ্লিকেশনের বিবরণ: ঐচ্ছিক (আপনি এটি ফাঁকা রাখতে পারেন)।
    • অনুমোদন কলব্যাক URL (রিডাইরেক্ট URI): ধাপ ক-তে পাওয়া redirectUrl পেস্ট করুন।
    • ডিভাইস ফ্লো চালু করুন: টিকচিহ্ন দেবেন না।
  3. অ্যাপ্লিকেশন রেজিস্টার করুন বিকল্পে ক্লিক করুন।
  4. ফলাফল হিসেবে দেখানো অ্যাপ্লিকেশন পৃষ্ঠায়, ক্লায়েন্ট আইডি কপি করুন, তারপর নতুন ক্লায়েন্ট সিক্রেট জেনারেট করুন বিকল্পে ক্লিক করে জেনারেট করা ক্লায়েন্ট সিক্রেট কপি করুন। দুটি ভ্যালুই সেভ করুন — পরবর্তী ধাপে আপনি এগুলি YOUR_GITHUB_CLIENT_ID এবং YOUR_GITHUB_CLIENT_SECRET হিসেবে ব্যবহার করবেন।

ধাপ ৩: GitHub ক্রেডেনশিয়াল অথেন্টিকেশন প্রদানকারীতে যোগ করুন

YOUR_PROJECT_ID, YOUR_GITHUB_CLIENT_ID ও YOUR_GITHUB_CLIENT_SECRET-এর জায়গায় আপনার ভ্যালু লিখুন এবং এই কমান্ড রান করুন:

gcloud agent-identity auth-providers update github-oauth-provider \
    --project="YOUR_PROJECT_ID" \
    --location="us-central1" \
    --three-legged-oauth-client-id="YOUR_GITHUB_CLIENT_ID" \
    --three-legged-oauth-client-secret="YOUR_GITHUB_CLIENT_SECRET"

কমান্ডটি clientId সহ প্রদানকারীকে ইকো করে; গোপন তথ্য ইকো করা হয় না।

👉 এই ধাপ সম্পূর্ণ করার মাধ্যমে, আপনার Google Cloud Auth Manager এখন আপনার GitHub OAuth অ্যাপ্লিকেশনের ক্রেডেনশিয়ালের সাথে সম্পূর্ণভাবে কনফিগার করা হয়েছে, যা Google Cloud-কে একটি সুরক্ষিত ভল্ট হিসেবে কাজ করার জন্য সেট-আপ করে, যা সম্মতি এবং টোকেন লাইফসাইকেল ম্যানেজ করে।

৫. PAT টোকেন থেকে Auth Manager-এ পরিবর্তন করুন

এখন Auth Manager সম্পূর্ণভাবে কনফিগার করা হয়ে গেছে, পরবর্তী ধাপ হল এজেন্টের টুল কোড আপডেট করা। secure-agent-demo/app/tools.py-এর কন্টেন্ট নিম্নলিখিত কোড দিয়ে পরিবর্তন করুন।

👉 নিচে OAUTH_PROVIDER_NAME ভেরিয়েবলে প্রোজেক্ট আইডি ও লোকেশন পরিবর্তন করুন।

# app/tools.py

from __future__ import annotations
import os
from google.adk.auth.credential_manager import CredentialManager
from google.adk.integrations.agent_identity import GcpAuthProvider, GcpAuthProviderScheme
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

# 1. Register the GCP Auth Provider in the global Credential Manager
CredentialManager.register_auth_provider(GcpAuthProvider())

# 2. Replace YOUR_PROJECT_ID with your project ID.
OAUTH_PROVIDER_NAME = "projects/YOUR_PROJECT_ID/locations/us-central1/authProviders/github-oauth-provider"

# 3. The frontend callback URL where the user is redirected after authorizing GitHub. Resolved from the environment variable.
OAUTH_CONTINUE_URI = os.environ.get(
    "OAUTH_CONTINUE_URI", 
    "http://localhost:8501/validateUserId"
)

def github_toolset() -> McpToolset:
    """Returns the McpToolset using 3LO credentials retrieved via GCP Auth Manager."""
    auth_scheme = GcpAuthProviderScheme(
        name=OAUTH_PROVIDER_NAME,
        # Required to read private repositories. Auth Manager currently supports a
        # single scope for GitHub.
        scopes=["repo"],
        continue_uri=OAUTH_CONTINUE_URI,
    )
    return McpToolset(
        connection_params=StreamableHTTPConnectionParams(
            url="https://api.githubcopilot.com/mcp/",
            headers={
                "X-MCP-Toolsets": "all",
                "X-MCP-Readonly": "true",
            },
        ),
        auth_scheme=auth_scheme,
    )

টুল কোড সম্পর্কে বোঝা

মূল পরিবর্তন হল auth_scheme। টুলসেটে এটি অ্যাটাচ করার অর্থ হল, এজেন্ট যখনই GitHub-এ কল করে, ADK প্রথমে Auth Manager-এর কাছে সেই ব্যবহারকারীর টোকেন চায় — এবং এখনও যদি কোনও টোকেন না থাকে, তাহলে এটি ব্যর্থ হওয়ার পরিবর্তে ব্যবহারকারীকে সাইন-ইন করার জন্য প্রম্পট করে। হার্ডকোড করা GITHUB_TOKEN সম্পূর্ণভাবে চলে গেছে।

৬. এজেন্ট রানটাইমে এজেন্ট ডিপ্লয় করুন

এখন আমরা GitHub MCP টুল আপডেট করেছি যাতে Auth Manager ব্যবহার করা যায়, পরবর্তী ধাপ হল এজেন্টকে এজেন্ট রানটাইম-এ ডিপ্লয় করা। এজেন্টের পরিচয় চালু রেখে এটি ডিপ্লয় করলে এজেন্টের জন্য একটি অনন্য SPIFFE আইডি তৈরি হয়।

প্রোজেক্টের জন্য ডিপ্লয়মেন্ট কনফিগারেশন শুরু করুন। আপনার টার্মিনাল secure-agent-demo প্রোজেক্ট রুট ডিরেক্টরিতে আছে কিনা তা নিশ্চিত করুন, তারপর রান করুন:

agents-cli scaffold enhance . --deployment-target agent_runtime --prototype --yes

এই কমান্ড ADK-এর সাথে মানানসই কিনা তা দেখার জন্য আপনার প্রোজেক্টের স্ট্রাকচার পরীক্ষা করে, অন্তর্নিহিত কন্টেনার প্যাকেজিং কনফিগারেশন প্রস্তুত করে এবং ডিফল্ট ডিপ্লয়মেন্ট সেটিংস সহ আপনার প্রোজেক্ট রুটে একটি agents-cli-manifest.yaml ফাইল তৈরি করে।

👉 নতুন তৈরি করা agents-cli-manifest.yaml ফাইলটি খুলুন এবং আপনার এজেন্ট আপনার প্রমাণীকরণ প্রদানকারীর মতো একই অঞ্চলে ডিপ্লয় করা হয়েছে কিনা তা নিশ্চিত করতে region ফিল্ডটি us-central1-এ যাচাই বা আপডেট করুন:

region: "us-central1"

এজেন্ট আইডেন্টিটির সাথে এজেন্ট ডিপ্লয় করা

adk deploy agent_engine-এর মাধ্যমে ডিপ্লয় করুন। এটি এজেন্টকে নিজস্ব এজেন্ট আইডেন্টিটি প্রদান করে — এই ডিপ্লয়মেন্টের অন্তর্গত একটি অনন্য, SPIFFE-সমর্থিত ক্রিপ্টোগ্রাফিক আইডেন্টিটি, যা এজেন্ট Auth Manager এবং অন্যান্য Google Cloud পরিষেবায় যাচাইকরণের জন্য ব্যবহার করে।

👉 secure-agent-demo ডিরেক্টরি থেকে, YOUR_PROJECT_ID রিপ্লেস করুন এবং এই কমান্ডগুলি রান করুন:

# Write a config file inside the `app/` folder instructing Agent Runtime to provision a SPIFFE-backed `AGENT_IDENTITY` for this deployment.
echo '{ "identity_type": "AGENT_IDENTITY" }' > app/.agent_engine_config.json

# Generate the dependency list the build will install
uv export --no-emit-workspace --no-hashes --format requirements.txt \
    --output-file app/requirements.txt

uv run adk deploy agent_engine app \
    --project="YOUR_PROJECT_ID" \
    --region="us-central1"

ডেপ্লয়মেন্টের ক্ষেত্রে কন্টেনার তৈরি ও আপলোড করতে কয়েক মিনিট সময় লাগে। সম্পূর্ণ হয়ে গেলে, CLI ডিপ্লয় করা রিসোর্সের নাম প্রিন্ট করে। reasoningEngines/ENGINE_ID ভ্যালু নোট করে নিন, কারণ আপনার এজেন্টকে অনুমোদন করতে এবং UI ক্লায়েন্টকে এটিতে পয়েন্ট করতে আপনার এটি প্রয়োজন।

এজেন্টের পরিচয় অনুমোদন করুন

আপনার এজেন্ট এখন ক্লাউডে রান করছে, তাই Auth Manager-এ সেভ করা ক্রেডেনশিয়াল অ্যাক্সেস করার জন্য এটির অনুমতি প্রয়োজন। ডিফল্ট হিসেবে, এজেন্টের SPIFFE আইডেন্টিটির কাছে এক্সটার্নাল ক্লাউড রিসোর্সের অ্যাক্সেস থাকে না।

অথ প্রোভাইডার রিসোর্সে আপনার এজেন্টের আইডেনটিটিকে roles/agentidentity.user ভূমিকা প্রদান করতে নিম্নলিখিত gcloud কমান্ড রান করুন। এটি আপনার এজেন্টকে ভল্ট থেকে ব্যবহারকারীর টোকেন অনুরোধ করার জন্য প্রয়োজনীয় সঠিক অনুমতি দেয় এবং এর বাইরে আর কিছুই নয়।

# Get YOUR_ORG_ID
gcloud projects get-ancestors $(gcloud config get-value project) \
  --filter="type=organization" \
  --format="value(id)"

# Get YOUR_PROJECT_NUMBER
gcloud projects describe $(gcloud config get-value project) \
  --format="value(projectNumber)"

তারপর, অথেন্টিকেশন প্রোভাইডারে IAM নীতি বাইন্ড করুন (YOUR_PROJECT_ID এবং --member প্রিন্সিপাল পরিবর্তন করে):

gcloud agent-identity auth-providers add-iam-policy-binding github-oauth-provider \
    --project="YOUR_PROJECT_ID" \
    --location="us-central1" \
    --role="roles/agentidentity.user" \
    --member="principal://agents.global.org-YOUR_ORG_ID.system.id.goog/resources/aiplatform/projects/YOUR_PROJECT_NUMBER/locations/us-central1/reasoningEngines/YOUR_ENGINE_ID"

👉 এছাড়াও, আপনি Google Cloud Console থেকে আপনার ডিপ্লয় করা এজেন্টের জন্য সম্পূর্ণ --member="principal://..." ভ্যালু পেতে পারেন: এজেন্ট রানটাইম কনসোলে নেভিগেট করুন, আপনার ডিপ্লয় করা এজেন্ট বেছে নিন, পরিচয় ট্যাবে নেভিগেট করুন এবং সম্পূর্ণ principal://... স্ট্রিং সরাসরি কপি করুন।

এখন, পরিষেবা প্রদানকারীর কাছে আপনার নিজের অ্যাকাউন্টকে একই ভূমিকা দিন। পরবর্তী ধাপে আপনি যে UI ক্লায়েন্ট চালান সেটি আপনার অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়ালের সাথে ক্রেডেনশিয়াল-ফাইনাল করার API কল করে, তাই এটি ছাড়া সম্মতি ফ্লো agentidentity.authProviders.retrieveCredentials-এ 403 সহ ব্যর্থ হয়:

gcloud agent-identity auth-providers add-iam-policy-binding github-oauth-provider \
    --project="YOUR_PROJECT_ID" \
    --location="us-central1" \
    --role="roles/agentidentity.user" \
    --member="user:YOUR_EMAIL_ADDRESS"

৭. 3LO সম্মতি ফ্লো বোঝা

এখন যেহেতু এজেন্টটি একটি সুরক্ষিত এজেন্ট আইডেন্টিটি সহ এজেন্ট রানটাইমে ডিপ্লয় করা হয়েছে, পরবর্তী ধাপ হল ব্যবহারকারীদের এটির সাথে চ্যাট করার জন্য একটি কাস্টম ফ্রন্টএন্ড ইন্টারফেস প্রদান করা। আরও গুরুত্বপূর্ণ হল, যাচাইকরণ লুপ সম্পূর্ণ করার জন্য Google Cloud Auth Manager-এর একটি ক্লায়েন্ট অ্যাপ্লিকেশন কলব্যাক হ্যান্ডলার প্রয়োজন।

Google Cloud Auth Manager ভল্টের মধ্যে ব্যবহারকারীর ক্রেডেনশিয়াল নিরাপদে ম্যানেজ করলেও, এটি নিজে থেকে OAuth টোকেন এক্সচেঞ্জ সম্পূর্ণ করতে পারে না। 3LO হ্যান্ডশেক ক্লায়েন্ট অ্যাপ্লিকেশনের উপর নির্ভর করে:

  1. কোনও ব্যবহারকারী GitHub অ্যাপকে অনুমতি দিলে, GitHub তাকে আবার এজেন্ট আইডেন্টিটি অথেন্টিকেশন প্রদানকারীর redirectUrl-এ রিডাইরেক্ট করে।
  2. এরপর Auth Manager ব্যবহারকারীর ব্রাউজার পপ-আপকে ক্লায়েন্ট-সাইড কলব্যাক URL (continue_uri)-এ রিডাইরেক্ট করে।
  3. এই রিডাইরেক্ট ইন্টারসেপ্ট করা, ব্রাউজারের কুকি থেকে ননস পড়া এবং হ্যান্ডশেক সম্পূর্ণ করতে Google Cloud-এর credentials:finalize এন্ডপয়েন্ট কল করার দায়িত্ব ক্লায়েন্ট অ্যাপ্লিকেশনের।
  4. ক্লায়েন্ট এক্সচেঞ্জ চূড়ান্ত করার পরে, Google Cloud নিরাপদে টোকেনটি অথ প্রোভাইডারের ভল্টে সেভ করে, যা এজেন্টকে GitHub টুল কল করার অনুমতি দেয়।

এই কাস্টম ক্লায়েন্ট কলব্যাক এন্ডপয়েন্ট হোস্ট না করলে, হ্যান্ডশেক অসম্পূর্ণ থেকে যায় এবং ভল্ট ক্রেডেনশিয়াল সেভ করতে পারে না।

ইন্ট্যার‍্যাক্টিভ OAuth 3LO ফ্লো একাধিক লেয়ার জুড়ে বিস্তৃত। টুল সংক্রান্ত অনুরোধের সম্পূর্ণ এক্সিকিউশন লাইফসাইকেল এখানে দেওয়া হল। আমরা এটি নিচের ব্যাখ্যায় এবং পরবর্তী ধাপে বিস্তারিতভাবে আলোচনা করব।

👉 ছবিটি বড় করে দেখতে সেটির উপরে ক্লিক করুন।

৩-লেগড OAuth সিকোয়েন্স ফ্লো

হ্যান্ডশেকে ক্লায়েন্টের মূল দায়িত্ব

  • সম্মতি চ্যালেঞ্জ রিলে করা (ধাপ ৫-৬): এজেন্ট একটি adk_request_credential নির্গত করে যাতে সম্মতি URL এবং একবার ব্যবহারযোগ্য ননস থাকে; ক্লায়েন্ট পপআপ খোলে এবং ননসকে কুকি হিসেবে স্টোর করে।
  • রিডাইরেক্ট কলব্যাক হোস্ট করুন (ধাপ ১০-১১): /validateUserId, যেখানে সম্মতি পাওয়ার পরে Auth Manager পপ-আপ পাঠায়।
  • টোকেন চূড়ান্ত করা (ধাপ ১২-১৪): রিডাইরেক্ট থেকে যাচাইকরণ স্ট্যাটাস ক্যাশে করা ননসের সাথে কম্বাইন করুন এবং credentials:finalize কল করুন, যা ভল্টে টোকেন স্টোর করে।

আপনার নিজস্ব ক্লায়েন্ট তৈরি করা

ল্যাবের জন্য আপনাকে এই ক্লায়েন্ট লিখতে হবে না — পরবর্তী ধাপে আগে থেকে তৈরি করা একটি ক্লায়েন্ট রান করে। আপনার নিজের অ্যাপ্লিকেশনে এটি প্রয়োগ করার সময়, এই দুটি রেফারেন্স থেকে কাজ করতে হবে:

৮. লোকালি UI ক্লায়েন্ট রান করুন

3LO সম্মতি ফ্লো সিকোয়েন্স ডায়াগ্রামে যেমন ট্রেস করা হয়েছে, Auth ম্যানেজার ব্রাউজার উইন্ডোকে ক্লায়েন্ট-সাইড কলব্যাক এন্ডপয়েন্টে রিডাইরেক্ট করে। adk-python রিপোজিটরিতে স্যাম্পেল ক্লায়েন্ট /validateUserId-এ সেই এন্ডপয়েন্ট হোস্ট করে। নিম্নলিখিত ধাপগুলি অনুসরণ করে এটি ডাউনলোড করুন এবং লোকালি চালান।

ক্লায়েন্ট ফাইল ডাউনলোড করুন

adk-python-এ contributing/samples/integrations/gcp_auth/client ডিরেক্টরিতে তিনটি মূল অ্যাসেট রয়েছে:

  • main.py: FastAPI ব্যাকএন্ড যা আপনার ডিপ্লয় করা এজেন্ট ইঞ্জিনের সাথে কানেক্ট করে এবং OAuth টোকেন চূড়ান্ত করতে /validateUserId কলব্যাক এন্ডপয়েন্ট হোস্ট করে।
  • static/: ব্রাউজার চ্যাট UI-এর জন্য HTML এবং JavaScript ফাইল।
  • requirements.txt: ক্লায়েন্ট সার্ভার চালানোর জন্য প্রয়োজনীয় Python প্যাকেজ।

adk-python একটি বড় রিপোজিটরি হওয়ার কারণে, শুধুমাত্র contributing/samples/integrations/gcp_auth/client ফোল্ডার ডাউনলোড করতে Git-এর স্পার্স চেকআউট ফিচার ব্যবহার করুন:

  1. প্রথমে, secure-agent-demo থেকে একটি ডিরেক্টরি উপরে যান যাতে আপনি ক্লায়েন্টকে একটি সিবলিং ফোল্ডারে ক্লোন করতে পারেন:
    cd ..
    
  2. সব ফাইল (--no-checkout) ডাউনলোড না করে রিপোজিটরি মেটাডেটা ক্লোন করতে, চেকআউট পাথ contributing/samples/integrations/gcp_auth/client-এ সীমাবদ্ধ করতে এবং শুধু সেই ফোল্ডার চেকআউট করতে নিম্নলিখিত কমান্ড রান করুন:
    git clone --filter=blob:none --no-checkout https://github.com/google/adk-python.git
    cd adk-python
    git sparse-checkout init --cone
    git sparse-checkout set contributing/samples/integrations/gcp_auth/client
    git checkout
    

ক্লায়েন্ট চালান

  1. আপনি এইমাত্র যে adk-python ডিরেক্টরিতে প্রবেশ করেছেন, সেখান থেকে client ফোল্ডারে নেভিগেট করুন:
    cd contributing/samples/integrations/gcp_auth/client
    
  2. Python ভার্চুয়াল এনভায়রনমেন্ট তৈরি ও অ্যাক্টিভেট করুন, তারপর requirements.txt থেকে ক্লায়েন্টের ডিপেনডেন্সি ইনস্টল করুন:
    uv venv --python 3.13 .venv
    source .venv/bin/activate
    uv pip install --python .venv/bin/python -r requirements.txt
    
  3. আপনার Google Cloud প্রোজেক্ট, অঞ্চল (us-central1) এবং ডিপ্লয় করা এজেন্ট ইঞ্জিন আইডিতে (YOUR_ENGINE_ID) ক্লায়েন্টকে নির্দেশ করে এনভায়রনমেন্ট ভেরিয়েবল সেট করুন, তারপর 8501 পোর্টে লোকাল FastAPI সার্ভার চালু করুন:
    export GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID
    export GOOGLE_CLOUD_LOCATION=us-central1
    export AGENT_ID=YOUR_ENGINE_ID
    
    .venv/bin/uvicorn main:app --port 8501
    
  4. সার্ভারটি সফলভাবে শুরু হয়েছে এবং http://localhost:8501-এ শুনছে কিনা তা যাচাই করুন।

৯. OAuth ফ্লো পরীক্ষা করা

এখন সব পরিষেবা ডিপ্লয় করা, IAM বাইন্ডিং কনফিগার করা এবং এনভায়রনমেন্ট ভেরিয়েবেল সেট করা হয়ে গেছে, তাই আপনি সুরক্ষিত এন্ড-টু-এন্ড ব্যবহারকারী-প্রতিনিধি অথরাইজেশন ফ্লো পরীক্ষা করার জন্য প্রস্তুত!

ধাপ ক: টুল এক্সিকিউশন শুরু করা

  1. ব্রাউজার ট্যাব খুলে আপনার ক্লায়েন্ট URL-এ যান: http://localhost:8501.
  2. বাঁদিকের প্যানে কনফিগারেশন সেটিংস-এর অধীনে, এজেন্টের ধরন Remote Agent (Vertex AI) (বা Remote Agent Engine) হিসেবে সেট করুন।
  3. আপনার Google Cloud প্রোজেক্ট আইডি এবং লোকেশন (us-central1) লিখুন, তারপর রিমোট এজেন্ট লোড করুন বিকল্পে ক্লিক করুন। এটি আপনার প্রোজেক্টে ডিপ্লয় করা এজেন্ট লোড করে।
  4. ইঞ্জিন বেছে নিন ড্রপ-ডাউন থেকে আপনার ডিপ্লয় করা app এজেন্ট বেছে নিন এবং সেটিংস সেভ ও প্রয়োগ করুন বিকল্পে ক্লিক করুন।
  5. চ্যাট বক্সে, টার্গেট করা কোয়েরি টাইপ করুন (যেমন, আপনার সাম্প্রতিক সমস্যা বা রিপোজিটরি ফেচ করা):
    Get the last 2 GitHub issues reported against my name
    
    (অথবা "List my 3 most recently updated repositories" ব্যবহার করে দেখুন) এবং Enter প্রেস করুন।
  6. চ্যাট UI লক্ষ্য করুন: যেহেতু এজেন্টের কাছে এখনও আপনার ব্যবহারকারী সেশনের জন্য কোনও ক্রেডেনশিয়াল নেই, তাই এটি একটি যাচাইকরণ চ্যালেঞ্জ গ্রহণ করে এবং কথোপকথন থ্রেডে 'যাচাইকরণ প্রয়োজন' কার্ডটি দেখায়।
  1. একটি আলাদা ব্রাউজার পপ-আপ উইন্ডো খুলবে, যা আপনাকে Google Cloud-এর Auth Manager-এর মাধ্যমে GitHub OAuth অনুমোদন পৃষ্ঠায় রিডাইরেক্ট করবে।
  2. অনুরোধ করা অনুমতি পর্যালোচনা করে অনুমোদন দিন বিকল্পে ক্লিক করুন।
  3. GitHub, Google Cloud-এ রিডাইরেক্ট করবে, যা পপ-আপকে আপনার localhost কলব্যাক URL /validateUserId-এ রিডাইরেক্ট করবে।
  4. কলব্যাক পরিষেবা ক্রেডেনশিয়াল হ্যান্ডশেক প্রসেস ও চূড়ান্ত করে।

ধাপ গ: আবার শুরু করুন

  1. পপ-আপ উইন্ডো বন্ধ হয়ে গেলে, পেরেন্ট চ্যাট ট্যাব অটোমেটিক বন্ধ হয়ে যাওয়া শনাক্ত করে।
  2. ফ্রন্টএন্ড এজেন্টের কাছে আবার একটি রিজিউম পেলোড পাঠায়।
  3. এজেন্ট Google Cloud Auth Manager থেকে নতুন এক্সচেঞ্জ করা টোকেন নিরাপদে ফিরিয়ে আনে, আপনার হয়ে GitHub MCP টুল কল করে এবং আপনার GitHub ডেটা সরাসরি চ্যাট উইন্ডোতে স্ট্রিম করে — এই ডেটা এজেন্ট নিজে থেকে অ্যাক্সেস করতে পারত না।

ধাপ ঘ: ক্লাউড লগ পরীক্ষা করা

টোকেন এক্সচেঞ্জ ও চূড়ান্তকরণ নিরাপদে প্রসেস করা হয়েছে কিনা তা যাচাই করতে:

  1. Google Cloud Console-এর Logs Explorer-এ যান।
  2. ননস এক্সট্র্যাকশন এবং সফল যাচাইকরণ কনফার্ম করে এমন সার্ভার লগ খুঁজুন:
    INFO:secure-agent-client:Caching consent nonce for session_id: session-xxxxxxx
    INFO:secure-agent-client:Successfully finalized auth provider credentials.
    
  3. এজেন্ট রানটাইম লগ পরীক্ষা করা: অন্যথায়, আপনি সরাসরি এজেন্ট প্ল্যাটফর্ম কনসোলের মধ্যে এক্সিকিউশন লগ দেখতে পারেন:
    • এজেন্ট রানটাইম কনসোল-এ নেভিগেট করুন।
    • তালিকা থেকে আপনার ডিপ্লয় করা এজেন্টের উপর ক্লিক করুন।
    • Playground ট্যাবে যান; এটি নিচের প্যানে লাইভ এজেন্ট লগ দেখাবে, যা আপনাকে এজেন্টের রিজনিং লুপ, টুল এক্সিকিউশন সংক্রান্ত বিবরণ এবং রিয়েল-টাইমে টোকেন রিট্রিভাল লাইফসাইকেল দেখাবে।

১০. ক্লিন আপ করুন

Google Cloud-এ চলমান চার্জ এড়াতে, আপনার ডিপ্লয় করা রিসোর্স ক্লিন-আপ করুন:

# Follow the instructions here to delete the deployed Agent Runtime resource
# https://docs.cloud.google.com/gemini-enterprise-agent-platform/scale/runtime/manage-deployed-agents#console_3

# Delete the auth provider
gcloud agent-identity auth-providers delete github-oauth-provider \
    --project=YOUR_PROJECT_ID --location=us-central1

# Note: deleted providers sit in soft-delete for 30 days, and the name is not
# reusable until roughly a day after that. Pick a fresh name if you repeat this lab.

# Optionally, you could also delete your Google Cloud Project
gcloud projects delete YOUR_PROJECT_ID

# Optionally, delete the GitHub PAT Token and the OAuth app: 
# https://github.com/settings/personal-access-tokens

লোকাল ফাইল ক্লিন-আপ করুন

বিকল্প হিসেবে, আপনার লোকাল এনভায়রনমেন্ট সম্পূর্ণভাবে ক্লিন-আপ করতে:

  1. লোকাল uvicorn সার্ভার যে টার্মিনালে চলছে সেখানে Ctrl+C প্রেস করে সেটি বন্ধ করুন।
  2. এই ল্যাব চলাকালীন তৈরি করা প্রোজেক্ট ডিরেক্টরি সরান:
# cd to the correct folder
rm -rf secure-agent-demo client adk-python

১১. অভিনন্দন!

আপনি সাইন-ইন করা ব্যবহারকারীর হয়ে কাজ করে এমন একটি এজেন্ট তৈরি ও সুরক্ষিত করেছেন!

আপনি যা শিখেছেন:

  • এজেন্ট সিস্টেম আইডেন্টিটি: GCP ইনফ্রাস্ট্রাকচারের সাথে সুরক্ষিতভাবে ইন্টারফেস করতে, টেলিমেট্রি লগ ম্যানেজ করতে এবং ক্রেডেনশিয়াল ফাইনাল করার API কল করতে, এজেন্ট কীভাবে তার নিজস্ব অ্যাকাউন্ট আইডেন্টিটির অধীনে কাজ করে।
  • ব্যবহারকারীর ডেলিগেট করা পরিচয়: এজেন্ট কীভাবে ৩-লেগড OAuth (3LO) সম্মতি ফ্লো ট্রিগার করে এক্সটার্নাল প্ল্যাটফর্মে (যেমন GitHub) ব্যবহারকারীর হয়ে কাজ করার জন্য অনুমোদনের অনুরোধ করে।
  • নিরাপদ টুল ইন্টিগ্রেশন: হার্ডকোড করা সিক্রেট ব্যবহার করার পরিবর্তে ব্যবহারকারীর টোকেন ডায়নামিকভাবে ফেচ করার জন্য Google Cloud Auth Manager ব্যবহার করে কীভাবে ADK এজেন্টকে Model Context Protocol (MCP) সার্ভারের সাথে কানেক্ট করতে হয়।
  • IAM নীতি কনফিগারেশন: কীভাবে অথ প্রোভাইডারে এজেন্ট রানটাইম আইডেন্টিটি এবং আপনার নিজের অ্যাকাউন্ট উভয়কেই অনুমোদন করার জন্য ফাইন-গ্রেনড অনুমতি বাইন্ডিং সেট-আপ করবেন।

আরও পড়ুন