diff --git a/English/.gitbook/assets/mcp-connector/agent_call_via_mcp_gateway_flow.png b/English/.gitbook/assets/mcp-connector/agent_call_via_mcp_gateway_flow.png new file mode 100644 index 000000000..4771c5e80 Binary files /dev/null and b/English/.gitbook/assets/mcp-connector/agent_call_via_mcp_gateway_flow.png differ diff --git a/English/.gitbook/assets/mcp-connector/connect-mcp-detail-part1.png b/English/.gitbook/assets/mcp-connector/connect-mcp-detail-part1.png new file mode 100644 index 000000000..33842f76e Binary files /dev/null and b/English/.gitbook/assets/mcp-connector/connect-mcp-detail-part1.png differ diff --git a/English/.gitbook/assets/mcp-connector/connect-mcp-detail-part2.png b/English/.gitbook/assets/mcp-connector/connect-mcp-detail-part2.png new file mode 100644 index 000000000..7c8ca3093 Binary files /dev/null and b/English/.gitbook/assets/mcp-connector/connect-mcp-detail-part2.png differ diff --git a/English/.gitbook/assets/mcp-connector/mcp-connected-detail-page.png b/English/.gitbook/assets/mcp-connector/mcp-connected-detail-page.png new file mode 100644 index 000000000..6dd853d60 Binary files /dev/null and b/English/.gitbook/assets/mcp-connector/mcp-connected-detail-page.png differ diff --git a/English/.gitbook/assets/mcp-connector/mcp-connected-list.png b/English/.gitbook/assets/mcp-connector/mcp-connected-list.png new file mode 100644 index 000000000..3576372f5 Binary files /dev/null and b/English/.gitbook/assets/mcp-connector/mcp-connected-list.png differ diff --git a/English/.gitbook/assets/mcp-connector/mcp-connector-catalog-list.png b/English/.gitbook/assets/mcp-connector/mcp-connector-catalog-list.png new file mode 100644 index 000000000..d39ab7064 Binary files /dev/null and b/English/.gitbook/assets/mcp-connector/mcp-connector-catalog-list.png differ diff --git a/English/.gitbook/assets/mcp-connector/mcp_connector_connect_flow.png b/English/.gitbook/assets/mcp-connector/mcp_connector_connect_flow.png new file mode 100644 index 000000000..bf686bc85 Binary files /dev/null and b/English/.gitbook/assets/mcp-connector/mcp_connector_connect_flow.png differ diff --git a/English/SUMMARY.md b/English/SUMMARY.md index fd6bad756..547973b0a 100644 --- a/English/SUMMARY.md +++ b/English/SUMMARY.md @@ -690,13 +690,13 @@ * [Import Model Registry Using Triton](ai-stack/ai-platform/model-registry/import-model-registry-using-triton.md) * [Import Model Registry Using vLLM](ai-stack/ai-platform/model-registry/import-model-registry-using-vllm.md) * [Import Model Registry Using a Custom Container](ai-stack/ai-platform/model-registry/import-model-registry-using-a-custom-container.md) - * [Model as a Service (MaaS)](ai-stack/ai-platform/model-as-a-service/README.md) - * [OCR API Usage Guide](ai-stack/ai-platform/model-as-a-service/ocr-api-usage-guide.md) - * [Playground](ai-stack/ai-platform/model-as-a-service/playground.md) - * [Available Models](ai-stack/ai-platform/model-as-a-service/available-models.md) - * [MaaS API](ai-stack/ai-platform/model-as-a-service/maas-api.md) - * [Using MaaS with AI Gateway](ai-stack/ai-platform/model-as-a-service/using-maas-with-ai-gateway.md) - * [Pricing](ai-stack/ai-platform/model-as-a-service/pricing.md) + * [Model as a Service (MaaS)](ai-stack/model-as-a-service/README.md) + * [OCR API Usage Guide](ai-stack/model-as-a-service/ocr-api-usage-guide.md) + * [Playground](ai-stack/model-as-a-service/playground.md) + * [Available Models](ai-stack/model-as-a-service/available-models.md) + * [MaaS API](ai-stack/model-as-a-service/maas-api.md) + * [Using MaaS with AI Gateway](ai-stack/model-as-a-service/using-maas-with-ai-gateway.md) + * [Pricing](ai-stack/model-as-a-service/pricing.md) * [AI Gateway](ai-stack/ai-gateway/README.md) * [What is AI Gateway?](ai-stack/ai-gateway/what-is-ai-gateway.md) * [Get starting with AI Gateway](ai-stack/ai-gateway/get-starting-with-ai-gateway/README.md) @@ -754,6 +754,10 @@ * [Manage MCP Gateway](ai-stack/agent-base/mcp-governance/mcp-gateway/manage-mcp-gateway.md) * [Policy Groups](ai-stack/agent-base/mcp-governance/policy-groups/README.md) * [Manage Policy Groups](ai-stack/agent-base/mcp-governance/policy-groups/manage-policy-groups.md) + * [MCP Connectors](ai-stack/agent-base/mcp-connectors/README.md) + * [Browse the Connector Catalog](ai-stack/agent-base/mcp-connectors/browse-connector-catalog.md) + * [Connect a Connector](ai-stack/agent-base/mcp-connectors/connect-a-connector.md) + * [Manage Connected Connectors](ai-stack/agent-base/mcp-connectors/manage-connected-connectors.md) * [Private Networking](ai-stack/agent-base/private-networking.md) * [Usage & Budget](ai-stack/agent-base/usage-budget/README.md) * [View Usage & Cost](ai-stack/agent-base/usage-budget/view-usage-cost.md) diff --git a/English/ai-stack/agent-base/mcp-connectors/README.md b/English/ai-stack/agent-base/mcp-connectors/README.md new file mode 100644 index 000000000..bb2aebe5b --- /dev/null +++ b/English/ai-stack/agent-base/mcp-connectors/README.md @@ -0,0 +1,89 @@ +# MCP Connectors + +**MCP Connectors** let you connect an agent to external services — GitHub, Slack, Microsoft 365... — in minutes, without building an MCP server or hand-coding OAuth from scratch. + +--- + +## Architecture + +A connector has 2 separate flows: the **connect flow** (a one-time OAuth/API Key setup when you click Connect) and the **runtime tool-call flow** (every time an agent calls a tool through the Gateway). + +### Connect flow + +You (an Admin/Editor) trigger this flow by clicking **Connect** on a connector in the Catalog — see the detailed UI steps in [Connect a Connector](connect-a-connector.md). The diagram below shows the architecture for **OAuth 3LO** — the mode with the most steps, since it requires your consent via the browser: + +![Connector connect flow via OAuth 3LO](../../../.gitbook/assets/mcp-connector/mcp_connector_connect_flow.png) + +{% hint style="info" %} +The diagram above illustrates OAuth 3LO. With **OAuth 2LO**, **API Key**, **Inbound forward**, or **No authorization**, there's no consent-screen step — the system stores the credential (if any) and creates the Connector as soon as you click **Connect**, without leaving the modal. +{% endhint %} + +{% hint style="info" %} +A connector is scoped to the project — any member with project access shares the same connection. +{% endhint %} + +### Runtime tool-call flow + +When an agent calls a tool, the request flows through the exact components you configured at Connect time — MCP Gateway (Inbound Auth) → MCP Connector (Outbound Auth) → MCP Server → Provider: + +![Agent tool call flow via the MCP Gateway](../../../.gitbook/assets/mcp-connector/agent_call_via_mcp_gateway_flow.png) + +| Outbound Auth mode | Where the credential comes from | +|---|---| +| **OAuth** (2LO/3LO) | Secret Provider (Managed, created by GreenNode, or Custom, configured by you) via **Access Control** | +| **API Key** (2LO/3LO) | Secret Provider (Managed/Custom) via **Access Control**, or an API Key/Token pasted directly | +| **Inbound forward** | The same credential the agent used at the Inbound Auth step — requires the Gateway's Inbound Auth ≠ **No authorization** | +| **No authorization** | No credential attached | + +--- + +## Connector Catalog + +The catalog shows the connectors AgentBase ships prebuilt, with an **Add Custom Connector** card always at the start of the grid to add a custom MCP server. Each connector card shows its name, provider, and the supported Auth Mode badges (e.g. `OAuth 3LO`, `API Key 3LO`). + +{% hint style="info" %} +The number of prebuilt connectors changes over time as AgentBase adds new providers — check the exact count on the **Catalog** tab, under "List catalog (N)". +{% endhint %} + +At the time of writing, the catalog includes the following connectors (the list is updated progressively as AgentBase adds providers): + +| Connector | Provider | Note | +|---|---|---| +| GitHub | GitHub | | +| Slack | Slack | | +| M365 VNG | Microsoft | Bundles 4 Microsoft 365 services: SharePoint, Outlook Mail, Outlook Calendar, Microsoft Teams | + +--- + +## Authentication Modes + +The Connect modal is shared across every connector, with 4 authentication modes: + +| Mode | Description | +|---|---| +| **OAuth** | Authenticates through the provider — has 2 sub-modes: **2LO** (server-to-server, no user consent) and **3LO** (requires user consent via the provider's consent screen) | +| **API Key** | Paste a static API Key/Token obtained from the external service | +| **Inbound forward** | Reuses the MCP Gateway's own **Inbound Auth** credential as the outbound auth — only available when the Gateway's Inbound Auth is not **No authorization** | +| **No authorization** | No authentication required | + +{% hint style="info" %} +Not every connector supports all 4 modes: +- Some connectors only allow **OAuth** or **API Key**, with **Inbound forward** and **No authorization** unsupported. +- **Inbound forward** only works when the selected MCP Gateway's **Inbound Auth** is not **No authorization** (i.e. IAM Permissions or JWT) — this mode forwards that same inbound credential as the outbound auth to the MCP server. +{% endhint %} + +--- + +## Custom Connector + +If the service you need isn't in the catalog, click the **Add Custom Connector** card (always at the start of the grid) to connect any MCP-compatible server with a custom configuration, through the same 4-mode auth modal above. + +--- + +## Getting Started with MCP Connectors + +| I want to... | Go to | +|---|---| +| Browse and find a connector in the Catalog | [Browse the Connector Catalog](browse-connector-catalog.md) | +| Connect a connector to my project | [Connect a Connector](connect-a-connector.md) | +| View, edit, or disconnect a connected connector | [Manage Connected Connectors](manage-connected-connectors.md) | diff --git a/English/ai-stack/agent-base/mcp-connectors/browse-connector-catalog.md b/English/ai-stack/agent-base/mcp-connectors/browse-connector-catalog.md new file mode 100644 index 000000000..66daf25f7 --- /dev/null +++ b/English/ai-stack/agent-base/mcp-connectors/browse-connector-catalog.md @@ -0,0 +1,39 @@ +# Browse the Connector Catalog + +> This guide helps you find the right connector in the Connector Catalog — search by name, filter, and start connecting it. + +--- + +## Prerequisites + +- Signed in to AgentBase with at least **Member** access on the project. + +--- + +## Open the Connector Catalog + +1. Click **AgentBase** → **MCP Connectors** in the sidebar. + +The **MCP Connectors** page opens with 2 tabs: **Catalog** (active by default) and **Connected**. The **Catalog** tab shows the current connector count (e.g. "List catalog (8)"), an **Add Custom Connector** card always at the start of the grid, and the remaining prebuilt connector cards — each with an icon, name, provider, supported Auth Mode badges, and a **Connect** button. + +![The MCP Connectors Catalog page](../../../.gitbook/assets/mcp-connector/mcp-connector-catalog-list.png) + +--- + +## Search and filter connectors + +1. Click the **Search connectors** field and type the connector name. +2. Select a value in the **Select a value** dropdown on the right to narrow the list. + +Click **Reload** to refresh the list if a new connector was just added to the catalog. + +--- + +## Result + +You've found the right connector in the Catalog and are ready to connect it. + +| I want to next... | Go to | +|---|---| +| Connect the connector I just found | [Connect a Connector](connect-a-connector.md) | +| Manage a connector I already connected | [Manage Connected Connectors](manage-connected-connectors.md) | diff --git a/English/ai-stack/agent-base/mcp-connectors/connect-a-connector.md b/English/ai-stack/agent-base/mcp-connectors/connect-a-connector.md new file mode 100644 index 000000000..c57424d84 --- /dev/null +++ b/English/ai-stack/agent-base/mcp-connectors/connect-a-connector.md @@ -0,0 +1,83 @@ +# Connect a Connector + +> This guide helps you connect a connector from the Catalog to your project — configure the Gateway, pick the right Authentication mode, and complete authentication. + +--- + +## Prerequisites + +- **Admin** or **Editor** access in the AgentBase product, or equivalent permission granted via **IAM Policy**. +- At least 1 **MCP Gateway** already created to attach the connector to. +- For **OAuth** or **API Key** modes: a matching Secret Provider already set up, or use the **Managed** secret AgentBase provides. + +--- + +## Open the Connect modal + +1. Click **Connect** on the card of the connector you want, in the Catalog. + +The **Connect [Connector Name]** modal opens with 3 fixed sections: + +- **GENERAL** — **Connector Name** (required), **Description** (optional) +- **CONFIGURATION** — **MCP Gateway** (required, select from a dropdown, or click **+** to create a new one), **MCP URL** (auto-generated from the selected Gateway, not editable) +- **AUTHENTICATION** — select an **Authentication mode**: **OAuth** / **API Key** / **Inbound forward** / **No authorization** + +![The GENERAL, CONFIGURATION, and AUTHENTICATION sections of the Connect modal](../../../.gitbook/assets/mcp-connector/connect-mcp-detail-part1.png) + +{% hint style="info" %} +Some Authentication modes may be disabled: +- Depending on the connector — some connectors only allow **OAuth** or **API Key**; **Inbound forward** and **No authorization** aren't supported on those. +- **Inbound forward** only works when the selected **MCP Gateway**'s **Inbound Auth** is not **No authorization** (i.e. IAM Permissions or JWT) — this mode forwards the same credential the agent used to authenticate inbound to the Gateway, reusing it as the outbound auth to the MCP server. If Inbound Auth = No authorization, there's no credential to forward, so this mode is disabled. +{% endhint %} + +--- + +## Configure Authentication mode = OAuth + +1. Select **OAuth** in the AUTHENTICATION section. +2. Select the **OAuth mode**: **2LO** (server-to-server) or **3LO** (requires user consent via the provider's consent screen) — depending on what the connector supports. +3. Select the **Secret source**: **Managed** (use a secret AgentBase already manages) or **Custom** (bring your own Client ID/Secret). +4. Select the matching **Secret Provider** in the dropdown. +5. Open **Advanced settings** and fill in: + - **OAuth scopes** — pre-selected scopes for the connector; removable or you can type new ones, with at least 1 scope required; use **Copy** or **Reset** to copy/restore the default list. + - **Return URL** — the OAuth callback URL, defaulting to your AgentBase domain. + - **Parameters** (optional) — click **Add parameter** to add a custom **Header key** / **Header value prefix** pair (e.g. `Authorization` / `Bearer`). +6. Click **Connect** (or **Authorize** for OAuth 3LO) once everything is filled in. + +![Secret source, Secret Provider, and Advanced settings in the Connect modal](../../../.gitbook/assets/mcp-connector/connect-mcp-detail-part2.png) + +{% hint style="info" %} +**Secret source** ties directly into the [Access Control](../access-control/README.md) feature (Identity): +- **Managed** — quickly pick a Secret Provider GreenNode already created, with no need to set up your own OAuth App. +- **Custom** — if the provider you need isn't available as Managed (e.g. Slack), you must create the OAuth App yourself on the matching platform, then add it as an OAuth Provider in **Access Control** — only then does it appear in the Secret Provider dropdown when creating an MCP Gateway/Connector. +- Access Control also supports **OAuth public client** — only a Client ID is required, no Client Secret. +{% endhint %} + +For **OAuth 3LO**, the system opens a new tab/popup to the provider's consent screen — review the requested scopes, then accept to complete the flow. + +--- + +## Configure Authentication mode = API Key + +1. Select **API Key** in the AUTHENTICATION section. +2. Select the **API Key mode**: **2LO** or **3LO**. +3. Paste the **API Key/Token** obtained from the external service, or select an already-configured **Secret Provider**. +4. For **3LO**, also fill in the **Return URL**. +5. Click **Connect**. + +--- + +## Configure Authentication mode = Inbound forward / No authorization + +1. Select **Inbound forward** or **No authorization** in the AUTHENTICATION section — **Inbound forward** only works when the selected **MCP Gateway**'s **Inbound Auth** is not **No authorization** (IAM Permissions or JWT), since this mode forwards that inbound credential as the outbound auth. +2. Click **Connect** — no additional credentials are needed. + +--- + +## Result + +The connector appears in the **Connected** tab with status **ACTIVE**, ready to be attached to an agent. + +| I want to next... | Go to | +|---|---| +| View, edit, or disconnect the connector I just created | [Manage Connected Connectors](manage-connected-connectors.md) | diff --git a/English/ai-stack/agent-base/mcp-connectors/manage-connected-connectors.md b/English/ai-stack/agent-base/mcp-connectors/manage-connected-connectors.md new file mode 100644 index 000000000..e326168be --- /dev/null +++ b/English/ai-stack/agent-base/mcp-connectors/manage-connected-connectors.md @@ -0,0 +1,58 @@ +# Manage Connected Connectors + +> This guide helps you view the list, inspect a connector's tools, and edit or disconnect connectors already connected in your project. + +--- + +## Prerequisites + +- The project has at least 1 connected connector. +- **Admin** or **Editor** access to edit/delete — the **Member** role can only view the list. + +--- + +## View connected connectors + +1. Click the **Connected** tab in the **MCP Connectors** page. + +The table shows columns: **Connector name**, **Tool**, **MCP Gateway**, **Auth Method**, **Endpoint**, **Last updated**, **Action (Edit/Delete)**. You can filter by **MCP Gateway** or **MCP Gateway status** above the table. + +![The connected connectors table](../../../.gitbook/assets/mcp-connector/mcp-connected-list.png) + +{% hint style="info" %} +For your agent to use this connector's tools, copy the connector's **Endpoint** value, then configure/point your AI agent to connect to that MCP address. +{% endhint %} + +--- + +## View a connector's detail page + +1. Click the connector's name in the **Connector name** column of the Connected table. + +The detail page opens with a status badge (e.g. **ACTIVE**) next to the connector name, plus **Edit** and **Delete** buttons in the top-right corner. The **General information** section shows Connector name, Auth Method, Endpoint, MCP Gateway, and Last updated. + +The **Detail information** section has a **Tools & Permissions** tab — listing every tool this connector provides, with a description and parameter list when you expand each tool. Click **Sync tools** to refresh the tool list from the MCP server. + +![The connector detail page — General information and Tools & Permissions](../../../.gitbook/assets/mcp-connector/mcp-connected-detail-page.png) + +--- + +## Edit or delete a connector + +1. Open the detail page of the connector you want to act on (see the step above). +2. Click **Edit** to change its configuration, or click **Delete** to disconnect it. + +{% hint style="warning" %} +Deleting a connector cannot be undone. Check which agents are using this connector before deleting it. +{% endhint %} + +--- + +## Result + +You have full visibility into every connector connected in the project, know exactly which tools each one provides, and can edit or disconnect them as needed. + +| I want to next... | Go to | +|---|---| +| Connect another connector | [Connect a Connector](connect-a-connector.md) | +| Browse the catalog again | [Browse the Connector Catalog](browse-connector-catalog.md) | diff --git a/English/ai-stack/ai-platform/model-as-a-service/README.md b/English/ai-stack/model-as-a-service/README.md similarity index 88% rename from English/ai-stack/ai-platform/model-as-a-service/README.md rename to English/ai-stack/model-as-a-service/README.md index 342614d4f..d8d8343e8 100644 --- a/English/ai-stack/ai-platform/model-as-a-service/README.md +++ b/English/ai-stack/model-as-a-service/README.md @@ -8,7 +8,7 @@ description: >- Access the [Models ](https://aiplatform.console.greennode.ai/models)section in AI Platform: -* To use and enable any model, you need an API key. [See more details](../getting-started-with-ai-platform.md). +* To use and enable any model, you need an API key. [See more details](../ai-platform/getting-started-with-ai-platform.md). You can filter models using the options on the left sidebar: @@ -30,16 +30,16 @@ You can filter models using the options on the left sidebar: ### Enable / Disable Models 1. Click the "Toggle models" button. Users must activate billing to enable models. For Prepaid users, quota must be added before enabling models, while Postpaid users can enable and use models immediately. Refer to [pricing details](pricing.md).\ - ![](<../../../.gitbook/assets/image (390) (1).png>) + ![](<../../.gitbook/assets/image (390) (1).png>) 2. Model Selection: A popup window will appear, allowing you to search and filter models by Provider, Status, or Type. 3. Enable/disable models individually or in bulk. 4. Save your changes. -
+
To start experimenting and comparing models before integration, you can use the [Playground](playground.md) -
+
### Experiment with AI Platform Playground diff --git a/English/ai-stack/ai-platform/model-as-a-service/available-models.md b/English/ai-stack/model-as-a-service/available-models.md similarity index 100% rename from English/ai-stack/ai-platform/model-as-a-service/available-models.md rename to English/ai-stack/model-as-a-service/available-models.md diff --git a/English/ai-stack/ai-platform/model-as-a-service/maas-api.md b/English/ai-stack/model-as-a-service/maas-api.md similarity index 52% rename from English/ai-stack/ai-platform/model-as-a-service/maas-api.md rename to English/ai-stack/model-as-a-service/maas-api.md index 07acc2e61..381b702d1 100644 --- a/English/ai-stack/ai-platform/model-as-a-service/maas-api.md +++ b/English/ai-stack/model-as-a-service/maas-api.md @@ -6,12 +6,12 @@ Tham khảo các Script trong API Usage trên Portal _Curl_ -
+
_Python_ -
+
Javascript -
+
diff --git a/English/ai-stack/ai-platform/model-as-a-service/ocr-api-usage-guide.md b/English/ai-stack/model-as-a-service/ocr-api-usage-guide.md similarity index 100% rename from English/ai-stack/ai-platform/model-as-a-service/ocr-api-usage-guide.md rename to English/ai-stack/model-as-a-service/ocr-api-usage-guide.md diff --git a/English/ai-stack/ai-platform/model-as-a-service/playground.md b/English/ai-stack/model-as-a-service/playground.md similarity index 93% rename from English/ai-stack/ai-platform/model-as-a-service/playground.md rename to English/ai-stack/model-as-a-service/playground.md index 401ef7be3..f4c327b18 100644 --- a/English/ai-stack/ai-platform/model-as-a-service/playground.md +++ b/English/ai-stack/model-as-a-service/playground.md @@ -17,7 +17,7 @@ description: >- * In the System prompt section, define instructions or context for the model. You can also add examples to guide its behavior. 4. Adjust parameters: -
+
5. Start experimenting: @@ -32,7 +32,7 @@ description: >- * Python: Provides ready-to-use Python code snippets for your projects. * Node.js: Provides Node.js code snippets, suitable for web and server-side applications. -
+
### Model Parameter Tuning Guide diff --git a/English/ai-stack/ai-platform/model-as-a-service/pricing.md b/English/ai-stack/model-as-a-service/pricing.md similarity index 88% rename from English/ai-stack/ai-platform/model-as-a-service/pricing.md rename to English/ai-stack/model-as-a-service/pricing.md index 7882f2d2e..108802931 100644 --- a/English/ai-stack/ai-platform/model-as-a-service/pricing.md +++ b/English/ai-stack/model-as-a-service/pricing.md @@ -39,7 +39,7 @@ Applies to models such as: * **Output tokens** * Each token type has **its own unit price**. -
+
* Pricing is calculated **per 1,000,000 tokens**. @@ -73,7 +73,7 @@ Pricing is based on: ⇒ Each image configuration has a different price. -
+
*** @@ -85,9 +85,9 @@ Pricing is based on: * Users must purchase user credits in advance using the Top-up credits feature. -
+
-
+
* For each model usage: * Generated tokens and/or images will be: diff --git a/English/ai-stack/ai-platform/model-as-a-service/using-maas-with-ai-gateway.md b/English/ai-stack/model-as-a-service/using-maas-with-ai-gateway.md similarity index 76% rename from English/ai-stack/ai-platform/model-as-a-service/using-maas-with-ai-gateway.md rename to English/ai-stack/model-as-a-service/using-maas-with-ai-gateway.md index 16dd7b7c3..46b0a41ea 100644 --- a/English/ai-stack/ai-platform/model-as-a-service/using-maas-with-ai-gateway.md +++ b/English/ai-stack/model-as-a-service/using-maas-with-ai-gateway.md @@ -6,7 +6,7 @@ To enable MaaS to leverage AI Gateway features (such as Rate Limiting, Model Cac **Step 2**: In the left-hand menu, select AI Gateway, then click the Create an AI Gateway button. -
+
**Step 3**: On the Create New Gateway screen, fill in the following information: @@ -26,29 +26,29 @@ To enable MaaS to leverage AI Gateway features (such as Rate Limiting, Model Cac * header\_name: Enter `Authorization`. * header\_value: Enter the MaaS API Key (created in the AI Platform [Portal ](https://aiplatform.console.greennode.ai/keys)). -
+
* **Gateway Config:** By default, the system enables the Authenticated Gateway feature. **Step 4**: Click Create an AI Gateway. Your AI Gateway will be initialized and ready to use. -
+
**Step 5:** After the AI Gateway is created, generate a Token to call the API. **Step 6:** After creating the token, you can configure specific rate limits for each token based on your needs -
+
-
+
\ **Step 7**: In the Providers & Model section, locate the AI model you configured. Click the Curl command icon to get a sample request. -
+
**Step 8:** Copy the displayed curl command and execute it on your local machine (via Terminal or Command Prompt). -
+
Example: diff --git a/English/overview/product-updates-all/2025.md b/English/overview/product-updates-all/2025.md index 647ce0817..87ae36622 100644 --- a/English/overview/product-updates-all/2025.md +++ b/English/overview/product-updates-all/2025.md @@ -191,7 +191,7 @@ Supports access tracking, audit logs, and usage monitoring through metrics and a **Model-as-a-Service** Supports access to a wide range of leading GenAI models—GPT, Claude, Gemini, DeepSeek, and more—through a unified API.\ -\&#xNAN;_Reference documentation available_ [_here_](https://app.gitbook.com/s/B0NrrrdJdpYOYzRkbWp5/ai-stack/ai-platform/model-as-a-service)_._ +\&#xNAN;_Reference documentation available_ [_here_](https://app.gitbook.com/s/B0NrrrdJdpYOYzRkbWp5/ai-stack/model-as-a-service)_._ *** diff --git a/English/overview/product-updates-all/2026.md b/English/overview/product-updates-all/2026.md index 5dc3622c7..32ac0fab7 100644 --- a/English/overview/product-updates-all/2026.md +++ b/English/overview/product-updates-all/2026.md @@ -262,7 +262,7 @@ GreenNode has released **Agentbase** — a purpose-built infrastructure platform MAAS provides AI models as a service, making it easy for customers to use models on a centralized management platform in a simple and cost-effective way. -Learn more about how to create the service here or experience the service now [here](https://docs.vngcloud.vn/vng-cloud-document/vn/ai-stack/ai-platform/model-as-a-service). +Learn more about how to create the service here or experience the service now [here](https://docs.vngcloud.vn/vng-cloud-document/vn/ai-stack/model-as-a-service). **vWAF (Web Application Firewall)** diff --git a/Vietnamese/.gitbook/assets/mcp-connector/agent_call_via_mcp_gateway_flow.png b/Vietnamese/.gitbook/assets/mcp-connector/agent_call_via_mcp_gateway_flow.png new file mode 100644 index 000000000..4771c5e80 Binary files /dev/null and b/Vietnamese/.gitbook/assets/mcp-connector/agent_call_via_mcp_gateway_flow.png differ diff --git a/Vietnamese/.gitbook/assets/mcp-connector/connect-mcp-detail-part1.png b/Vietnamese/.gitbook/assets/mcp-connector/connect-mcp-detail-part1.png new file mode 100644 index 000000000..33842f76e Binary files /dev/null and b/Vietnamese/.gitbook/assets/mcp-connector/connect-mcp-detail-part1.png differ diff --git a/Vietnamese/.gitbook/assets/mcp-connector/connect-mcp-detail-part2.png b/Vietnamese/.gitbook/assets/mcp-connector/connect-mcp-detail-part2.png new file mode 100644 index 000000000..7c8ca3093 Binary files /dev/null and b/Vietnamese/.gitbook/assets/mcp-connector/connect-mcp-detail-part2.png differ diff --git a/Vietnamese/.gitbook/assets/mcp-connector/mcp-connected-detail-page.png b/Vietnamese/.gitbook/assets/mcp-connector/mcp-connected-detail-page.png new file mode 100644 index 000000000..6dd853d60 Binary files /dev/null and b/Vietnamese/.gitbook/assets/mcp-connector/mcp-connected-detail-page.png differ diff --git a/Vietnamese/.gitbook/assets/mcp-connector/mcp-connected-list.png b/Vietnamese/.gitbook/assets/mcp-connector/mcp-connected-list.png new file mode 100644 index 000000000..3576372f5 Binary files /dev/null and b/Vietnamese/.gitbook/assets/mcp-connector/mcp-connected-list.png differ diff --git a/Vietnamese/.gitbook/assets/mcp-connector/mcp-connector-catalog-list.png b/Vietnamese/.gitbook/assets/mcp-connector/mcp-connector-catalog-list.png new file mode 100644 index 000000000..d39ab7064 Binary files /dev/null and b/Vietnamese/.gitbook/assets/mcp-connector/mcp-connector-catalog-list.png differ diff --git a/Vietnamese/.gitbook/assets/mcp-connector/mcp_connector_connect_flow.png b/Vietnamese/.gitbook/assets/mcp-connector/mcp_connector_connect_flow.png new file mode 100644 index 000000000..bf686bc85 Binary files /dev/null and b/Vietnamese/.gitbook/assets/mcp-connector/mcp_connector_connect_flow.png differ diff --git a/Vietnamese/SUMMARY.md b/Vietnamese/SUMMARY.md index 6e3e3b305..9b2a13796 100644 --- a/Vietnamese/SUMMARY.md +++ b/Vietnamese/SUMMARY.md @@ -818,13 +818,13 @@ * [Import Model Registry sử dụng Triton](ai-stack/ai-platform/model-registry/import-model-registry-su-dung-triton.md) * [Import Model Registry sử dụng vLLM](ai-stack/ai-platform/model-registry/import-vllm-model.md) * [Import Model Registry với custom container](ai-stack/ai-platform/model-registry/import-model-registry-voi-custom-container.md) - * [Model as a Service (MaaS)](ai-stack/ai-platform/model-as-a-service/README.md) - * [Hướng dẫn sử dụng API OCR](ai-stack/ai-platform/model-as-a-service/huong-dan-su-dung-api-ocr.md) - * [Playground](ai-stack/ai-platform/model-as-a-service/playground.md) - * [Các Model được cung cấp](ai-stack/ai-platform/model-as-a-service/cac-model-duoc-cung-cap.md) - * [MaaS API](ai-stack/ai-platform/model-as-a-service/maas-api.md) - * [Sử dụng MaaS với AI Gateway](ai-stack/ai-platform/model-as-a-service/su-dung-maas-voi-ai-gateway.md) - * [Cách tính phí](ai-stack/ai-platform/model-as-a-service/cach-tinh-phi.md) + * [Model as a Service (MaaS)](ai-stack/model-as-a-service/README.md) + * [Hướng dẫn sử dụng API OCR](ai-stack/model-as-a-service/huong-dan-su-dung-api-ocr.md) + * [Playground](ai-stack/model-as-a-service/playground.md) + * [Các Model được cung cấp](ai-stack/model-as-a-service/cac-model-duoc-cung-cap.md) + * [MaaS API](ai-stack/model-as-a-service/maas-api.md) + * [Sử dụng MaaS với AI Gateway](ai-stack/model-as-a-service/su-dung-maas-voi-ai-gateway.md) + * [Cách tính phí](ai-stack/model-as-a-service/cach-tinh-phi.md) * [AI Gateway](ai-stack/ai-gateway/README.md) * [AI Gateway là gì?](ai-stack/ai-gateway/ai-gateway-la-gi.md) * [Bắt đầu với AI Gateway](ai-stack/ai-gateway/bat-dau-voi-ai-gateway.md) @@ -882,6 +882,10 @@ * [Quản lý MCP Gateway](ai-stack/agent-base/mcp-governance/mcp-gateway/quan-ly-mcp-gateway.md) * [Policy Groups](ai-stack/agent-base/mcp-governance/policy-groups/README.md) * [Quản lý Policy Group](ai-stack/agent-base/mcp-governance/policy-groups/quan-ly-policy-group.md) + * [MCP Connectors](ai-stack/agent-base/mcp-connectors/README.md) + * [Tìm Connector trong Catalog](ai-stack/agent-base/mcp-connectors/duyet-catalog-connector.md) + * [Kết nối Connector](ai-stack/agent-base/mcp-connectors/ket-noi-connector.md) + * [Quản lý Connector đã kết nối](ai-stack/agent-base/mcp-connectors/quan-ly-connector-da-ket-noi.md) * [Mạng riêng tư](ai-stack/agent-base/private-networking.md) * [Usage & Budget](ai-stack/agent-base/usage-budget/README.md) * [Xem Usage & Cost](ai-stack/agent-base/usage-budget/xem-usage-cost.md) diff --git a/Vietnamese/ai-stack/agent-base/mcp-connectors/README.md b/Vietnamese/ai-stack/agent-base/mcp-connectors/README.md new file mode 100644 index 000000000..71c51a361 --- /dev/null +++ b/Vietnamese/ai-stack/agent-base/mcp-connectors/README.md @@ -0,0 +1,90 @@ +# MCP Connectors + +**MCP Connectors** giúp bạn kết nối agent với các dịch vụ bên ngoài — GitHub, Slack, Microsoft 365... — chỉ trong vài phút, mà không cần tự dựng MCP server hay tự code OAuth từ đầu. + +--- + +## Kiến trúc + +Connector có 2 luồng tách biệt: **luồng kết nối** (thiết lập OAuth/API Key một lần khi bạn nhấn Connect) và **luồng gọi tool lúc runtime** (mỗi lần agent gọi tool qua Gateway). + +### Luồng kết nối (Connect) + +Bạn (Admin/Editor) là người thực hiện luồng này khi nhấn **Connect** trên 1 connector trong Catalog — xem từng bước UI chi tiết tại [Kết nối Connector](ket-noi-connector.md). Sơ đồ dưới đây minh hoạ ở mức kiến trúc cho trường hợp **OAuth 3LO** — mode có đầy đủ bước nhất vì cần bạn xác nhận qua browser: + +![Luồng kết nối connector qua OAuth 3LO](../../../.gitbook/assets/mcp-connector/mcp_connector_connect_flow.png) + +{% hint style="info" %} +Sơ đồ trên minh hoạ OAuth 3LO. Với **OAuth 2LO**, **API Key**, **Inbound forward** hoặc **No authorization**, không có bước consent screen — hệ thống lưu credential (nếu có) và tạo Connector ngay sau khi bạn nhấn **Connect**, không cần rời khỏi modal. +{% endhint %} + +{% hint style="info" %} +Connector được scope theo project — mọi thành viên có quyền truy cập project đều dùng chung 1 kết nối. +{% endhint %} + +### Luồng gọi tool (Runtime) + +Khi agent gọi 1 tool, request đi qua đúng các thành phần bạn đã cấu hình lúc Connect — MCP Gateway (Inbound Auth) → MCP Connector (Outbound Auth) → MCP Server → Provider: + +![Luồng agent gọi tool qua MCP Gateway](../../../.gitbook/assets/mcp-connector/agent_call_via_mcp_gateway_flow.png) + +| Outbound Auth mode | Credential lấy từ đâu | +|---|---| +| **OAuth** (2LO/3LO) | Secret Provider (Managed do GreenNode tạo sẵn, hoặc Custom tự cấu hình) qua **Access Control** | +| **API Key** (2LO/3LO) | Secret Provider (Managed/Custom) qua **Access Control**, hoặc API Key/Token dán trực tiếp | +| **Inbound forward** | Credential mà agent đã dùng ở bước Inbound Auth — yêu cầu Inbound Auth của Gateway ≠ **No authorization** | +| **No authorization** | Không đính kèm credential nào | + +--- + +## Connector Catalog + +Catalog hiển thị danh sách connector do AgentBase cung cấp sẵn, luôn có 1 card **Add Custom Connector** ở đầu grid để thêm MCP server tùy chỉnh. Mỗi card connector hiển thị tên, provider và các badge Auth Mode được hỗ trợ (ví dụ `OAuth 3LO`, `API Key 3LO`). + +{% hint style="info" %} +Số lượng connector prebuilt thay đổi theo thời gian khi AgentBase bổ sung provider mới — xem số liệu chính xác tại tab **Catalog**, mục "List catalog (N)". +{% endhint %} + +Tại thời điểm viết tài liệu này, catalog gồm các connector sau (danh sách được AgentBase cập nhật dần theo thời gian): + +| Connector | Provider | Ghi chú | +| --------- | --------- | ------------------------------------------------------------------------------------------- | +| GitHub | GitHub | | +| Slack | Slack | | +| M365 VNG | Microsoft | Gộp 4 dịch vụ Microsoft 365: SharePoint, Outlook Mail, Outlook Calendar, Microsoft Teams | + +--- + +## Chế độ xác thực (Authentication Mode) + +Modal Connect dùng chung cho mọi connector, với 4 chế độ xác thực: + +| Mode | Mô tả | +| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **OAuth** | Xác thực qua provider — có 2 sub-mode:**2LO** (server-to-server, không cần user consent) và **3LO** (yêu cầu user đồng ý qua consent screen của provider) | +| **API Key** | Dán static API Key/Token đã lấy từ dịch vụ bên ngoài | +| **Inbound forward** | Dùng lại chính credential**Inbound Auth** của MCP Gateway làm Outbound auth — chỉ khả dụng khi Inbound Auth của Gateway khác **No authorization** | +| **No authorization** | Không yêu cầu xác thực | + +{% hint style="info" %} +Không phải connector nào cũng hỗ trợ cả 4 chế độ: + +- Một số connector chỉ cho chọn **OAuth** hoặc **API Key**, không hỗ trợ **Inbound forward** và **No authorization**. +- **Inbound forward** chỉ dùng được khi **Inbound Auth** của MCP Gateway đã chọn khác **No authorization** (tức IAM Permissions hoặc JWT) — vì mode này forward chính credential Inbound đó sang làm Outbound auth gọi tới MCP server. +{% endhint %} + +--- + +## Custom Connector + +Nếu dịch vụ bạn cần không có sẵn trong catalog, nhấn card **Add Custom Connector** (luôn nằm đầu grid) để kết nối bất kỳ MCP-compatible server nào với cấu hình tùy chỉnh, qua cùng modal xác thực 4-mode ở trên. + +--- + +## Bắt đầu với MCP Connectors + +| Tôi muốn... | Đi đến | +| ------------------------------------------------------------- | -------------------------------------------------------------------- | +| Tìm connector trong Catalog | [Tìm Connector trong Catalog](duyet-catalog-connector.md) | +| Kết nối một connector vào project | [Kết nối Connector](ket-noi-connector.md) | +| Xem, chỉnh sửa hoặc ngắt kết nối connector đã connect | [Quản lý Connector đã kết nối](quan-ly-connector-da-ket-noi.md) | diff --git a/Vietnamese/ai-stack/agent-base/mcp-connectors/duyet-catalog-connector.md b/Vietnamese/ai-stack/agent-base/mcp-connectors/duyet-catalog-connector.md new file mode 100644 index 000000000..70832f86c --- /dev/null +++ b/Vietnamese/ai-stack/agent-base/mcp-connectors/duyet-catalog-connector.md @@ -0,0 +1,39 @@ +# Tìm Connector trong Catalog + +> Hướng dẫn này giúp bạn tìm đúng connector cần dùng trong Connector Catalog — tìm kiếm theo tên, lọc theo điều kiện cần, và bắt đầu kết nối. + +--- + +## Điều kiện cần + +- Đã đăng nhập AgentBase và có quyền tối thiểu **Member** trong project. + +--- + +## Mở Connector Catalog + +1. Nhấn **AgentBase** → **MCP Connectors** trong sidebar. + +Trang **MCP Connectors** mở ra với 2 tab: **Catalog** (mặc định active) và **Connected**. Tab **Catalog** hiển thị số lượng connector hiện có (ví dụ "List catalog (8)"), card **Add Custom Connector** luôn nằm đầu grid, và các card connector prebuilt còn lại — mỗi card gồm icon, tên, provider, badge Auth Mode được hỗ trợ và button **Connect**. + +![Trang Catalog của MCP Connectors](../../../.gitbook/assets/mcp-connector/mcp-connector-catalog-list.png) + +--- + +## Tìm kiếm và lọc connector + +1. Nhấn vào ô **Search connectors** và gõ tên connector cần tìm. +2. Chọn giá trị lọc trong dropdown **Select a value** ở góc phải để thu hẹp danh sách. + +Nhấn **Reload** để làm mới danh sách nếu vừa có connector mới được thêm vào catalog. + +--- + +## Kết quả + +Bạn đã tìm được connector phù hợp trong Catalog và sẵn sàng kết nối nó vào project. + +| Tôi muốn tiếp theo... | Đi đến | +|---|---| +| Kết nối connector vừa tìm thấy | [Kết nối Connector](ket-noi-connector.md) | +| Quản lý connector đã kết nối | [Quản lý Connector đã kết nối](quan-ly-connector-da-ket-noi.md) | diff --git a/Vietnamese/ai-stack/agent-base/mcp-connectors/ket-noi-connector.md b/Vietnamese/ai-stack/agent-base/mcp-connectors/ket-noi-connector.md new file mode 100644 index 000000000..18e0643ba --- /dev/null +++ b/Vietnamese/ai-stack/agent-base/mcp-connectors/ket-noi-connector.md @@ -0,0 +1,83 @@ +# Kết nối Connector + +> Hướng dẫn này giúp bạn kết nối một connector trong Catalog vào project — cấu hình Gateway, chọn Authentication mode phù hợp và hoàn tất xác thực. + +--- + +## Điều kiện cần + +- Có quyền **Admin** hoặc **Editor** trong product AgentBase, hoặc được phân quyền tương ứng qua **IAM Policy**. +- Đã tạo sẵn ít nhất 1 **MCP Gateway** để attach connector vào. +- Với Authentication mode **OAuth** hoặc **API Key**: đã có sẵn Secret Provider tương ứng, hoặc dùng **Managed** secret do AgentBase cung cấp sẵn. + +--- + +## Mở modal Connect + +1. Nhấn **Connect** trên card connector cần kết nối trong Catalog. + +Modal **Connect [Tên connector]** mở ra với 3 section cố định: + +- **GENERAL** — **Connector Name** (bắt buộc), **Description** (tùy chọn) +- **CONFIGURATION** — **MCP Gateway** (bắt buộc chọn từ dropdown, hoặc nhấn **+** để tạo Gateway mới), **MCP URL** (tự sinh theo MCP Connector đã chọn, không chỉnh sửa được) +- **AUTHENTICATION** — chọn **Authentication mode**: **OAuth** / **API Key** / **Inbound forward** / **No authorization** + +![Section GENERAL, CONFIGURATION và AUTHENTICATION của modal Connect](../../../.gitbook/assets/mcp-connector/connect-mcp-detail-part1.png) + +{% hint style="info" %} +Một số Authentication mode có thể bị khoá (disabled): +- Tùy theo connector — một số connector chỉ cho chọn **OAuth** hoặc **API Key**, không hỗ trợ **Inbound forward** và **No authorization**. +- **Inbound forward** chỉ dùng được khi **Inbound Auth** của MCP Gateway đã chọn khác **No authorization** (tức IAM Permissions hoặc JWT) — vì mode này forward chính credential mà agent dùng để xác thực Inbound vào Gateway, sang làm Outbound auth gọi tới MCP server. Nếu Inbound Auth = No authorization thì không có credential nào để forward, nên mode này bị khoá. +{% endhint %} + +--- + +## Cấu hình Authentication mode = OAuth + +1. Chọn **OAuth** ở section AUTHENTICATION. +2. Chọn **OAuth mode**: **2LO** (server-to-server) hoặc **3LO** (yêu cầu user đồng ý qua consent screen của provider) — tùy connector hỗ trợ mode nào. +3. Chọn **Secret source**: **Managed** (dùng secret có sẵn do AgentBase quản lý) hoặc **Custom** (tự cung cấp Client ID/Secret riêng). +4. Chọn **Secret Provider** tương ứng trong dropdown. +5. Mở **Advanced settings** và điền: + - **OAuth scopes** — danh sách scope pre-selected theo connector, có thể xoá bớt hoặc gõ thêm scope mới, tối thiểu phải giữ lại 1 scope; dùng **Copy** hoặc **Reset** để copy/khôi phục danh sách mặc định. + - **Return URL** — URL callback OAuth, mặc định trỏ về domain AgentBase. + - **Parameters** (tùy chọn) — nhấn **Add parameter** để thêm cặp **Header key** / **Header value prefix** tùy chỉnh (ví dụ `Authorization` / `Bearer`). +6. Nhấn **Connect** (hoặc **Authorize** với OAuth 3LO) sau khi điền đầy đủ. + +![Secret source, Secret Provider và Advanced settings trong modal Connect](../../../.gitbook/assets/mcp-connector/connect-mcp-detail-part2.png) + +{% hint style="info" %} +**Secret source** liên kết trực tiếp với tính năng [Access Control](../access-control/README.md) (Identity): +- **Managed** — chọn nhanh 1 Secret Provider do GreenNode tạo sẵn, không cần tự tạo OAuth App. +- **Custom** — nếu provider bạn cần chưa có sẵn ở chế độ Managed (ví dụ Slack), bạn phải tự tạo OAuth App trên nền tảng tương ứng, sau đó thêm nó làm OAuth Provider trong **Access Control** — lúc đó provider mới xuất hiện trong dropdown Secret Provider khi tạo MCP Gateway/Connector. +- Access Control cũng hỗ trợ **OAuth public client** — chỉ cần khai báo Client ID, không cần Client Secret. +{% endhint %} + +Với **OAuth 3LO**, hệ thống mở tab/popup đến trang consent của provider — kiểm tra scope được yêu cầu rồi chấp nhận để hoàn tất. + +--- + +## Cấu hình Authentication mode = API Key + +1. Chọn **API Key** ở section AUTHENTICATION. +2. Chọn **API Key mode**: **2LO** hoặc **3LO**. +3. Dán **API Key/Token** đã lấy từ dịch vụ bên ngoài, hoặc chọn **Secret Provider** đã cấu hình sẵn. +4. Với **3LO**, điền thêm **Return URL**. +5. Nhấn **Connect**. + +--- + +## Cấu hình Authentication mode = Inbound forward / No authorization + +1. Chọn **Inbound forward** hoặc **No authorization** ở section AUTHENTICATION — **Inbound forward** chỉ dùng được khi **Inbound Auth** của MCP Gateway đã chọn khác **No authorization** (IAM Permissions hoặc JWT), vì mode này forward chính credential Inbound đó sang làm Outbound auth. +2. Nhấn **Connect** — không cần điền thêm credential. + +--- + +## Kết quả + +Connector xuất hiện trong tab **Connected** với trạng thái **ACTIVE**, sẵn sàng để attach vào agent. + +| Tôi muốn tiếp theo... | Đi đến | +| ---------------------------------------------------------- | -------------------------------------------------------------------- | +| Xem, chỉnh sửa hoặc ngắt kết nối connector vừa tạo | [Quản lý Connector đã kết nối](quan-ly-connector-da-ket-noi.md) | diff --git a/Vietnamese/ai-stack/agent-base/mcp-connectors/quan-ly-connector-da-ket-noi.md b/Vietnamese/ai-stack/agent-base/mcp-connectors/quan-ly-connector-da-ket-noi.md new file mode 100644 index 000000000..35e8b8911 --- /dev/null +++ b/Vietnamese/ai-stack/agent-base/mcp-connectors/quan-ly-connector-da-ket-noi.md @@ -0,0 +1,58 @@ +# Quản lý Connector đã kết nối + +> Hướng dẫn này giúp bạn xem danh sách, xem chi tiết tool và chỉnh sửa/ngắt kết nối các connector đã connect trong project. + +--- + +## Điều kiện cần + +- Project đã có ít nhất 1 connector được kết nối. +- Có quyền **Admin** hoặc **Editor** để chỉnh sửa/xoá — role **Member** chỉ xem được danh sách. + +--- + +## Xem danh sách connector đã kết nối + +1. Nhấn tab **Connected** trong trang **MCP Connectors**. + +Bảng hiển thị các cột: **Connector name**, **Tool**, **MCP Gateway**, **Auth Method**, **Endpoint**, **Last updated**, **Action (Edit/Delate)**. Bạn có thể lọc theo **MCP Gateway** hoặc **MCP Gateway status** ở phía trên bảng. + +![Bảng danh sách connector đã kết nối](../../../.gitbook/assets/mcp-connector/mcp-connected-list.png) + +{% hint style="info" %} +Để agent của bạn dùng được tool của connector này, copy giá trị cột **Endpoint** của connector tương ứng, rồi cấu hình/yêu cầu AI agent kết nối tới địa chỉ MCP đó. +{% endhint %} + +--- + +## Xem trang chi tiết connector + +1. Nhấn vào tên connector trong cột **Connector name** của bảng Connected. + +Trang chi tiết mở ra với badge trạng thái (ví dụ **ACTIVE**) cạnh tên connector, cùng 2 button **Edit** và **Delete** ở góc phải. Section **General information** hiển thị Connector name, Auth Method, Endpoint, MCP Gateway, Last updated. + +Section **Detail information** có tab **Tools & Permissions** — liệt kê toàn bộ tool mà connector này cung cấp, kèm mô tả và danh sách tham số (parameters) khi mở rộng từng tool. Nhấn **Sync tools** để đồng bộ lại danh sách tool mới nhất từ MCP server. + +![Trang chi tiết connector — General information và Tools & Permissions](../../../.gitbook/assets/mcp-connector/mcp-connected-detail-page.png) + +--- + +## Chỉnh sửa hoặc xoá connector + +1. Mở trang chi tiết của connector cần thao tác (xem bước trên). +2. Nhấn **Edit** để chỉnh sửa cấu hình, hoặc nhấn **Delete** để ngắt kết nối. + +{% hint style="warning" %} +Xoá connector là thao tác không thể hoàn tác. Kiểm tra kỹ agent nào đang dùng connector này trước khi xoá. +{% endhint %} + +--- + +## Kết quả + +Bạn nắm được toàn bộ connector đang kết nối trong project, biết chính xác mỗi connector cung cấp tool gì, và có thể chỉnh sửa hoặc ngắt kết nối khi cần. + +| Tôi muốn tiếp theo... | Đi đến | +| ------------------------------- | ----------------------------------------------------- | +| Kết nối thêm connector khác | [Kết nối Connector](ket-noi-connector.md) | +| Duyệt lại Catalog | [Tìm Connector trong Catalog](duyet-catalog-connector.md) | diff --git a/Vietnamese/ai-stack/ai-platform/model-as-a-service/README.md b/Vietnamese/ai-stack/model-as-a-service/README.md similarity index 87% rename from Vietnamese/ai-stack/ai-platform/model-as-a-service/README.md rename to Vietnamese/ai-stack/model-as-a-service/README.md index 08b99c15c..71a87cc08 100644 --- a/Vietnamese/ai-stack/ai-platform/model-as-a-service/README.md +++ b/Vietnamese/ai-stack/model-as-a-service/README.md @@ -9,7 +9,7 @@ description: >- Truy cập vào phần [Models ](https://aiplatform.console.greennode.ai/models)trong AI Platform: -* Để sử dụng và enable bất kỳ mô hình nào, bạn cần có API key. [xem thêm](../bat-dau-voi-ai-platform.md#id-6.-quan-ly-api-keys) +* Để sử dụng và enable bất kỳ mô hình nào, bạn cần có API key. [xem thêm](../ai-platform/bat-dau-voi-ai-platform.md#id-6.-quan-ly-api-keys) Bạn có thể lọc các mô hình bằng các tùy chọn ở thanh bên trái: @@ -30,19 +30,19 @@ Bạn có thể lọc các mô hình bằng các tùy chọn ở thanh bên trá ### Bật / Tắt mô hình -1. Nhấp vào nút "Bật/Tăt model" (Toggle models). User cần activate billing để enable model, đối với user Prepaid cần nạp quota để enable model còn user Postpaid có thể enable model và sử dụng được ngay. Tham khảo [cách tính phí](https://docs.vngcloud.vn/vng-cloud-document/vn/ai-stack/ai-platform/model-as-a-service/cach-tinh-phi)
+1. Nhấp vào nút "Bật/Tăt model" (Toggle models). User cần activate billing để enable model, đối với user Prepaid cần nạp quota để enable model còn user Postpaid có thể enable model và sử dụng được ngay. Tham khảo [cách tính phí](https://docs.vngcloud.vn/vng-cloud-document/vn/ai-stack/model-as-a-service/cach-tinh-phi)
-
+
1. Lựa chọn mô hình: Một cửa sổ popup sẽ hiện ra. Tại đây, bạn có thể tìm kiếm và lọc mô hình theo Nhà cung cấp (Provider), Trạng thái (Status) hoặc Loại mô hình (Type). 2. Bật/tắt riêng lẻ hoặc hàng loạt mô hình. 3. Lưu (Save) các thay đổi. -
+
Để bắt đầu thử nghiệm và so sánh các mô hình trước khi tích hợp, bạn có thể sử dụng [Playground](playground.md) -
+
### **Thử nghiệm với AI Platform Playground** diff --git a/Vietnamese/ai-stack/ai-platform/model-as-a-service/cac-model-duoc-cung-cap.md b/Vietnamese/ai-stack/model-as-a-service/cac-model-duoc-cung-cap.md similarity index 100% rename from Vietnamese/ai-stack/ai-platform/model-as-a-service/cac-model-duoc-cung-cap.md rename to Vietnamese/ai-stack/model-as-a-service/cac-model-duoc-cung-cap.md diff --git a/Vietnamese/ai-stack/ai-platform/model-as-a-service/cach-tinh-phi.md b/Vietnamese/ai-stack/model-as-a-service/cach-tinh-phi.md similarity index 88% rename from Vietnamese/ai-stack/ai-platform/model-as-a-service/cach-tinh-phi.md rename to Vietnamese/ai-stack/model-as-a-service/cach-tinh-phi.md index 5658d10b0..f998679e7 100644 --- a/Vietnamese/ai-stack/ai-platform/model-as-a-service/cach-tinh-phi.md +++ b/Vietnamese/ai-stack/model-as-a-service/cach-tinh-phi.md @@ -39,7 +39,7 @@ Hiện tại có **2 nhóm model chính**: * **Output tokens** * Mỗi loại tokens có **đơn giá riêng** -
+
* Phí được tính theo **đơn vị 1.000.000 tokens** @@ -73,7 +73,7 @@ Phí được tính dựa trên: ⇒ Mỗi cấu hình hình ảnh sẽ có **đơn giá khác nhau**. -
+
*** @@ -85,9 +85,9 @@ Phí được tính dựa trên: * Người dùng cần **mua trước user-credit** để sử dụng dịch vụ bằng tính năng Top up credits -
+
-
+
* Với mỗi lần sử dụng model: * Tokens và/hoặc images phát sinh sẽ được: @@ -138,7 +138,7 @@ Sau khi recover: * **Tổng hợp và thanh toán vào cuối mỗi tháng** * -
+
*** diff --git a/Vietnamese/ai-stack/ai-platform/model-as-a-service/huong-dan-su-dung-api-ocr.md b/Vietnamese/ai-stack/model-as-a-service/huong-dan-su-dung-api-ocr.md similarity index 100% rename from Vietnamese/ai-stack/ai-platform/model-as-a-service/huong-dan-su-dung-api-ocr.md rename to Vietnamese/ai-stack/model-as-a-service/huong-dan-su-dung-api-ocr.md diff --git a/Vietnamese/ai-stack/ai-platform/model-as-a-service/maas-api.md b/Vietnamese/ai-stack/model-as-a-service/maas-api.md similarity index 50% rename from Vietnamese/ai-stack/ai-platform/model-as-a-service/maas-api.md rename to Vietnamese/ai-stack/model-as-a-service/maas-api.md index a14ba3c9e..f72213fef 100644 --- a/Vietnamese/ai-stack/ai-platform/model-as-a-service/maas-api.md +++ b/Vietnamese/ai-stack/model-as-a-service/maas-api.md @@ -6,12 +6,12 @@ Tham khảo các Script trong API Usage trên Portal _Curl_ -
+
_Python_ -
+
Javascript -
+
diff --git a/Vietnamese/ai-stack/ai-platform/model-as-a-service/playground.md b/Vietnamese/ai-stack/model-as-a-service/playground.md similarity index 89% rename from Vietnamese/ai-stack/ai-platform/model-as-a-service/playground.md rename to Vietnamese/ai-stack/model-as-a-service/playground.md index 43fd67868..6092ca566 100644 --- a/Vietnamese/ai-stack/ai-platform/model-as-a-service/playground.md +++ b/Vietnamese/ai-stack/model-as-a-service/playground.md @@ -17,7 +17,7 @@ description: >- * Trong phần System prompt, hãy định nghĩa các hướng dẫn hoặc ngữ cảnh cho mô hình. Bạn cũng có thể thêm các ví dụ để định hướng hành vi của nó. 4. [Tinh chỉnh các tham số:](playground.md#huong-dan-tinh-chinh-thamso-mo-hinh) -
+
5. Bắt đầu thử nghiệm: * Nhập câu lệnh của bạn và quan sát cách các mô hình khác nhau phản hồi. @@ -30,7 +30,7 @@ description: >- * Python: Cung cấp đoạn mã Python sẵn sàng để bạn sao chép và sử dụng trong các dự án Python của mình. * Node.js: Cung cấp đoạn mã Node.js, phù hợp cho các dự án web và ứng dụng server-side. -
+
### Hướng dẫn tinh chỉnh tham số mô hình @@ -74,7 +74,7 @@ Khi sử dụng Playground, bạn có thể điều chỉnh các thông số sau * Presence Penalty: Mức phạt cho các từ đã xuất hiện trong cuộc trò chuyện, khuyến khích mô hình tạo ra các chủ đề mới và giảm lặp từ. * Phạm vi: -2 đến 2 (Mặc định: 0). -Để xem thêm các thông số chi tiết, bạn có thể tham khảo tài liệu của [vLLM ](../../../)và [OpenAI](https://platform.openai.com/docs/api-reference/introduction). +Để xem thêm các thông số chi tiết, bạn có thể tham khảo tài liệu của [vLLM ](../../)và [OpenAI](https://platform.openai.com/docs/api-reference/introduction). ### So sánh mô hình @@ -83,6 +83,6 @@ Tính năng này cho phép bạn chạy và so sánh kết quả đầu ra của * Nhấp vào nút So sánh (Compare) để mở hai cửa sổ trò chuyện song song. * Bạn có thể nhập câu lệnh và gửi tới cả hai mô hình cùng một lúc để xem phản hồi và đánh giá hiệu quả. -
+
-
+
diff --git a/Vietnamese/ai-stack/ai-platform/model-as-a-service/su-dung-maas-voi-ai-gateway.md b/Vietnamese/ai-stack/model-as-a-service/su-dung-maas-voi-ai-gateway.md similarity index 80% rename from Vietnamese/ai-stack/ai-platform/model-as-a-service/su-dung-maas-voi-ai-gateway.md rename to Vietnamese/ai-stack/model-as-a-service/su-dung-maas-voi-ai-gateway.md index b7dc8a87e..68aaa0b50 100644 --- a/Vietnamese/ai-stack/ai-platform/model-as-a-service/su-dung-maas-voi-ai-gateway.md +++ b/Vietnamese/ai-stack/model-as-a-service/su-dung-maas-voi-ai-gateway.md @@ -6,7 +6,7 @@ **Bước 2:** Trong menu bên trái, chọn mục **AI Gateway**, sau đó nhấn vào nút **Create an AI Gateway**. -
+
**Bước 3:** Tại màn hình **Tạo Gateway mới**, vui lòng điền đầy đủ các thông tin sau: @@ -16,35 +16,35 @@ * **Model Type**: Chọn Model Type (xem tại [MaaS](https://aiplatform.console.greennode.ai/models/md-37404b64-0656-4c85-978c-a6e1b84ea8ac) ở portal AI Platform). * **Model Endpoint**: Điền URL của model (xem tại [MaaS](https://aiplatform.console.greennode.ai/models/md-37404b64-0656-4c85-978c-a6e1b84ea8ac) ở poral AI Platform). * **Model Name**: Điền Name của model (xem tại [MaaS](https://aiplatform.console.greennode.ai/models/md-37404b64-0656-4c85-978c-a6e1b84ea8ac) ở poral AI Platform).\ - ![](<../../../.gitbook/assets/image (3).png>) + ![](<../../.gitbook/assets/image (3).png>) * **Authentication info**: * header\_name: Điền `Authorization`. * header\_value: Điền `Bearer ` ( API Key trong hình được tạo ở [Portal ](https://aiplatform.console.greennode.ai/keys)AI Platform). -
123
+
123
* **Gateway Config:** Mặc định, hệ thống sẽ bật tính năng **Authenticated Gateway.** **Bước 4**: Chọn Create an AI Gateway, AI Gateway của bạn sẽ được khởi tạo và sẵn sàng để sử dụng. -
+
**Bước 5**: Sau khi AI Gateway được khởi tạo bạn cần [tạo Token](https://docs.vngcloud.vn/vng-cloud-document/vn/ai-stack/ai-gateway/ai-gateway/lam-viec-voi-authentication-token) để gọi API. **Bước 6**: Sau khi bạn tạo token, bạn có thể cấu hình rate limit cụ thể trên từng token theo nhu cầu cá nhân. -
+
-
+
\ **Bước 7**: Trong mục **Providers & Model**, tìm mô hình AI bạn đã cấu hình. Tại mô hình đó, nhấn vào biểu tượng **Curl command** để lấy câu lệnh mẫu. -
+
**Bước 8**: Sao chép đoạn lệnh `curl` được hiển thị và thực thi lệnh đó trên máy tính cá nhân của bạn (qua Terminal hoặc Command Prompt). -
+
Ví dụ: diff --git a/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2025.md b/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2025.md index 05c23e7f4..9ce745ce1 100644 --- a/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2025.md +++ b/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2025.md @@ -145,7 +145,7 @@ Hệ sinh thái các dịch vụ chính của AI stack bao gồm: * vDB **OpenSearch:** Vector Database dưới dạng dịch vụ, giúp Hỗ trợ PostgreSQL(**pgvector)** và **OpenSearch** làm vector database.Hỗ trợ triển khai mô hình **RAG (Retrieval-Augmented Generation)** nhanh chóng.Giúp mô hình GenAI hiểu và khai thác dữ liệu doanh nghiệp theo ngữ cảnh. Tài liệu tham khảo [tại đây](../../vdb/opensearch-cluster-database-ods/) * **AI Platform:** Cung cấp môi trường để **thử nghiệm (notebook )**, **fine-tune** và **inference** các mô hình AI ngay trên nền tảng GPU của GreenNode. Tài liệu tham khảo [tại đây](../../ai-stack/ai-platform/) * **AI Gateway:** là Cổng truy cập quản trị tập trung duy nhất cho nhiều mô hình AI, hỗ trợ routing thông minh và caching để tối ưu hiệu năng và chi phí. Giúp theo dõi truy cập, sinh audit logs, giám sát hành vi sử dụng qua metrics và alerts. Tài liệu tham khảo [tại đây](../../ai-stack/ai-gateway/) -* **Model-as-a-Service:** Hỗ trợ truy cập hơn đa dạng **mô hình GenAI** hàng đầu như GPT, Claude, Gemini, DeepSeek... chỉ với 1 API thống nhất. Tài liệu tham khảo [tại đây](../../ai-stack/ai-platform/model-as-a-service/) +* **Model-as-a-Service:** Hỗ trợ truy cập hơn đa dạng **mô hình GenAI** hàng đầu như GPT, Claude, Gemini, DeepSeek... chỉ với 1 API thống nhất. Tài liệu tham khảo [tại đây](../../ai-stack/model-as-a-service/) **Tháng 4, 2025** diff --git a/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2026.md b/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2026.md index 4e10c051d..e348005b9 100644 --- a/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2026.md +++ b/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2026.md @@ -257,7 +257,7 @@ GreenNode ra mắt **Agentbase** — nền tảng hạ tầng chuyên biệt dà MAAS cung cấp các model AI dưới dạng dịch vụ, giúp khách hàng dễ dàng sử dụng các model trên 1 nền tảng quản lý tập trung một cách đơn giản và tiết kiệm chi phí. -Tham khảo thêm cách khởi tạo dịch vụ [tại đây](https://docs.vngcloud.vn/vng-cloud-document/vn/ai-stack/ai-platform/model-as-a-service) hoặc trải nghiệm ngay dịch vụ [tại đây](https://aiplatform.console.greennode.ai/models). +Tham khảo thêm cách khởi tạo dịch vụ [tại đây](https://docs.vngcloud.vn/vng-cloud-document/vn/ai-stack/model-as-a-service) hoặc trải nghiệm ngay dịch vụ [tại đây](https://aiplatform.console.greennode.ai/models). **vWAF (Web Application Firewall)** diff --git a/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/release_notes.md b/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/release_notes.md index 132e93a93..d08bf9fec 100644 --- a/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/release_notes.md +++ b/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/release_notes.md @@ -120,7 +120,7 @@ Hệ sinh thái các dịch vụ chính của AI stack bao gồm: * vDB **OpenSearch:** Vector Database dưới dạng dịch vụ, giúp Hỗ trợ PostgreSQL(**pgvector)** và **OpenSearch** làm vector database.Hỗ trợ triển khai mô hình **RAG (Retrieval-Augmented Generation)** nhanh chóng.Giúp mô hình GenAI hiểu và khai thác dữ liệu doanh nghiệp theo ngữ cảnh. Tài liệu tham khảo [tại đây](../../vdb/opensearch-cluster-database-ods/) * **AI Platform:** Cung cấp môi trường để **thử nghiệm (notebook )**, **fine-tune** và **inference** các mô hình AI ngay trên nền tảng GPU của GreenNode. Tài liệu tham khảo [tại đây](../../ai-stack/ai-platform/) * **AI Gateway:** là Cổng truy cập quản trị tập trung duy nhất cho nhiều mô hình AI, hỗ trợ routing thông minh và caching để tối ưu hiệu năng và chi phí. Giúp theo dõi truy cập, sinh audit logs, giám sát hành vi sử dụng qua metrics và alerts. Tài liệu tham khảo [tại đây](../../ai-stack/ai-gateway/) -* **Model-as-a-Service:** Hỗ trợ truy cập hơn đa dạng **mô hình GenAI** hàng đầu như GPT, Claude, Gemini, DeepSeek... chỉ với 1 API thống nhất. Tài liệu tham khảo [tại đây](../../ai-stack/ai-platform/model-as-a-service/) +* **Model-as-a-Service:** Hỗ trợ truy cập hơn đa dạng **mô hình GenAI** hàng đầu như GPT, Claude, Gemini, DeepSeek... chỉ với 1 API thống nhất. Tài liệu tham khảo [tại đây](../../ai-stack/model-as-a-service/)