inspiria-agentic-starter 0.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of inspiria-agentic-starter might be problematic. Click here for more details.
- inspiria_agentic_starter-0.1.0/PKG-INFO +137 -0
- inspiria_agentic_starter-0.1.0/README.md +130 -0
- inspiria_agentic_starter-0.1.0/pyproject.toml +24 -0
- inspiria_agentic_starter-0.1.0/setup.cfg +4 -0
- inspiria_agentic_starter-0.1.0/src/ias/__init__.py +1 -0
- inspiria_agentic_starter-0.1.0/src/ias/__main__.py +3 -0
- inspiria_agentic_starter-0.1.0/src/ias/cli.py +54 -0
- inspiria_agentic_starter-0.1.0/src/ias/templates/starter/.gitignore +9 -0
- inspiria_agentic_starter-0.1.0/src/ias/templates/starter/README.md +103 -0
- inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/README.md +304 -0
- inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/agent_definition.yaml +122 -0
- inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/recommend_products/.env.example +3 -0
- inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/recommend_products/main.py +237 -0
- inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/recommend_products/requirements.txt +1 -0
- inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/recommend_products/test_definition.yaml +34 -0
- inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/search_products/.env.example +3 -0
- inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/search_products/main.py +128 -0
- inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/search_products/requirements.txt +1 -0
- inspiria_agentic_starter-0.1.0/src/ias/templates/starter/agents/concierge-agent/tools/search_products/test_definition.yaml +35 -0
- inspiria_agentic_starter-0.1.0/src/inspiria_agentic_starter.egg-info/PKG-INFO +137 -0
- inspiria_agentic_starter-0.1.0/src/inspiria_agentic_starter.egg-info/SOURCES.txt +23 -0
- inspiria_agentic_starter-0.1.0/src/inspiria_agentic_starter.egg-info/dependency_links.txt +1 -0
- inspiria_agentic_starter-0.1.0/src/inspiria_agentic_starter.egg-info/entry_points.txt +2 -0
- inspiria_agentic_starter-0.1.0/src/inspiria_agentic_starter.egg-info/top_level.txt +1 -0
- inspiria_agentic_starter-0.1.0/tests/test_cli.py +52 -0
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: inspiria-agentic-starter
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: Inspiria Agentic Starter: inicializador de projetos de agentes Weni
|
|
5
|
+
Requires-Python: >=3.10
|
|
6
|
+
Description-Content-Type: text/markdown
|
|
7
|
+
|
|
8
|
+
# IAS — Inspiria Agentic Starter
|
|
9
|
+
|
|
10
|
+
O IAS (Inspiria Agentic Starter) é uma ferramenta de linha de comando em Python que cria a estrutura inicial de projetos de agentes para a Weni Platform. Com `ias init`, você recebe um agente de exemplo, suas ferramentas e a documentação para começar a desenvolver.
|
|
11
|
+
|
|
12
|
+
O exemplo é um concierge de produtos com duas ferramentas: `search_products`, para pesquisar produtos, e `recommend_products`, para recomendar produtos conforme uma necessidade e um orçamento. Ambas usam o catálogo de demonstração da DummyJSON.
|
|
13
|
+
|
|
14
|
+
## Requisitos
|
|
15
|
+
|
|
16
|
+
- Python 3.10 ou superior, com pip.
|
|
17
|
+
- Weni CLI para testar e publicar o agente. Consulte a [documentação de instalação](https://weni-ai.github.io/weni-cli/getting-started/installation/).
|
|
18
|
+
|
|
19
|
+
O IAS gera os arquivos. O Weni CLI e as dependências das ferramentas devem ser instalados separadamente.
|
|
20
|
+
|
|
21
|
+
## Instalação via Python
|
|
22
|
+
|
|
23
|
+
Depois que este pacote estiver publicado no PyPI com o nome `inspiria-agentic-starter`:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
python -m pip install inspiria-agentic-starter
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Enquanto ele não estiver publicado, instale a partir da pasta deste repositório:
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
python -m pip install .
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Para desenvolver o IAS com as alterações locais refletidas sem reinstalar:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
python -m pip install -e .
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Recomenda-se usar um ambiente virtual. Crie com `python -m venv .venv` e ative com `source .venv/bin/activate` no Linux/macOS ou `.venv\Scripts\Activate.ps1` no PowerShell.
|
|
42
|
+
|
|
43
|
+
## Inicializar um projeto
|
|
44
|
+
|
|
45
|
+
Para criar o projeto em uma nova pasta:
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
ias init meu-projeto
|
|
49
|
+
cd meu-projeto
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
Para criar os arquivos na pasta atual:
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
ias init
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
Se o comando `ias` não estiver no PATH, use o Python diretamente:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
python -m ias init meu-projeto
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
A estrutura gerada é:
|
|
65
|
+
|
|
66
|
+
```text
|
|
67
|
+
meu-projeto/
|
|
68
|
+
├── .gitignore
|
|
69
|
+
├── README.md
|
|
70
|
+
└── agents/
|
|
71
|
+
└── concierge-agent/
|
|
72
|
+
├── README.md
|
|
73
|
+
├── agent_definition.yaml
|
|
74
|
+
└── tools/
|
|
75
|
+
├── search_products/
|
|
76
|
+
│ ├── .env.example
|
|
77
|
+
│ ├── main.py
|
|
78
|
+
│ ├── requirements.txt
|
|
79
|
+
│ └── test_definition.yaml
|
|
80
|
+
└── recommend_products/
|
|
81
|
+
├── .env.example
|
|
82
|
+
├── main.py
|
|
83
|
+
├── requirements.txt
|
|
84
|
+
└── test_definition.yaml
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
O comando verifica os conflitos antes de criar os arquivos e recusa sobrescrever arquivos existentes, incluindo `README.md` e `.gitignore`. Se houver conflito, escolha outra pasta. Ele não inicializa um repositório Git automaticamente.
|
|
88
|
+
|
|
89
|
+
## Configurar e executar o agente
|
|
90
|
+
|
|
91
|
+
1. Leia `agents/concierge-agent/README.md` para conhecer as ferramentas e suas configurações.
|
|
92
|
+
2. Copie o `.env.example` de cada ferramenta para um arquivo `.env` na mesma pasta e preencha as credenciais e a URL da API conforme essa documentação.
|
|
93
|
+
3. Instale as dependências das ferramentas no ambiente de desenvolvimento, conforme seus arquivos `requirements.txt`.
|
|
94
|
+
4. Com o Weni CLI instalado e configurado, execute os cenários de exemplo a partir da pasta do agente:
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
cd agents/concierge-agent
|
|
98
|
+
weni run agent_definition.yaml concierge_agent search_products -v
|
|
99
|
+
weni run agent_definition.yaml concierge_agent recommend_products -v
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
O `.gitignore` gerado ignora os arquivos de credenciais locais. Não inclua segredos reais nos arquivos versionados. O agente é um exemplo para aprendizado; revise sua documentação e limitações antes de adaptá-lo para produção.
|
|
103
|
+
|
|
104
|
+
## Ajuda
|
|
105
|
+
|
|
106
|
+
```bash
|
|
107
|
+
ias --help
|
|
108
|
+
ias init --help
|
|
109
|
+
ias --version
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
## Manutenção dos templates
|
|
113
|
+
|
|
114
|
+
Os arquivos copiados pelo comando ficam em `src/ias/templates/starter/`. O README dessa pasta é a documentação inicial entregue ao usuário do projeto gerado.
|
|
115
|
+
|
|
116
|
+
A pasta `agents/` preserva o exemplo original. Ao alterar o exemplo, atualize os arquivos correspondentes nos templates. Não inclua `.env`, `.globals`, credenciais reais ou arquivos ZIP nos templates.
|
|
117
|
+
|
|
118
|
+
Para executar os testes após instalar o pacote:
|
|
119
|
+
|
|
120
|
+
```bash
|
|
121
|
+
python -m unittest discover -s tests
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
## Publicação no PyPI
|
|
125
|
+
|
|
126
|
+
O nome da distribuição no PyPI é `inspiria-agentic-starter`; o comando instalado continua sendo `ias`. Verifique a disponibilidade desse nome antes da primeira publicação.
|
|
127
|
+
|
|
128
|
+
Crie uma conta no PyPI, configure a autenticação de dois fatores e gere um token de API. Gere os arquivos em `dist/inspiria/` e envie somente os artefatos dessa distribuição:
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
python -m pip install --upgrade build twine
|
|
132
|
+
python -m build --outdir dist/inspiria
|
|
133
|
+
python -m twine check dist/inspiria/*
|
|
134
|
+
python -m twine upload --username __token__ dist/inspiria/*
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
Informe o token quando solicitado (usuário `__token__`, se solicitado). Não salve o token no repositório. Para experimentar, use uma conta e token separados no TestPyPI e `python -m twine upload --repository testpypi dist/inspiria/*`. Incremente `project.version` para cada nova publicação.
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
# IAS — Inspiria Agentic Starter
|
|
2
|
+
|
|
3
|
+
O IAS (Inspiria Agentic Starter) é uma ferramenta de linha de comando em Python que cria a estrutura inicial de projetos de agentes para a Weni Platform. Com `ias init`, você recebe um agente de exemplo, suas ferramentas e a documentação para começar a desenvolver.
|
|
4
|
+
|
|
5
|
+
O exemplo é um concierge de produtos com duas ferramentas: `search_products`, para pesquisar produtos, e `recommend_products`, para recomendar produtos conforme uma necessidade e um orçamento. Ambas usam o catálogo de demonstração da DummyJSON.
|
|
6
|
+
|
|
7
|
+
## Requisitos
|
|
8
|
+
|
|
9
|
+
- Python 3.10 ou superior, com pip.
|
|
10
|
+
- Weni CLI para testar e publicar o agente. Consulte a [documentação de instalação](https://weni-ai.github.io/weni-cli/getting-started/installation/).
|
|
11
|
+
|
|
12
|
+
O IAS gera os arquivos. O Weni CLI e as dependências das ferramentas devem ser instalados separadamente.
|
|
13
|
+
|
|
14
|
+
## Instalação via Python
|
|
15
|
+
|
|
16
|
+
Depois que este pacote estiver publicado no PyPI com o nome `inspiria-agentic-starter`:
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
python -m pip install inspiria-agentic-starter
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
Enquanto ele não estiver publicado, instale a partir da pasta deste repositório:
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
python -m pip install .
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Para desenvolver o IAS com as alterações locais refletidas sem reinstalar:
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
python -m pip install -e .
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Recomenda-se usar um ambiente virtual. Crie com `python -m venv .venv` e ative com `source .venv/bin/activate` no Linux/macOS ou `.venv\Scripts\Activate.ps1` no PowerShell.
|
|
35
|
+
|
|
36
|
+
## Inicializar um projeto
|
|
37
|
+
|
|
38
|
+
Para criar o projeto em uma nova pasta:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
ias init meu-projeto
|
|
42
|
+
cd meu-projeto
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Para criar os arquivos na pasta atual:
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
ias init
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Se o comando `ias` não estiver no PATH, use o Python diretamente:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
python -m ias init meu-projeto
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
A estrutura gerada é:
|
|
58
|
+
|
|
59
|
+
```text
|
|
60
|
+
meu-projeto/
|
|
61
|
+
├── .gitignore
|
|
62
|
+
├── README.md
|
|
63
|
+
└── agents/
|
|
64
|
+
└── concierge-agent/
|
|
65
|
+
├── README.md
|
|
66
|
+
├── agent_definition.yaml
|
|
67
|
+
└── tools/
|
|
68
|
+
├── search_products/
|
|
69
|
+
│ ├── .env.example
|
|
70
|
+
│ ├── main.py
|
|
71
|
+
│ ├── requirements.txt
|
|
72
|
+
│ └── test_definition.yaml
|
|
73
|
+
└── recommend_products/
|
|
74
|
+
├── .env.example
|
|
75
|
+
├── main.py
|
|
76
|
+
├── requirements.txt
|
|
77
|
+
└── test_definition.yaml
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
O comando verifica os conflitos antes de criar os arquivos e recusa sobrescrever arquivos existentes, incluindo `README.md` e `.gitignore`. Se houver conflito, escolha outra pasta. Ele não inicializa um repositório Git automaticamente.
|
|
81
|
+
|
|
82
|
+
## Configurar e executar o agente
|
|
83
|
+
|
|
84
|
+
1. Leia `agents/concierge-agent/README.md` para conhecer as ferramentas e suas configurações.
|
|
85
|
+
2. Copie o `.env.example` de cada ferramenta para um arquivo `.env` na mesma pasta e preencha as credenciais e a URL da API conforme essa documentação.
|
|
86
|
+
3. Instale as dependências das ferramentas no ambiente de desenvolvimento, conforme seus arquivos `requirements.txt`.
|
|
87
|
+
4. Com o Weni CLI instalado e configurado, execute os cenários de exemplo a partir da pasta do agente:
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
cd agents/concierge-agent
|
|
91
|
+
weni run agent_definition.yaml concierge_agent search_products -v
|
|
92
|
+
weni run agent_definition.yaml concierge_agent recommend_products -v
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
O `.gitignore` gerado ignora os arquivos de credenciais locais. Não inclua segredos reais nos arquivos versionados. O agente é um exemplo para aprendizado; revise sua documentação e limitações antes de adaptá-lo para produção.
|
|
96
|
+
|
|
97
|
+
## Ajuda
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
ias --help
|
|
101
|
+
ias init --help
|
|
102
|
+
ias --version
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
## Manutenção dos templates
|
|
106
|
+
|
|
107
|
+
Os arquivos copiados pelo comando ficam em `src/ias/templates/starter/`. O README dessa pasta é a documentação inicial entregue ao usuário do projeto gerado.
|
|
108
|
+
|
|
109
|
+
A pasta `agents/` preserva o exemplo original. Ao alterar o exemplo, atualize os arquivos correspondentes nos templates. Não inclua `.env`, `.globals`, credenciais reais ou arquivos ZIP nos templates.
|
|
110
|
+
|
|
111
|
+
Para executar os testes após instalar o pacote:
|
|
112
|
+
|
|
113
|
+
```bash
|
|
114
|
+
python -m unittest discover -s tests
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
## Publicação no PyPI
|
|
118
|
+
|
|
119
|
+
O nome da distribuição no PyPI é `inspiria-agentic-starter`; o comando instalado continua sendo `ias`. Verifique a disponibilidade desse nome antes da primeira publicação.
|
|
120
|
+
|
|
121
|
+
Crie uma conta no PyPI, configure a autenticação de dois fatores e gere um token de API. Gere os arquivos em `dist/inspiria/` e envie somente os artefatos dessa distribuição:
|
|
122
|
+
|
|
123
|
+
```bash
|
|
124
|
+
python -m pip install --upgrade build twine
|
|
125
|
+
python -m build --outdir dist/inspiria
|
|
126
|
+
python -m twine check dist/inspiria/*
|
|
127
|
+
python -m twine upload --username __token__ dist/inspiria/*
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
Informe o token quando solicitado (usuário `__token__`, se solicitado). Não salve o token no repositório. Para experimentar, use uma conta e token separados no TestPyPI e `python -m twine upload --repository testpypi dist/inspiria/*`. Incremente `project.version` para cada nova publicação.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=77"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "inspiria-agentic-starter"
|
|
7
|
+
version = "0.1.0"
|
|
8
|
+
description = "Inspiria Agentic Starter: inicializador de projetos de agentes Weni"
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
requires-python = ">=3.10"
|
|
11
|
+
dependencies = []
|
|
12
|
+
|
|
13
|
+
[project.scripts]
|
|
14
|
+
ias = "ias.cli:main"
|
|
15
|
+
|
|
16
|
+
[tool.setuptools]
|
|
17
|
+
include-package-data = false
|
|
18
|
+
|
|
19
|
+
[tool.setuptools.packages.find]
|
|
20
|
+
where = ["src"]
|
|
21
|
+
namespaces = false
|
|
22
|
+
|
|
23
|
+
[tool.setuptools.package-data]
|
|
24
|
+
ias = ["templates/**/*.md", "templates/**/*.yaml", "templates/**/main.py", "templates/**/requirements.txt", "templates/**/.env.example", "templates/**/.gitignore"]
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"""IAS: inicializador de projetos de agentes Weni."""
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
"""Interface de terminal do IAS, sem dependencias externas."""
|
|
2
|
+
|
|
3
|
+
import argparse
|
|
4
|
+
from importlib import resources
|
|
5
|
+
from importlib.metadata import version
|
|
6
|
+
from pathlib import Path
|
|
7
|
+
import sys
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
def _files(directory, relative=Path()):
|
|
11
|
+
for item in directory.iterdir():
|
|
12
|
+
path = relative / item.name
|
|
13
|
+
if item.is_dir():
|
|
14
|
+
yield from _files(item, path)
|
|
15
|
+
else:
|
|
16
|
+
yield path, item
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
def initialize(destination):
|
|
20
|
+
destination = Path(destination).absolute()
|
|
21
|
+
template = resources.files("ias").joinpath("templates", "starter")
|
|
22
|
+
files = list(_files(template))
|
|
23
|
+
# Check every destination before writing anything, including parent files
|
|
24
|
+
# and symlinks, which must never redirect template writes elsewhere.
|
|
25
|
+
for relative, _ in files:
|
|
26
|
+
target = destination / relative
|
|
27
|
+
if target.exists() or target.is_symlink():
|
|
28
|
+
raise FileExistsError(f"Arquivo ja existe: {target}")
|
|
29
|
+
for parent in target.parents:
|
|
30
|
+
if parent.is_symlink() or (parent.exists() and not parent.is_dir()):
|
|
31
|
+
raise FileExistsError(f"Destino invalido: {parent}")
|
|
32
|
+
for relative, source in files:
|
|
33
|
+
target = destination / relative
|
|
34
|
+
target.parent.mkdir(parents=True, exist_ok=True)
|
|
35
|
+
with target.open("xb") as output:
|
|
36
|
+
output.write(source.read_bytes())
|
|
37
|
+
return destination
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
def main(argv=None):
|
|
41
|
+
parser = argparse.ArgumentParser(description="Inicialize um projeto de agentes Weni.")
|
|
42
|
+
parser.add_argument("--version", action="version", version=version("inspiria-agentic-starter"))
|
|
43
|
+
commands = parser.add_subparsers(dest="command", required=True)
|
|
44
|
+
init = commands.add_parser("init", help="Cria o projeto inicial sem sobrescrever arquivos.")
|
|
45
|
+
init.add_argument("directory", nargs="?", default=".", help="Pasta de destino (padrao: pasta atual).")
|
|
46
|
+
args = parser.parse_args(argv)
|
|
47
|
+
try:
|
|
48
|
+
destination = initialize(args.directory)
|
|
49
|
+
except OSError as error:
|
|
50
|
+
print(f"Erro: {error}", file=sys.stderr)
|
|
51
|
+
return 1
|
|
52
|
+
print(f"Projeto criado em {destination}")
|
|
53
|
+
print("Consulte README.md para os primeiros passos e agents/concierge-agent/README.md para configurar o agente.")
|
|
54
|
+
return 0
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# IAS — Inspiria Agentic Starter
|
|
2
|
+
|
|
3
|
+
O IAS (Inspiria Agentic Starter) é uma ferramenta de linha de comando em Python que cria a estrutura inicial de projetos de agentes para a Weni Platform. Com `ias init`, você recebe um agente de exemplo, suas ferramentas e a documentação para começar a desenvolver.
|
|
4
|
+
|
|
5
|
+
O exemplo é um concierge de produtos com duas ferramentas: `search_products`, para pesquisar produtos, e `recommend_products`, para recomendar produtos conforme uma necessidade e um orçamento. Ambas usam o catálogo de demonstração da DummyJSON.
|
|
6
|
+
|
|
7
|
+
## Requisitos
|
|
8
|
+
|
|
9
|
+
- Python 3.10 ou superior, com pip.
|
|
10
|
+
- Weni CLI para testar e publicar o agente. Consulte a [documentação de instalação](https://weni-ai.github.io/weni-cli/getting-started/installation/).
|
|
11
|
+
|
|
12
|
+
O IAS gera os arquivos. O Weni CLI e as dependências das ferramentas devem ser instalados separadamente.
|
|
13
|
+
|
|
14
|
+
## Instalação via Python
|
|
15
|
+
|
|
16
|
+
Depois que este pacote estiver publicado no PyPI com o nome `inspiria-agentic-starter`:
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
python -m pip install inspiria-agentic-starter
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
Enquanto ele não estiver publicado, instale a partir da pasta deste repositório:
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
python -m pip install .
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Para desenvolver o IAS com as alterações locais refletidas sem reinstalar:
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
python -m pip install -e .
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Recomenda-se usar um ambiente virtual. Crie com `python -m venv .venv` e ative com `source .venv/bin/activate` no Linux/macOS ou `.venv\Scripts\Activate.ps1` no PowerShell.
|
|
35
|
+
|
|
36
|
+
## Inicializar um projeto
|
|
37
|
+
|
|
38
|
+
Para criar o projeto em uma nova pasta:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
ias init meu-projeto
|
|
42
|
+
cd meu-projeto
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Para criar os arquivos na pasta atual:
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
ias init
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Se o comando `ias` não estiver no PATH, use o Python diretamente:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
python -m ias init meu-projeto
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
A estrutura gerada é:
|
|
58
|
+
|
|
59
|
+
```text
|
|
60
|
+
meu-projeto/
|
|
61
|
+
├── .gitignore
|
|
62
|
+
├── README.md
|
|
63
|
+
└── agents/
|
|
64
|
+
└── concierge-agent/
|
|
65
|
+
├── README.md
|
|
66
|
+
├── agent_definition.yaml
|
|
67
|
+
└── tools/
|
|
68
|
+
├── search_products/
|
|
69
|
+
│ ├── .env.example
|
|
70
|
+
│ ├── main.py
|
|
71
|
+
│ ├── requirements.txt
|
|
72
|
+
│ └── test_definition.yaml
|
|
73
|
+
└── recommend_products/
|
|
74
|
+
├── .env.example
|
|
75
|
+
├── main.py
|
|
76
|
+
├── requirements.txt
|
|
77
|
+
└── test_definition.yaml
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
O comando verifica os conflitos antes de criar os arquivos e recusa sobrescrever arquivos existentes, incluindo `README.md` e `.gitignore`. Se houver conflito, escolha outra pasta. Ele não inicializa um repositório Git automaticamente.
|
|
81
|
+
|
|
82
|
+
## Configurar e executar o agente
|
|
83
|
+
|
|
84
|
+
1. Leia `agents/concierge-agent/README.md` para conhecer as ferramentas e suas configurações.
|
|
85
|
+
2. Copie o `.env.example` de cada ferramenta para um arquivo `.env` na mesma pasta e preencha as credenciais e a URL da API conforme essa documentação.
|
|
86
|
+
3. Instale as dependências das ferramentas no ambiente de desenvolvimento, conforme seus arquivos `requirements.txt`.
|
|
87
|
+
4. Com o Weni CLI instalado e configurado, execute os cenários de exemplo a partir da pasta do agente:
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
cd agents/concierge-agent
|
|
91
|
+
weni run agent_definition.yaml concierge_agent search_products -v
|
|
92
|
+
weni run agent_definition.yaml concierge_agent recommend_products -v
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
O `.gitignore` gerado ignora os arquivos de credenciais locais. Não inclua segredos reais nos arquivos versionados. O agente é um exemplo para aprendizado; revise sua documentação e limitações antes de adaptá-lo para produção.
|
|
96
|
+
|
|
97
|
+
## Ajuda
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
ias --help
|
|
101
|
+
ias init --help
|
|
102
|
+
ias --version
|
|
103
|
+
```
|