Chuyển tới nội dung chính

Getting Started

Hướng dẫn này sẽ dẫn bạn qua quy trình hoàn chỉnh từ đầu đến cuối - từ việc thiết lập kết nối backend đến việc xuất bản một Agent trực tiếp mà người dùng có thể tương tác trong AI Workspace.

Tổng quan​

Việc xây dựng và triển khai một Agent trong Agent Studio theo trình tự sau:

Backend Server → MCP Profile → MCP Instance → Skill Registry → Agent Profile → Publish → AI Workspace

NPO Studio hỗ trợ hai loại Agent:

  • Single Agent: Một Single Agent bao gồm một trigger, Memory và Cache, một LLM, các công cụ (thông qua các máy chủ MCP), và các Skills.

  • Deep Agent: Một Main Agent kết nối với một hoặc nhiều Sub-agent, mỗi Agent có các thành phần riêng của nó.

Bước 1: Kết nối Backend của bạn (Cài đặt máy chủ MCP)​

Các máy chủ MCP cung cấp các API backend như là các công cụ mà các Agent có thể gọi. Chọn cách phù hợp với trường hợp sử dụng của bạn.

Cách A - MCP nội bộ (API backend của riêng bạn)​

  1. Đi đến MCP Server > Backend Servers và chọn Register Backend.
  2. Đi đến MCP Profiles và chọn Create MCP Profile.
    • Ánh xạ các API backend mà bạn muốn cung cấp như là các công cụ MCP.
    • Chạy Playground để xác minh rằng kết quả mong đợi sẽ được trả về khi gọi API.
    • Chọn Save để hoàn tất hồ sơ.
  3. Chọn Provision trên MCP Profile.
    • Máy chủ đã được cung cấp giờ đây xuất hiện trong MCP Instances.
  4. Đi đến MCP Instances, nhấp (⋮) vào phiên bản của bạn, và chọn Playground để xác thực phiên bản trực tiếp.
  5. Sau khi xác thực, nhấp (⋮) một lần nữa và chọn Publish.
    • Phiên bản MCP hiện có sẵn để được gán cho các Agent.

Cách B - MCP bên ngoài (máy chủ MCP của bên thứ ba)​

  1. Đi đến MCP Registry và chọn Publish External MCP.
    • Cung cấp điểm cuối máy chủ bên ngoài và chi tiết xác thực.
    • MCP bên ngoài đã được đăng ký và có sẵn cho các Agent sử dụng.

Bước 2: Tạo Skills​

Skills là các tệp logic có thể tái sử dụng (mã, lời nhắc hoặc cuộc gọi API) mở rộng những gì một Agent có thể làm.

  1. Đi đến Skill Registry và chọn New Skill.
  2. Định nghĩa loại Skills, sơ đồ đầu vào/đầu ra và triển khai.
  3. Chọn Save. Skills hiện có sẵn để gán cho các Agent.

Tip: Duyệt qua Đăng ký Skills để tái sử dụng các Skills được chia sẻ bởi người dùng khác hoặc được công bố công khai - bạn không cần phải xây dựng mọi thứ từ đầu.

Bước 3: Tạo Agent​

Với các máy chủ MCP và Skills của bạn đã sẵn sàng, bạn có thể xây dựng Agent.

  1. Đi đến AI Agent Studio > Agent Profiles và chọn Create Agent.
  2. Chọn loại Agent của bạn:
    • Create Single Agent - cho một Single Agent, một mục đích.
    • Create Deep Agent - cho một quy trình làm việc nhiều Agent với một Main Agent và các Sub-agent.
  3. Trên canvas thiết kế, cấu hình các điều sau: | Thành phần | Cần làm gì | | --- | --- | | Trigger | Chọn cách Agent được gọi (ví dụ: tin nhắn trò chuyện, lập lịch, webhook) | | LLM | Chọn mô hình ngôn ngữ cung cấp lý luận cho Agent | | Memory and Cache | Chọn một hồ sơ bộ nhớ/bộ đệm cho ngữ cảnh cuộc trò chuyện | | MCP Servers | Gán các phiên bản MCP mà bạn đã cung cấp trong Bước 1 | | Skills | Gán các Skills bạn đã tạo trong Bước 2 |
  4. Chọn Save để lưu cấu hình Agent.

Để biết các bước cấu hình chi tiết, hãy tham khảo AI Agent Studio > Agent Profiles > Create and Update Single Agent Profile hoặc Create and Update Deep Agent Profile.

Bước 4: Kiểm tra trong Playground​

Trước khi đưa vào hoạt động, hãy xác nhận rằng Agent của bạn hoạt động như mong đợi.

  1. Đi đến AI Agent Studio > Agent Profiles. Trên thẻ hồ sơ Agent, nhấp vào (⋮) và chọn Playground.
  2. Gửi tin nhắn thử nghiệm và xác minh:
    • Các cuộc gọi công cụ MCP trả về kết quả chính xác.
    • Các Skills thực hiện như mong muốn.
    • LLM phản hồi chính xác trong phạm vi của Agent.
  3. Điều chỉnh cấu hình và kiểm tra lại cho đến khi Agent hoạt động đúng.

Bước 5: Cung cấp và Xuất bản​

  1. Chọn Provision trên hồ sơ Agent như một bước triển khai.
  2. Khi việc cung cấp hoàn tất, chọn Publish để đưa Agent vào hoạt động.
    • Agent hiện có sẵn trong AI Workspace để người dùng tương tác.

Bước 6: Sử dụng Agent trong AI Workspace​

Khi đã xuất bản, người dùng có thể truy cập và tương tác với Agent từ AI Workspace.

  1. Mở AI Workspace và đi đến Home.
  2. Trong thanh bên phải, chọn Agent đã xuất bản từ trình chọn Agent.
  3. Tùy chọn thêm Photos & Files, Connectors, hoặc Skills nếu cần trước khi gửi trò chuyện.
  4. Gõ một tin nhắn trong khu vực làm việc và tương tác với Agent.

What's next: Agent của bạn đã hoạt động và sẵn sàng để sử dụng. Bạn có thể tinh chỉnh nó bất cứ lúc nào - cập nhật Skills, thêm công cụ MCP, hoặc điều chỉnh cấu hình - mà không cần phải xuất bản lại trừ khi có thay đổi cấu trúc yêu cầu. Hãy tham khảo phần AI Workspace để biết chi tiết về việc quản lý cuộc trò chuyện và cài đặt của Agent.