> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/english/skyone-studio/artificial-intelligence/agents.md).
# Agents
"**Agents**" orchestrate the interactions between models, Skills, and automation flows within the Artificial Intelligence layer of **Skyone Studio**. They act as "interpreters" that process commands, execute established configurations, and return the final response to the user.
Each agent:
* Is linked to a model
* Can use one or more **Skills**
* Can operate standalone as an **assistant** or in **cooperation** with other agents.
### Difference between Assistant and Cooperation
To optimize the use of Artificial Intelligence, it is fundamental to understand the distinction between an Assistant Agent and a Cooperation architecture. The choice between the two depends on the complexity of the task and the need for specialization.
#### Assistent Agent
The Assistant Agent is a centralized interaction model. It acts as a generalist assistant that has access to a broad set of tools and knowledge to resolve various demands within a single flow.
* **Single point of contact:** The user interacts with a single agent that processes the request from start to finish.
* **Broad Context:** It is ideal for linear tasks where the volume of information does not compromise the AI's assertiveness.
* **Operation:** It receives the command, consults its knowledge base or configured Skills, and delivers the final response directly.
#### Cooperation Agent
The Cooperation Agent utilizes a Multi-agent architecture, where the management of cooperative interaction between agents takes place.
* **Division of Specialties:** Instead of a single agent processing all topics, the workload is segmented. In a customer service structure, for example, the Cooperation Agent identifies whether the request refers to Logistics or Support, instantly directing the task to the corresponding specialized agent.
* **Decision Making (Routing):** The Cooperation Agent acts as a logical triage. It analyzes the user's intent and delegates execution to the agent with the best technical mastery of that topic.
* **Efficiency and Precision:** Since each agent works within a reduced scope of data, the risk of errors (hallucinations) decreases and response speed increases, as the search for information is targeted rather than global.
### **Create an Agent**
1. Go to the side menu and click on **“Agents.”**
2. Click **“New Agent.”**
3. Choose the agent type: **Assistant** or **Cooperation**.
Select the corresponding tab ([Assistant](#assistant) or [Cooperation](#cooperation)) to access the specific creation instructions for each modality:
{% tabs %}
{% tab title="Assistant" %}
4\. Fill in or select the following fields:
#### Main Settings
* **Agent name:** Name used to identify the agent.
* **System prompt:** Write the prompt for the agent. If you wish to add more prompts, simply click “**Add prompt**”.
{% hint style="success" %}
Using different prompts for the same agent is useful for separating tasks and facilitating maintenance.
{% endhint %}
* **Model:** Select an existing model. It will serve as the agent's interpretation base.
* **Response type:** The agent can respond in three different modes:
* **Text:** The agent will respond via text.
* **Audio:** The agent will respond via audio. When selecting this option, the following voice settings are required:
* **Agente voice:** Select the vocal identity from the platform’s available options that best represents your agent.
* **Speech instructions:** Describe the desired tone of voice (e.g., empathetic, formal, enthusiastic) and other possible locution guidelines.
* **Hybrid:** Capable of switching between text and audio, delivering a mixed experience within the same interaction. When selecting this option, the voice settings mentioned above are required.
{% hint style="info" %}
**Response Type** availability is directly linked to the selected model. **Hybrid** mode is not compatible with all AI models available on the platform.
{% endhint %}
* **Enable chart generation:** By enabling this flag, charts can be created from the agent's data, except for radar (spider) charts.
{% hint style="info" %}
Chart generation availability is directly linked to the selected model and is not compatible with all models.
{% endhint %}
* **Default error message:** Define a message for times when the agent cannot interpret the prompt or find a suitable answer.
* **Context message limit:** defines the maximum number of previous messages from the conversation history that will be retained in memory and sent to the language model (LLM) with each new interaction.
#### Guardrails
Guardrails allow adding ordered validation layers for the agent's inputs and outputs. To configure a Guardrail, fill out the fields below:
* **Name:** guardrail identification.
* **Type:** defines whether the validation will be applied to the input (user question) or output (agent response).
* **Instruction:** the guideline or rule that the model must follow. Example: "Block questions with discriminatory content."
* **Error message:** The text that will be displayed to the user if the validation fails.
* **Base model:** The optional language model (LLM) that will specifically execute this validation.
#### **Rules**
In this area, it is possible to add specific and ordered capabilities to the agent. When clicking **Add rules,** configure the following options:
* **Always apply:** When enabled, forces the application of this skill in all user interactions, bypassing the need for contextual classification.
* **Description:** Detailed explanation of the scenarios or contexts in which this skill should be activated (essential for the agent to know when to use it).
* **Instruction:** The practical command or targeted behavior that the skill must execute when triggered.
#### **Manage your tools**
Add one or more Skills to define the technical capabilities and functions the agent can execute during the automation flow.
#### **Knowledge Base**
Allows you to link documents (such as PDF files) for the agent to use as a reference source. You can select existing files on the platform or upload new documents directly during this step.
#### **Advanced settings**
{% hint style="warning" %}
Advanced setting options may vary depending on the chosen AI model.
{% endhint %}
In this area, you can adjust the technical parameters governing the AI model's response generation. These settings allow you to balance creativity, precision, speed, and operational cost. Where:
* **top\_k:** Limits the model's vocabulary to the *k* most likely words at each stage of generation. For example, if set to 50, the model will only choose the next word from the top 50 options ranked by context.
* **top\_p:** Nucleus Sampling. Filters candidate words based on the cumulative sum of their probabilities. For example: if set to 0.9, the model considers only the subset of words that together account for 90% of the occurrence probability, discarding irrelevant options.
* **Temperature:** Defines the predictability level of the response. Low values (e.g., 0.2) result in more direct and exact responses, ideal for technical analysis. High values (e.g., 0.8) encourage more free and creative responses.
* **token\_limit:** Determines the token generation limit. It defines how many tokens (words or word fragments) the model can generate in the response, helping control costs and preventing excessively long answers.
* **context\_limit:** Defines the conversation memory limit. This determines the maximum volume of tokens (message history and instructions) the model can process simultaneously to maintain coherence and conversation flow.
* **repeat\_penalty:** Adjusts the model's strictness to avoid excessive repetition of identical words, terms, or phrases within the same response.
* **max\_completion\_tokens:** Defines the maximum limit of tokens the model can generate in a single response.
#### **Tool loading**
Defines how tools, the knowledge base, and cooperation agents will be loaded during the execution of the main agent. It is possible to choose from the following strategies:
* **All (Default):** Initializes and loads all resources simultaneously at the time of agent execution.
* **Agentic:** Delegates the decision to an orchestrator agent, which evaluates the context and dynamically decides what needs to be loaded.
* **Relevance:** Loads resources on demand, based on the calculation of proximity and contextual relevance between the request and the tools.
{% hint style="info" %}
The **Tool loading** option will only be visible in the interface after the selection of one or more tools on the platform.
{% endhint %}
#### **Privacy settings**
Configure the agent's privacy by choosing between the following options:
* **Public:** Anyone can view and edit the agent settings.
* **Private:** Only selected users will be able to view details and edit the current agent.
* **Configure users:** When the Private option is selected, this option becomes active. Choose the users who will have access to the agent and then click "**Finish**".
{% hint style="info" %}
Unauthorized users can use the agents, but they cannot view technical details or edit them.
{% endhint %}
{% endtab %}
{% tab title="Cooperation" %}
4\. Fill in or select the following fields:
#### Main Settings
* **Agent name:** Name used to identify the agent.
* **System prompt:** Write the prompt for the agent. If you wish to add more prompts, simply click “**Add prompt**”.
{% hint style="success" %}
Using different prompts for the same agent is useful for separating tasks and facilitating maintenance.
{% endhint %}
* **Model:** Select an existing model. It will serve as the agent's interpretation base.
* **Response type:** The agent can respond in three different modes:
* **Text:** The agent will respond via text.
* **Audio:** The agent will respond via audio. When selecting this option, the following voice settings are required:
* **Agente voice:** Select the vocal identity from the platform’s available options that best represents your agent.
* **Speech instructions:** Describe the desired tone of voice (e.g., empathetic, formal, enthusiastic) and other possible locution guidelines.
* **Hybrid:** Capable of switching between text and audio, delivering a mixed experience within the same interaction. When selecting this option, the voice settings mentioned above are required.
{% hint style="info" %}
**Response Type** availability is directly linked to the selected model. **Hybrid** mode is not compatible with all AI models available on the platform.
{% endhint %}
* **Manage agents for cooperation:** select two or more previously created agents. To do this:
* Click “**Select agents**".
* In the modal, select two or more by clicking their respective checkboxes.
* **Default error message:** Define a message for times when the agent cannot interpret the prompt or find a suitable answer.
* **Context message limit:** defines the maximum number of previous messages from the conversation history that will be retained in memory and sent to the language model (LLM) with each new interaction.
#### **Guardrails**
Allow adding ordered validation layers for the agent's inputs and outputs. To configure a Guardrail, fill out the fields below:
* **Name:** guardrail identification.
* **Type:** defines whether the validation will be applied to the input (user question) or output (agent response).
* **Instruction:** the guideline or rule that the model must follow. Example: "Block questions with discriminatory content."
* **Error message:** The text that will be displayed to the user if the validation fails.
* **Base model:** The optional language model (LLM) that will specifically execute this validation.
#### **Rules**
In this area, it is possible to add specific and ordered capabilities to the agent. When clicking **Add rules**, configure the following options:
* **Always apply:** When enabled, forces the application of this skill in all user interactions, bypassing the need for contextual classification.
* **Description:** Detailed explanation of the scenarios or contexts in which this skill should be activated (essential for the agent to know when to use it).
* **Instruction:** The practical command or targeted behavior that the skill must execute when triggered.
#### **Advanced settings**
{% hint style="warning" %}
Advanced setting options may vary depending on the chosen AI model.
{% endhint %}
In this area, you can adjust the technical parameters governing the AI model's response generation. These settings allow you to balance creativity, precision, speed, and operational cost. Where:
* **top\_k:** Limits the model's vocabulary to the *k* most likely words at each stage of generation. For example, if set to 50, the model will only choose the next word from the top 50 options ranked by context.
* **top\_p:** Nucleus Sampling. Filters candidate words based on the cumulative sum of their probabilities. For example: if set to 0.9, the model considers only the subset of words that together account for 90% of the occurrence probability, discarding irrelevant options.
* **Temperature:** Defines the predictability level of the response. Low values (e.g., 0.2) result in more direct and exact responses, ideal for technical analysis. High values (e.g., 0.8) encourage more free and creative responses.
* **token\_limit:** Determines the token generation limit. It defines how many tokens (words or word fragments) the model can generate in the response, helping control costs and preventing excessively long answers.
* **context\_limit:** Defines the conversation memory limit. This determines the maximum volume of tokens (message history and instructions) the model can process simultaneously to maintain coherence and conversation flow.
* **repeat\_penalty:** Adjusts the model's strictness to avoid excessive repetition of identical words, terms, or phrases within the same response.
* **max\_completion\_tokens:** Defines the maximum limit of tokens the model can generate in a single response.
#### **Privacy settings**
Configure the agent's privacy by choosing between the following options:
* **Public:** Anyone can view and edit the agent settings.
* **Private:** Only selected users will be able to view details and edit the current agent.
* **Configure users:** When the Private option is selected, this option becomes active. Choose the users who will have access to the agent and then click "**Finish**".
{% hint style="info" %}
Unauthorized users can use the agents, but they cannot view technical details or edit them.
{% endhint %}
{% endtab %}
{% endtabs %}
5. To finish, click “**Create agent**".
Done! Your agent has been created. Test your agents in the [Playground](/english/skyone-studio/artificial-intelligence/playground.md).
**Read also:** [**How to edit or delete your agents**](/english/skyone-studio/artificial-intelligence/agents/agent-management.md)**.**
***
#### FAQ - IA Agents
What is an AI agent?
It is an entity configured to perform tasks, answer questions, and interact autonomously by combining language models, rules, and skills.
Can I create my own AI agent in Skyone Studio?
Yes. The platform offers full autonomy to create custom agents aligned with your business strategy.
What is the difference between a native agent and a custom agent?
Native: Comes ready to use with default settings.
Custom: You define the behavior, tone, skills, data, and language model.
Can an agent have more than one skill?
Yes. You can assign multiple skills to an agent and define when and how each one will be triggered.
Can the agent access my internal data?
Yes, provided that the necessary integrations and permissions are configured.
Can I change the agent's language model after it has been created?
Yes. You can change the model, adjust parameters, and update skills without recreating the entire agent.
Does the agent learn on its own?
The agent does not "learn" in the traditional sense. It operates based on rules, data sources, and configured models. Its performance can be improved by refining prompts and skills.
Is it possible to use an AI agent without advanced technical knowledge?
Yes. Skyone Studio was designed to allow users to configure agents intuitively, even without programming experience.
Does the agent work offline?
No. It must be connected to the Skyone Studio environment and, where applicable, to the configured integrations.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.skyone.cloud/english/skyone-studio/artificial-intelligence/agents.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.