AI 에이전트

An AI agent is a smart assistant in Odoo that can understand natural language, perform tasks, and assist users by interacting with Odoo tools. Agents are a core component of the AI structure in Odoo. Each agent has a defined purpose, prompt, and a set of topics and tools that guide its behavior.

에이전트는 주제 와 소스 라는 두 가지 주요 항목으로 구성되어 있습니다.

• Topics are the instructions and roles that inform the agent of what tasks they need to complete. Tools are assigned to topics, and are the actual functions the agent can utilize to perform tasks.

• Sources provide the agent with the information they need to complete their tasks.

중요

While many AI features can be used in Odoo without the AI application, creating and customizing agents requires that the AI application is installed.

Odoo AI 프롬프트

Before working with AI agents, it is important to understand some basics concepts regarding AI prompts.

An AI prompt is a set of written instructions or context given to an AI model that tells it how to respond to a request, or what role to take. Prompts can define:

• AI 모델의 어조, 스타일 및 캐릭터

• 모델이 수행할 수 있는 작업 범위

• 요청 항목에서 예상되는 출력 유형

In Odoo, each AI agent is assigned a System Prompt, which defines the agent’s overall role, purpose, and behavior. It acts as the core mission statement of the agent, and drives all interactions.

Each Topic also includes its own prompt-like component, called Instructions. Instructions are topic-specific guidelines that refine how the agent behaves within a certain context or workflow, and how it interacts within the Odoo framework.

일반 지침 사항:

• 목적 또는 주제에서 다루는 내용

• Rules or constraints for the agent to follow when assigned this topic

• 특정 작업을 완료하기 위한 단계별 절차

• 모든 작업을 완료하는 데 필요한 기술적인 세부 내용

에이전트 구조

주제

Topics are a collection of instructions and tools that define how an agent behaves within a specific context. Essentially, the topics define what an agent can do within the database. Topics guide conversations, telling the agent what it can do, how it can do it, and when it should do it.

중요

If an agent is not assigned any Topics, it is only able to provide information, not complete tasks or make changes to the database.

Within each topic includes a detailed prompt, which provides the agent with more in-depth instructions on how to perform the tasks associated with that topic, define the boundaries of its behavior, and determine how it should interpret user intent. These prompts ensure that the agent follows a consistent reasoning pattern and uses the appropriate tools to generate accurate, context-aware responses.

다음 항목은 AI 앱에 미리 설정이 완료되어 있습니다:

• Natural Language Search: supports the interpretation of a user query to open the appropriate Odoo view with a set of tools necessary to perform the search.

• Information retrieval: a collection of tools to retrieve information about the models.

• Create Leads: a collection of tools to support automated lead creation. This topic is only available if the CRM app is installed.

Within each topic is a set of Instructions, which act as a prompt and provide guidance for the structure of the interaction, and one or more AI Tools, which indicate the functions the agent can perform.

도구

Tools are the functions the agent can perform in Odoo. These include actions like creating a lead or opening a view. Tools extend the purpose of the agent beyond conversations, they enable real actions. The available tools in a database vary based on the applications installed. Multiple AI Tools can be assigned to a single topic.

출처

Sources are the data the agent can refer to when generating responses or completing tasks. Sources are indexed so the agent can retrieve relevant information when a user asks a question.

Example

An agent designed to answer customer support questions has Knowledge articles included as sources, which include frequently asked questions.

소스 형식은 다음과 같습니다:

• PDF

• 웹링크

• 문서 (문서 애플리케이션에 업로드)

• 지식 센터 앱 기사

중요

If the Restrict to Sources option is enabled on an agent, the agent can only utilize information from the uploaded and active sources.

새 에이전트 만들기

To create a new AI agent, navigate to the AI app ‣ New. Enter an Agent Name, then add a short description, if desired.

팁

Before creating a new agent, it is recommended to have a clear use case in mind. This helps when writing out the System Prompt, and assigning the Topics and AI Tools.

드롭다운 메뉴에서 LLM 모델 을 선택합니다.

중요

Odoo에서는 여러가지 버전의 ChatGPT 및 Gemini가 지원되고 있습니다.

Next, select a Response Style. This manages the overall tone the agent uses when responding to an inquiry. Choose from one of the following options:

• Analytical: more mathematical, this option is more likely to give the same answer to the same question. This option is recommended for situations where accuracy is more important than diplomacy.

• Balanced: a mix of both Analytical and Creative. This is an excellent option for situations with outside customers who would benefit from both accuracy and diplomacy.

• Creative: approaches questions in a more human way, changes answers every time to react to the conversation. This option works best for times when the solutions often vary based on the situation.

Tick the Restrict to Sources checkbox to limit the agent to only respond based on the provided resources.

Next, select one or more Topics for the agent. As explained above, Topics include both instructions and tools that guide the agent in helping users complete a task.

Enter a System Prompt with detailed instructions for the agent as to their role and responsibilities.

팁

The specificity and length of the System Prompt can vary, depending on the use case for the agent. Use the preconfigured agents as an example of the possible information.

If Sources are needed for the agent, scroll to the Sources tab, then click Add a source.

양식 선택:

• PDFs: Select the appropriate file from the explorer window, and click Open

• Weblinks: paste the URL. Multiple links can be added at once, paste one link per line. Click Save.

• Documents (uploaded in the Documents application): Tick the checkbox next to one or more documents, then click Select.

• Knowledge app articles: Tick the checkbox next to one or more articles, then click Select.

Once a source is added, the Status field updates to reflect its current status. The source is ready when the status changes from Processing to Indexed. Slide the Active toggle to activate the source.

중요

If a source fails to upload, it could be the result of a conflict with the selected LLM model.

Click the Test button to open a conversation window and test the new agent.