Skip to content

Commit

Permalink
deploy: 0bab642
Browse files Browse the repository at this point in the history
  • Loading branch information
ASL-r committed Jul 11, 2024
1 parent a96a3ec commit c0d3030
Show file tree
Hide file tree
Showing 6 changed files with 15 additions and 22 deletions.
13 changes: 6 additions & 7 deletions _sources/customize/client_configuration.rst.txt
Original file line number Diff line number Diff line change
@@ -1,12 +1,11 @@
Client Configuration
#######################

When integrating a new client into the IoA platform, it is essential to configure the client's settings to ensure seamless communication and functionality within the existing system. This configuration process, known as client configuration, is necessary because each client may have unique requirements, data formats, and interaction protocols that must be aligned with the IoA platform's standards. Proper client configuration allows for the customization of parameters related to server, agent, and communication approach, ensuring that the new client can effectively interact with other components of the platform. Before introduce the configuration of parameters,
it is necessary to create a folder and file for the client configuration.
To successfully integrate your agent (or agents we provide) into your IoA server, you must configure the client settings to ensure proper registration within the IoA ecosystem. This involves setting up server details, defining agent specifications, and adjusting communication settings, as detailed below:

* Create a folder named your_case_name under the :code:`configs/client_configs/cases` directory for your cases. For example: :code:`configs/client_configs/cases/example`

* Create a file named :code:`your_agent_name.yaml` to serve as the configuration file for the agent, depending on the number of agents required, create the corresponding number of YAML files. For example: :code:`configs/client_configs/cases/example/bob.yaml`
* Create a file named :code:`agent_name.yaml` to serve as the configuration file for the agent, depending on the number of agents required, create the corresponding number of YAML files. For example: :code:`configs/client_configs/cases/example/bob.yaml`

The following are configuration examples for parameters. The configuration file is divided into three sections: **server** , **tool_agent**, **comm**.

Expand All @@ -24,7 +23,7 @@ The server section is responsible for setting up the basic server configurations
Tool Agent
===========================
The tool_agent section defines the configuration for the tool agent itself and represents various agents integrated into the IoA platform, such as ReAct, OpenInterpreter, and others. The inclusion of a tool_agent is optional and depends on the specific agents required for the given use case.
The tool agent section defines the configuration for the tool agent itself and represents various agents integrated into the IoA platform, such as ReAct, OpenInterpreter, and others. The inclusion of a tool_agent is optional and depends on the specific agents required for the given use case.

.. code-block:: yaml
Expand All @@ -43,9 +42,9 @@ The tool_agent section defines the configuration for the tool agent itself and r
|
Comm
==========================
The communication service client used for communicating and interacting with other clients and also for assigning tasks to the tool_agent.
Communication Service Client
===================================
The communication service client section used for communicating and interacting with other clients and also for assigning tasks to the tool_agent.

.. code-block:: yaml
Expand Down
2 changes: 0 additions & 2 deletions _sources/customize/integrate_thirdparty_agent.rst.txt
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
Integrate Third-party Agent
################################

|
Here is a brief guide for integrating third-party agents. If you want to integrate an agent from a third-party repository, there are mainly two things to consider:


Expand Down
15 changes: 7 additions & 8 deletions customize/client_configuration.html
Original file line number Diff line number Diff line change
Expand Up @@ -287,11 +287,10 @@
<article role="main" id="furo-main-content">
<section id="client-configuration">
<h1>Client Configuration<a class="headerlink" href="#client-configuration" title="Link to this heading"></a></h1>
<p>When integrating a new client into the IoA platform, it is essential to configure the client’s settings to ensure seamless communication and functionality within the existing system. This configuration process, known as client configuration, is necessary because each client may have unique requirements, data formats, and interaction protocols that must be aligned with the IoA platform’s standards. Proper client configuration allows for the customization of parameters related to server, agent, and communication approach, ensuring that the new client can effectively interact with other components of the platform. Before introduce the configuration of parameters,
it is necessary to create a folder and file for the client configuration.</p>
<p>To successfully integrate your agent (or agents we provide) into your IoA server, you must configure the client settings to ensure proper registration within the IoA ecosystem. This involves setting up server details, defining agent specifications, and adjusting communication settings, as detailed below:</p>
<ul class="simple">
<li><p>Create a folder named your_case_name under the <code class="code docutils literal notranslate"><span class="pre">configs/client_configs/cases</span></code> directory for your cases. For example: <code class="code docutils literal notranslate"><span class="pre">configs/client_configs/cases/example</span></code></p></li>
<li><p>Create a file named <code class="code docutils literal notranslate"><span class="pre">your_agent_name.yaml</span></code> to serve as the configuration file for the agent, depending on the number of agents required, create the corresponding number of YAML files. For example: <code class="code docutils literal notranslate"><span class="pre">configs/client_configs/cases/example/bob.yaml</span></code></p></li>
<li><p>Create a file named <code class="code docutils literal notranslate"><span class="pre">agent_name.yaml</span></code> to serve as the configuration file for the agent, depending on the number of agents required, create the corresponding number of YAML files. For example: <code class="code docutils literal notranslate"><span class="pre">configs/client_configs/cases/example/bob.yaml</span></code></p></li>
</ul>
<p>The following are configuration examples for parameters. The configuration file is divided into three sections: <strong>server</strong> , <strong>tool_agent</strong>, <strong>comm</strong>.</p>
<section id="server">
Expand All @@ -308,7 +307,7 @@ <h2>Server<a class="headerlink" href="#server" title="Link to this heading">¶</
</section>
<section id="tool-agent">
<h2>Tool Agent<a class="headerlink" href="#tool-agent" title="Link to this heading"></a></h2>
<p>The tool_agent section defines the configuration for the tool agent itself and represents various agents integrated into the IoA platform, such as ReAct, OpenInterpreter, and others. The inclusion of a tool_agent is optional and depends on the specific agents required for the given use case.</p>
<p>The tool agent section defines the configuration for the tool agent itself and represents various agents integrated into the IoA platform, such as ReAct, OpenInterpreter, and others. The inclusion of a tool_agent is optional and depends on the specific agents required for the given use case.</p>
<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="nt">tool_agent</span><span class="p">:</span>
<span class="w"> </span><span class="nt">agent_type</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ReAct</span>
<span class="w"> </span><span class="nt">agent_name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">tool agent name</span>
Expand All @@ -326,9 +325,9 @@ <h2>Tool Agent<a class="headerlink" href="#tool-agent" title="Link to this headi
<div class="line"><br /></div>
</div>
</section>
<section id="comm">
<h2>Comm<a class="headerlink" href="#comm" title="Link to this heading"></a></h2>
<p>The communication service client used for communicating and interacting with other clients and also for assigning tasks to the tool_agent.</p>
<section id="communication-service-client">
<h2>Communication Service Client<a class="headerlink" href="#communication-service-client" title="Link to this heading"></a></h2>
<p>The communication service client section used for communicating and interacting with other clients and also for assigning tasks to the tool_agent.</p>
<div class="highlight-yaml notranslate"><div class="highlight"><pre><span></span><span class="nt">comm</span><span class="p">:</span>
<span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">The name of the client.</span>
<span class="w"> </span><span class="nt">desc</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">A description of the communication agent&#39;s capabilities.</span>
Expand Down Expand Up @@ -402,7 +401,7 @@ <h2>Comm<a class="headerlink" href="#comm" title="Link to this heading">¶</a></
<li><a class="reference internal" href="#">Client Configuration</a><ul>
<li><a class="reference internal" href="#server">Server</a></li>
<li><a class="reference internal" href="#tool-agent">Tool Agent</a></li>
<li><a class="reference internal" href="#comm">Comm</a></li>
<li><a class="reference internal" href="#communication-service-client">Communication Service Client</a></li>
</ul>
</li>
</ul>
Expand Down
3 changes: 0 additions & 3 deletions customize/integrate_thirdparty_agent.html
Original file line number Diff line number Diff line change
Expand Up @@ -287,9 +287,6 @@
<article role="main" id="furo-main-content">
<section id="integrate-third-party-agent">
<h1>Integrate Third-party Agent<a class="headerlink" href="#integrate-third-party-agent" title="Link to this heading"></a></h1>
<div class="line-block">
<div class="line"><br /></div>
</div>
<p>Here is a brief guide for integrating third-party agents. If you want to integrate an agent from a third-party repository, there are mainly two things to consider:</p>
<ul class="simple">
<li><p><strong>Build and Expose a Docker Container</strong>:</p>
Expand Down
2 changes: 1 addition & 1 deletion index.html
Original file line number Diff line number Diff line change
Expand Up @@ -369,7 +369,7 @@ <h1><img src="./_static/logo.png" style="height:1em; vertical-align:middle;"> We
<li class="toctree-l1"><a class="reference internal" href="customize/client_configuration.html">Client Configuration</a><ul>
<li class="toctree-l2"><a class="reference internal" href="customize/client_configuration.html#server">Server</a></li>
<li class="toctree-l2"><a class="reference internal" href="customize/client_configuration.html#tool-agent">Tool Agent</a></li>
<li class="toctree-l2"><a class="reference internal" href="customize/client_configuration.html#comm">Comm</a></li>
<li class="toctree-l2"><a class="reference internal" href="customize/client_configuration.html#communication-service-client">Communication Service Client</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="customize/tool_creation.html">Tool Creation</a><ul>
Expand Down
2 changes: 1 addition & 1 deletion searchindex.js

Large diffs are not rendered by default.

0 comments on commit c0d3030

Please sign in to comment.